Поэкспериментируйте с параметрами, приведенными в справочнике [Dict] . Разберитесь с разбиением выходного документа на файлы, автонумерацией разделов, автоматическими оглавлениями. Значения параметров задавайте в XSL-драйвере.
Документация на DocBook XSL и, в частности, на параметры, содержится в дистрибутиве, который вы скачали. Она доступна также на сайте docbook.sourceforge.net.
Привяжите к HTML-файлу стиль CSS при помощи параметра html.stylesheet.
В качестве образца можете использовать
CSS-файл этой статьи.
Значения параметров можно задавать двумя способами:
<xsl:param name="chunker.output.encoding" select="'windows-1251'"/> <xsl:param name="chunker.output.encoding">windows-1251</xsl:param>
Обратите внимание, что в варианте с select
необходимо различать текстовые и числовые параметры:
для текстовых надо задавать одни кавычки внутри других, а для числовых нет.
Во втором варианте значения и тех, и других задаются одинаково,
поэтому он менее подвержен случайным ошибкам.
DocBook позволяет из одного исходного документа создавать выходные документы не только в разных выходных форматах (о чем пойдет речь далее), но и с разным содержимым.
Например, вы можете из одного исходного текста выпускать техническую документацию для разных модификаций вашей продукции, а в случае документации на программное обеспечение — инструкции для эксплуатации на разных системно-аппаратных платформах.
Чтобы воспользоваться этой возможностью, вы должны пометить фрагменты текста,
которые должны включаться условно, с помощью атрибутов, например:
os — операционная система,
userlevel — уровень квалификации пользователя
(см. [Dict]).
После этого вы запускаете XSL-процессор,
задавая скрипт profile-chunk.xsl
вместо chunk.xsl
и выбирая желаемый вариант генерации при помощи параметров.