On 26.01.2007 15:42, Igor Sysoev wrote:
>
>> Что до документации - лично я ратую за её перевод в Docbook-XML. Это же
>> упростит её перевод на английский (может и энтузиасты найдутся). А howto
>> и прочие reciepes вполне можно хранить в wiki.
>
> Хорошо. Давай я выложу тарболл с текущими исходниками в xml
> и кто-нибудь переведёт пару файлов в Docbook-XML на пробу ?
Только желателен ведь ещё и subversion-репозиторий для этого дела :)
Опять же, писать в Docbook - дело довольно ответственное, нужна policy.
Например, унификация наименования id элементов, разбиения на файлы и т.п.
Что до конвертации в html - достаточно xsltproc из портов, а для css
можно использовать стандартный из FreeBSD doc project.
Редакторы. Теоретически достаточно vim, на практике удобнее всего XMLMind.
Нельзя не отметить и такой вариант, как использование формата от Apache
Project:
Он безусловно менее общий чем DocBook, и вообще локальные форматы это
зло, но как маленький плюс - формат заточен под спец-сущности типа
модулей, директив и т.п. В Docbook для этого придется писать свои
шаблоны (так будет проще и правильнее).
--
Sergey Skvortsov
mailto: skv@xxxxxxxxx
