Хадсон П. DocBook [Текст] : Пишем документацию / Пол Хадсон // Linux Format. — 2007. — № 1 (87-88), янв.. — С. 64-67. — (Учебник Hardcore Linux). — Прил.: "Скорая помощь. Вы можете использовать xmllint с параметром -o, чтобы сохранить вывод в файле XML. Это особенно полезно, когда используется параметр —xpointer, так что xmllint выполняет директивы XInclude, а затем сохраняет скомбинированный файл" ; "DocBook в роли нормативного формата" : [DocBook не предлагается для конечного пользователя; также это означает, что его можно конвертировать как в HTML, так и в PDF]. — С. 65 ; "Скорая помощь. Если вы хотите сравнить два XML-документа, используйте xmldiff, а не обычную утилиту diff. xmldiff запрограммирована так, чтобы находить разницу в структуре, а не просто разницу текстов" ; "XML-редакторы : [XML можно набирать, используя любой текстовый редактор; текстовые редакторы Kate, Conglomerate, Oxygen XML — краткие характеристики]". — С. 66 ; "Скорая помощь. Вы можете заставить tidy автоматически преобразовывать HTML в XHTML, если хотите, но для этого ей может понадобиться CSS" ; "Печатаем код" : [Если код или экранный вывод включает символы, которые поставят XML в тупик (а именно <, > или “), то лучше обрамлять их тегом CDATA – это XML-тег для необрабатываемых символьных данных]. — С. 67.
Аннотация
DocBook, созданный организацией Oasis, как формат написания документации и разновидность XML, разработанная специально для создания документации, используется во многих крупных проектах, включая ядро Linux, FreeBSD и KDE, поэтому рано или поздно Вы с ним столкнетесь.
Мы освоим работу в DocBook 4.4, попробовав создать документацию к условной игре…