![[personal profile]](https://www.dreamwidth.org/img/silk/identity/user.png){kind=small}
Написание документации.
Хочу осознать Docbook для писания документаци, но что-то постоянно спотыкаюсь на немелком размере документации на него самого, причем как-то странно организованной - не понимаю с какой стороны начать изучение.
Для написания xml куча тулсов, в том числе и прямо поддерживающих docbook типа XMLSpy, но и то в них какой-то бред - то нужно FOP доставить для генерации PDF, то русского не понимает для PDF, то xml-entities типа   xsl-конвертор заменяет на &#160. И при этом стиль для конвертации надо руками указывать - т.е. уже знать, что docbook это набор стилей. Ни разу не самоочевидно.
Есть набор консольных утилит для компиляции docbook во что попало - но и они примерно так же нещадно бредят, страшно зависят от пути куда их поставили.
Половина утилит требует Java неясных версий.
И главное - все это не собрано в единообразном виде на одной странице - стили на sourceforge, утилиты для обработки xml по инету разбросаны, книжка про docbook отдельно лежит, еще и в нескольких версиях - сразу и не поймешь, к какой версии что относится. Коммерческие утилиты с собой тащат свою версию стилей.
Как это называется? Высокий порог вхождения, крутая кривая обучения?
Для написания xml куча тулсов, в том числе и прямо поддерживающих docbook типа XMLSpy, но и то в них какой-то бред - то нужно FOP доставить для генерации PDF, то русского не понимает для PDF, то xml-entities типа   xsl-конвертор заменяет на &#160. И при этом стиль для конвертации надо руками указывать - т.е. уже знать, что docbook это набор стилей. Ни разу не самоочевидно.
Есть набор консольных утилит для компиляции docbook во что попало - но и они примерно так же нещадно бредят, страшно зависят от пути куда их поставили.
Половина утилит требует Java неясных версий.
И главное - все это не собрано в единообразном виде на одной странице - стили на sourceforge, утилиты для обработки xml по инету разбросаны, книжка про docbook отдельно лежит, еще и в нескольких версиях - сразу и не поймешь, к какой версии что относится. Коммерческие утилиты с собой тащат свою версию стилей.
Как это называется? Высокий порог вхождения, крутая кривая обучения?
no subject
Сложно разобраться, но потом поток написания документации на её функционале работает отлично.
no subject
дока
ее исходник в docbook
Ржачь в том, что в исходнике оно читабельнее. А после того как я его конвертировал в один html файл стало еще читабельнее. Зачем же психи раскладывают по отдельным файлам?
no subject
no subject
www.bulldoc.ru
BullDoc — это система для создания документации. Представляет собой комплекс на php, который можно использовать без веб-сервера через командную строку, или в виде сайта под управлением apache. Исходники документации хранятся в текстовых файлах и могут быть помещены в svn. Документация экспортируется в полностью статический html(один файл на одну страницу или один монолитный файл), для размещения на сайте и для скачивания. Имеется экспорт в файл справки chm.