Самая крутая система документации.

Софт под Linux, разные программы, но только связанные с Linux

Модератор: /dev/random

sciko
Сообщения: 1744
Статус: Ъ-участник
ОС: Debian/Ubuntu/etc

Самая крутая система документации.

Сообщение sciko »

Ищется сабж.
Знаю что вопрос малость некорректен, поэтому поясню. Как известно в Линуксе существует несколько вариантов представления документации. Пожалуй самыми известными из них являются: man, texinfo и DocBook. Может есть ещё кто, я не знаю.
Кого из них можно взять за основу, чтобы в остальные можно было конвертировать без существенных потерь и проблем? Есть ли специализированные среды для их правки?
Спасибо сказали:
Аватара пользователя
prokoudine
Сообщения: 688

Re: Самая крутая система документации.

Сообщение prokoudine »

Написанное в DocBook/XMl можно превращать и в man, и в texi. Это же сингл-сорс :)
Спасибо сказали:
Аватара пользователя
Portnov
Модератор
Сообщения: 1786
Статус: Матёрый линуксоид
ОС: Debian testing/unstable

Re: Самая крутая система документации.

Сообщение Portnov »

Докбук, да. Если приспособитесь писать непосредственно в докбуке (если так, поделитесь потом опытом, плиз - имхо докбук решительно не приспособлен к писанию/чтению человеком) - хорошо, иначе - какой-нибудь более удобный формат, который хорошо конвертится в докбук. Я, например, asciidoc использую (варианты - markdown, restructuredtext, итп).
Работа: Ubuntu 9.10
Дом: Debian testing/unstable и на всякий случай winxp в virtualbox.
Для разнообразия: моя домашняя страница -http://iportnov.ru
Спасибо сказали:
Аватара пользователя
prokoudine
Сообщения: 688

Re: Самая крутая система документации.

Сообщение prokoudine »

@Portnov: Ты знаешь, это дело привычки. Я в докбуке могу писать практически вслепую, хотя занимаюсь этим сейчас достаточно редко (а раньше целые книжки в нём набирал). На самом деле годится любая система единого источника, будь то докбук или упомянутые тобой markdown и restructuredtext. Википодобный синтаксис, конечно, проще, но и развитых фильтров экспорта для него меньше.
Спасибо сказали:
sciko
Сообщения: 1744
Статус: Ъ-участник
ОС: Debian/Ubuntu/etc

Re: Самая крутая система документации.

Сообщение sciko »

prokoudine писал(а): ↑
20.01.2010 19:06
Написанное в DocBook/XMl можно превращать и в man, и в texi.
Превращать-то можно. Но как и любой XML -- это жуткий и мутный набор тегов. Непонятно чем это править.
Конечно, можно заюзать LyX, но он слишком сильно ограничен.

Кстати, забыл сказать что между всеми представленными мною в стартовом посте форматами (т.е. man, texinfo и DocBook) можно конвертировать.


Portnov писал(а): ↑
21.01.2010 18:18
Я, например, asciidoc использую (варианты - markdown, restructuredtext, итп).
Это всё-таки не система документации, а просто язык разметки.
Спасибо сказали: