Ищется сабж.
Знаю что вопрос малость некорректен, поэтому поясню. Как известно в Линуксе существует несколько вариантов представления документации. Пожалуй самыми известными из них являются: man, texinfo и DocBook. Может есть ещё кто, я не знаю.
Кого из них можно взять за основу, чтобы в остальные можно было конвертировать без существенных потерь и проблем? Есть ли специализированные среды для их правки?
Самая крутая система документации.
Модератор: /dev/random
-
sciko
- Сообщения: 1744
- Статус: Ъ-участник
- ОС: Debian/Ubuntu/etc
-
prokoudine
- Сообщения: 688
Re: Самая крутая система документации.
Написанное в DocBook/XMl можно превращать и в man, и в texi. Это же сингл-сорс 
-
Portnov
- Модератор
- Сообщения: 1786
- Статус: Матёрый линуксоид
- ОС: Debian testing/unstable
Re: Самая крутая система документации.
Докбук, да. Если приспособитесь писать непосредственно в докбуке (если так, поделитесь потом опытом, плиз - имхо докбук решительно не приспособлен к писанию/чтению человеком) - хорошо, иначе - какой-нибудь более удобный формат, который хорошо конвертится в докбук. Я, например, asciidoc использую (варианты - markdown, restructuredtext, итп).
Работа: Ubuntu 9.10
Дом: Debian testing/unstable и на всякий случай winxp в virtualbox.
Для разнообразия: моя домашняя страница -http://iportnov.ru
Дом: Debian testing/unstable и на всякий случай winxp в virtualbox.
Для разнообразия: моя домашняя страница -http://iportnov.ru
-
prokoudine
- Сообщения: 688
Re: Самая крутая система документации.
@Portnov: Ты знаешь, это дело привычки. Я в докбуке могу писать практически вслепую, хотя занимаюсь этим сейчас достаточно редко (а раньше целые книжки в нём набирал). На самом деле годится любая система единого источника, будь то докбук или упомянутые тобой markdown и restructuredtext. Википодобный синтаксис, конечно, проще, но и развитых фильтров экспорта для него меньше.
-
sciko
- Сообщения: 1744
- Статус: Ъ-участник
- ОС: Debian/Ubuntu/etc
Re: Самая крутая система документации.
Превращать-то можно. Но как и любой XML -- это жуткий и мутный набор тегов. Непонятно чем это править.
Конечно, можно заюзать LyX, но он слишком сильно ограничен.
Кстати, забыл сказать что между всеми представленными мною в стартовом посте форматами (т.е. man, texinfo и DocBook) можно конвертировать.
Это всё-таки не система документации, а просто язык разметки.