Настройка оформления выходных документов в DocBook/XML

Михаил Острогорский, 2011

Введение

Настройка оформления выходных документов не на шутку пугает многих технических писателей, использующих DocBook. Вместе с тем, освоить решение этой задачи необходимо, поскольку обычно фирму (работодателя или заказчика) не устраивает типовой макет, реализованный в комплекте XSLT-стилей DocBook XSL. Как правило, фирма требует, чтобы внешний вид технической документации отвечал ее официальному стилю, который заключается в определенной верстке титульного листа, колонтитулов, врезок и других элементов. Еще одна распространенная потребность - соблюдение заданного внешнего стандарта оформления, например ГОСТ 2.105-95.

О настройке оформления документов в DocBook можно было бы написать большую книгу, в чем, к счастью, нет необходимости, потому что такая книга уже существует. Ее автор Боб Стейтон, а называется она 'DocBook XSL: The Complete Guide' [1]. Частично эта книга повторяет документацию, которая входит в поставку DocBook XSL, но в ней больше примеров и разъяснений. Значительный объем книги делает ее отличным справочником, но приводит к тому, что читатель перестает видеть лес за деревьями. Описание каждого отдельного параметра понятно, но непонятно, как все это работает в целом и что делать, чтобы добиться нужного эффекта. Кроме того, некоторые элементы оформления невозможно или неудобно настраивать с помощью параметров, управление ими требует вмешательства (грамотного) в структуру DocBook XSL. Впрочем, об этом у Боба Стейтона тоже есть глава, так что можно было бы ограничиться ссылкой на всем известный, в общем-то, источник и закончить разговор, однако постоянные вопросы, как сделать то или иное изменение типового макета, наводят на мысль о потребности в каком-нибудь бодрящем документе на эту тему.

Предлагаемая статья написана в качестве краткого путеводителя для начинающих, чтобы избавить технических писателей от ужаса перед настройкой оформления выходных документов в DocBook и показать, что на самом деле там все просто. После нее читателю будет легче взяться за Боба Стейтона и оригинальную документацию, по крайней мере, автор испытывает такую надежду.

Брошюра в формате PDF

Содержание

Введение	
Необходимая начальная подготовка	
   Знания, умения и средства труда	
   Язык разметки XSL-FO	
   Язык преобразований XSLT	
Технология	
   Создание XSLT-стиля	
   Способы настройки оформления	
   Указание параметров макета	
   Подмена шаблонов	
Примеры	
  Конфигурация для работы примерами	
  Простейшие параметры оформления	
  Оформление выделенного текста	
  Фирменный титульный лист	
Литература