Для работы с DocBook от вас потребуется определенная квалификация и компьютерные ресурсы:
Вы должны быть хотя бы минимально знакомы с XML или HTML. Например, в статье не объясняются термины «тэг», «атрибут». В случае затруднений обращайтесь к справочной литературе.
В качестве инструментальной платформы рассматривается Linux. В принципе инструментарий DocBook доступен для различных платформ, включая Windows и Mac, но для пошаговых инструкциях приходится выбирать один вариант (рассмотрение нескольких платформ вывело бы статью за рамки рассмотрения «кратчайшего пути»). Выбор Linux определяется тем, что весь необходимый для работы с DocBook инструментарий штатно с ним поставляется. Знание Linux требуются минимально-достаточное для того, чтобы суметь воспроизвести содержащиеся в тексте статьи команды.
Предполагается, что у вас есть доступ к компьютеру, на котором установлен Linux (назовем его сервером). Мощность сервера и версия Linux существенной роли не играют. У вас должен быть рабочий каталог и доступ к командной строке.
Если вы предпочитаете работать с текстовым или XML-редактором
на персональном компьютере с отличной от Linux операционной системой,
то у вас должна быть возможность копировать файлы на сервер
или, оптимально, сделать рабочий каталог сервера доступным по сети через сетевой диск
(т.е. запустить на сервере samba).
Для того, чтобы просматривать результаты работы,
у вас должна быть возможность копировать с сервера сгенерированные файлы
или, оптимально, сделать рабочий каталог сервера доступным через веб-сервер
(т.е. запустить на сервере apache).
Для инсталляции или обновления инструментария вам кратковременно могут понадобиться полномочия суперюзера или помощь системного администратора, такими полномочиями обладающего.
Вам понадобится доступ к Интернет, чтобы скачивать инструментарий. (Впрочем, он наверное у вас есть, раз вы читаете эту статью.)
Инструментарий для генерации PDF требует наличия виртуальной машины Java. Рекомендуется Sun JRE или JRE версии не ниже 1.3.
Для того, чтобы результаты работы представляли для вас практический интерес, подберите текст, на котором будете упражняться (будем называть его тестовым документом). Это может быть статья, заметка, фрагмент руководства. Хранящиеся в файле Microsoft Word, текстовом или любом другом, из которого вы сможете переносить текст методом «cut-and-paste». Оптимальный размер — от 3 до 10 страниц.