Предложение создания форума о nginx

[Sergey Skvortsov]

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:

http://httpd.apache.org/docs-project/docsformat.html

Он безусловно менее общий чем DocBook, и вообще локальные форматы это
зло, но как маленький плюс - формат заточен под спец-сущности типа
модулей, директив и т.п. В Docbook для этого придется писать свои
шаблоны (так будет проще и правильнее).

-- 
Sergey Skvortsov
mailto: skv at protey.ru