hedgeov: (Default)
hedgeov ([personal profile] hedgeov) wrote2006-08-09 08:26 pm

Нужен текстовый редактор (софтинка)

Друзья, подскажите какой-нибудь текстовый редактор, который понимает стили и прочие оформления, но хранит всё это в текстовом файле. Надо для писания документации под системой контроля версий. Наверно это что-то из области LaTeX (полный чайник в этой области)? А может быть существует не монстрообразный свободно распространяемый аналог Telelogic DOORs?
Мне надо писать по-русски и под виндами. Посоветуйте пожалуйста, желательно со ссылками.

[identity profile] http://users.livejournal.com/__kirill__/ 2006-08-09 04:52 pm (UTC)(link)
Я знаю только два варианта - LaTeX и HTML (вот тут я чайник, но мне не кажется, что HTML хорошо подойдет). Сам как раз много думал переписать всю документацию к нашему ПО из-под ворда в Тех именно что из-за возможности пользоваться нормальным контролем версий.

Вот какие мне видятся плюсы

а) По Теху есть куча литературы + тебе всегда будет у кого спросить.
б) Как раз требуемое выше хранение в текстовом виде и все проистекающие отсюда радости, в частности, контроль версий.

Минусы Теха традиционны :

1) Не слишком удобная работа с графикой.
2) Результат видишь только после компиляции. Это несколько компенсируется наличием оболочек, как свободных (Tecnic center), так и shareware (WinEdit).


Для тех, кто не хочет становиться TeXниками, я бы порекомендовал следующее

1) Выбрать какую-то одну версию теха, размножить ее несколько раз и _всем_ ставить тех только с нее.

2) Попросить кого-то дать\написать стилевой файл. Я думаю, что на первое время шаблон чьей-нибудь диссертации вполне покатит. Мой коллега как раз сделал такой - там было много полезных фич, в частности, переключение между ч\б и цветным вариантом сменой одного ключа (при условии, что соответствующие варианты картинок лежат где надо).

3) Пользоваться потихоньку.

[identity profile] nestoklon.livejournal.com 2006-08-10 05:57 am (UTC)(link)
Кирилл, прости, что вмешиваюсь, но я недавно с ужасом узнал, что SVN+tortoiseSVN умеет делать diff вордовских документов... Попробуй, может, не придётся никого заставлять делать то, что они не хотят, и при этом получить контроль версий...

[identity profile] hedgeov.livejournal.com 2006-08-10 08:23 am (UTC)(link)
Ну-ка, ну-ка. Это может быть и мне поможет. Интересно как они это делают.

[identity profile] nestoklon.livejournal.com 2006-08-10 09:08 am (UTC)(link)
Они пользуются встроенной в ворд системой контроля версий. Которая там имеет вид документ/корректура. Этот плагин (http://tortoisesvn.net/) скармливает ворду версии в виде старая+корректура=новая.

[identity profile] http://users.livejournal.com/__kirill__/ 2006-08-10 10:18 am (UTC)(link)
За что ж тут извиняться-то? Мне было очень интересно про это прочитать. Я и сам считаю, что _грамотное_ использование ворда дает очень много приятных возможностей, о которых подавляющее число людей не знают. Единственная проблема с вордом - то, что это чужой и очень сложный формат. Отсюда следует куча вопросов

1) Что случится со всеми этими плагинами при выходе новой версии ворда или хотя бы просто при использовании разными людьми разных вордов?

2) Уж очень ворд умный. Мне говорили (но я сам не проверял), что в ворде отображение документа на экране зависит от настроек дефолтного принтера. По шрифты уж и не говорю. Короче, очень трудно организовать так, чтобы все работали в одинаковом окружении.

Потом лично меня ТеХ радует тем, что можно сквозным образом редактировать все формулы. Я как-то руками поменял в вордовом файле страниц на 30 все индексы "перпендикулярно" на "параллельно" (и наоборот). Восхитительное занятие...

[identity profile] nestoklon.livejournal.com 2006-08-10 10:30 am (UTC)(link)
Ммм.. Плагин не к ворду. К эксплореру. Он делает только то, что я сказал -- скармливает версии ворду ПРАВИЛЬНО. Что ворд с ними делает -- это проблемы, простите, ворда и его пользователей.
Я утверждал только то, что к ворду прикручивается НОРМАЛЬНАЯ система контроля версий. Ничего более.

[identity profile] http://users.livejournal.com/__kirill__/ 2006-08-10 10:46 am (UTC)(link)
Он делает только то, что я сказал -- скармливает версии ворду ПРАВИЛЬНО

Это я понял. Вопрос в том, что ворд является довольно существенной частью винды. Вот выйдет Windows Vista, и на новые компы будет разумно ставить ее. А будет ли под ней пахать старый ворд большой вопрос. Придется ждать, пока кто-то перепишет плагин так, чтобы он правильно скармливат новому ворду старые версии - это тоже вопрос.

В любом случае - спасибо за информацию, буду иметь ввиду.

[identity profile] nestoklon.livejournal.com 2006-08-10 11:21 am (UTC)(link)
=). Эта хрень обновляется чаще ворда. К тому же, можно поучаствовать в её разработке ;-) .
А сарказм по поводу ворда я уже выразил ;-)

[identity profile] http://users.livejournal.com/__kirill__/ 2006-08-09 04:58 pm (UTC)(link)
Написал длинный опус о плюсах и минусах Теха, а ЖЖ его не запостил и даже в броузере назад не пускает.

Коротко - я как раз сам много думаю о том, чтобы перетащить всю нашу доку под ТеХ именно по этой причине - контроль версий.

Плюс ТеХа по сравнению с какими-то еще редакторами - есть куча литературы + будет у кого спросить из знакомых.

Минусы - неудобная работа с графикой + то, что результат видишь только после компиляции. Последнее частично компенсируется оболочками. Среди них есть и полностью бесплатные.

[identity profile] http://users.livejournal.com/__kirill__/ 2006-08-09 04:59 pm (UTC)(link)
А вот теперь потерянный коммент появился - странно...

[identity profile] helgaolga.livejournal.com 2006-08-09 05:34 pm (UTC)(link)
HTML, если я правильно поняла задачу
LaTex кажется не подойдет, с ним нужен внешний компилятор (собстна, сам TeX). Поэтому остальные пользователи увидят в текстовом файле нечто малопотребное, а не сам документ.

[identity profile] hedgeov.livejournal.com 2006-08-09 06:08 pm (UTC)(link)
Ничего не запрещает остальным пользователям также использовать Тех. А про хтмл - спасибо. Сам почему-то про него не думал...

[identity profile] blacklion.livejournal.com 2006-08-09 06:10 pm (UTC)(link)
Только тогда использовать строгий XHTML и CSS + смысловая разметка, а не оформительная. Это по началу кажется неудобным, но фантастически облегчает жизнь, если хочется что-то глобально поменять во внешнем виде, сделать отдельную версию для печати, etc.

[identity profile] hedgeov.livejournal.com 2006-08-09 06:11 pm (UTC)(link)
Вот только смущает наличие адекватного WYSIWYG редактора HTML. Word не предлагать. Он ТАКОЕ из HTML делает, что никакой версионный контроль не спасет.

[identity profile] blacklion.livejournal.com 2006-08-09 06:27 pm (UTC)(link)
А нету. Но, IMHO, для документации и не надо.
Представление -- это представление. А в документации важна структура!
Представление может быть одним для бумаги, другим для веба и третьим для PDF'а. А еще четвертым -- для слайдов презентации.
При продуманной структуре это делется из ОДНОГО источника.

[identity profile] hedgeov.livejournal.com 2006-08-09 06:44 pm (UTC)(link)
Я почему про этот редактор речь повел - ручками слишком накладно и не наглядно. Понятно что ...ML обязан отражать структуру, а не boldы-италики. В этом смысле мне нравится TeX наличием хоть каких-то графических редакторов. Пока что я нашел Lyx. На структурированное изложение его вроде хватает...

Хотя может плюнуть на всю эту затею и внимательно подсмотреть у себя как грамотно применяют MS Word? У нас же в DOORs только требования, а всё остальное вполне так в Word'е делается, на основании каких-то шаблонов... При этом история изменений от релиза до релиза ведется в вордовом документе чуть-ли не автоматически, а система контроля версий скорее как центральное хранилище этого добра, ну и промежуточные версии можно посмотреть.

[identity profile] http://users.livejournal.com/__kirill__/ 2006-08-10 10:26 am (UTC)(link)
При продуманной структуре это делется из ОДНОГО источника.

Во!!! У меня в глубине души было такое же мнение. Тогда у меня к тебе будет прикладной вопрос. Хочется делать документацию (pdf) и хелп из одного источника. Не знаешь ли ты каких-то более или менее готовых решений для этого? А то меня от написания хелпа как раз отвращает мысль поддерживать потом два описания.

[identity profile] hedgeov.livejournal.com 2006-08-10 11:13 am (UTC)(link)
Из html точно есть конвертеры в .chm и в .pdf

[identity profile] blacklion.livejournal.com 2006-08-22 08:06 pm (UTC)(link)
Хедп -- это CHM?
Не знаю точных слов, но было. Поищу.

[identity profile] blacklion.livejournal.com 2006-08-09 06:28 pm (UTC)(link)
[в сторону] Как меня зае$ала документация, в которой думали в теринах "bold" и "italic", а не "раздел, функция, параметры, выходные значения, граничные условия"

[identity profile] http://users.livejournal.com/__kirill__/ 2006-08-10 10:21 am (UTC)(link)
Не понял. Сам документ *.html не понятнее *.tex. Естественно, если переходить на Тех, то ставить его всем и коммитить только компилящиеся версии, чтоб любой чайник мог нажать кнопку build и рассматривать pdf.

[identity profile] baidit.livejournal.com 2006-08-09 07:01 pm (UTC)(link)
Меня глючит или для создания артефактов с хорошей структурой придумывали XML?

[identity profile] hedgeov.livejournal.com 2006-08-09 07:54 pm (UTC)(link)
Не вопрос. Тул нужен. Желательно готовый :)

[identity profile] corneff.livejournal.com 2006-10-31 04:44 pm (UTC)(link)
А XML + XSLT => Word 2003 в формате XML не подойдет?