DocBook уже достиг той степени зрелости, что им можно начать пользоваться, не тратя ни денег на покупку ПО, ни времени на его настройку. По крайней мере, если на первых порах вы согласны ограничиться HTML в качестве формата выходных документов. Причем это относится и к документам на русском языке.
Для работы с DocBook вам понадобятся:
редактор для набивки исходного текста
конверторы для преобразования исходного текста в выходные форматы
Для ввода исходного текста подойдет обычный текстовой редактор. Если он умеет работать с XML — отлично: это обеспечит вам дополнительный сервис, например он будет "на лету" обнаруживать ошибки разметки. Максимум комфорта даст специализированный XML-инструментарий. Например, в меню продукта Altova Authentic слово DocBook присутствует в явном виде. К тому же, Desktop Edition этого продукта является бесплатным. Проблема только в том, что вам врядли удастся найти русифицированный XML-редактор. И поэтому для пользователей, не владеющих английским, обычный текстовой редактор, но с русским интерфейсом, скорее всего окажется удобнее.
Сохраните текст в файле с расширением .xml.
Если ваш редактор не проверяет корректность XML-документа,
то самый простой способ проверить —
открыть его при помощи Internet Explorer.
Если все в порядке, IE отобразит ваш документ в виде структурного дерева,
в котором можно сворачивать и разворачивать отдельные ветки,
соответствующие разделам документа.
Конверторы — это, в первую очередь, XSLT-процессор и скрипты. И то, и другое вы получите в составе дистрибутива практически любой более-менее современной версии Linux. Скрипты постоянно развиваются: например, в версии 1.68 исправлены огрехи в предметном указателе на русском языке, поэтому их стоит сразу обновить, загрузив последнюю версию и развернув архив на сервере.
XSLT-процессор для Windows можно скачать, например, по ссылке «Windows binaries» с сайта xmlsoft.org, а XSL-скрипты от платформы не зависят.
На unix преобразование исходного документа в формат HTML выполняется следующей командой:
$ xsltproc/usr/docbook/xsl-stylesheets/html/chunk.xsl
article.xml
где
Готово! В текущем каталоге должны появится HTML-файлы, по одному на раздел статьи и один на общее оглавление.