A.3. Получение форматированного вывода
В этом разделе предполагается, что вы установили программное обеспечение, перечисленное в порту textproc/docproj вручную либо при помощи порта. Далее предполагается, что ваше программное обеспечение установлено в каталогах под /usr/local/, а каталог с установленными выполнимыми файлами есть в переменной PATH. Настройте маршруты поиска по необходимости в соответствии с вашей системой.
A.3.1. Использование Jade
Пример A-3. Преобразование DocBook в HTML (один большой файл)
% jade -V nochunks \-c /usr/local/share/sgml/docbook/dsssl/modular/catalog \
-c /usr/local/share/sgml/docbook/catalog \ -c /usr/local/share/sgml/jade/catalog \ -d /usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl \
-t sgml
file.sgml > file.html
- Задает параметр nochunks таблицам стилей, перенаправляя весь вывод в STDOUT (при помощи таблиц стилей от Норма Уолша).
- Задает каталоги, которые будет обрабатывать Jade. Требуются три каталога. Первый является каталогом, содержащим информацию о таблицах стилей DSSSL. Второй содержит информацию о DocBook DTD. Третий содержит данные, специфичные для Jade.
- Задает полный маршрут к таблице стилей DSSSL, которую будет использовать Jade при обработке документа.
- Указывает Jade на выполнение преобразования от одного DTD к другому. В этом случае входная информация будет преобразована из DocBook DTD в HTML DTD.
- Задает файл, который должна обработать система Jade, и перенаправить вывод в указанный файл .html.
Пример A-4. Преобразование DocBook в HTML (несколько маленьких файлов)
% jade \
-c /usr/local/share/sgml/docbook/dsssl/modular/catalog \
-c /usr/local/share/sgml/docbook/catalog \
-c /usr/local/share/sgml/jade/catalog \
-d /usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl \
-t sgml file.sgml
- Задает каталоги, которые нужно обработать Jade. Требуются три каталога. Первый является каталогом, в котором находится информация о таблицах стилей DSSSL. Второй содержит информацию о DocBook DTD. Третий содержит информацию, специфичную для Jade.
- Задает полный путь к таблице стилей DSSSL, которую Jade будет использовать при обработке документа.
- Указывает Jade на выполнение преобразования от одного DTD к другому. В этом случае входная информация будет преобразована из DocBook DTD в HTML DTD.
- Задает файл, который должен обработать Jade. Таблицы стилей определяют, как будут именоваться отдельные файлы HTML, и имя ''корневого'' файла, то есть того, в котором находится начало документа.
Этот пример может сгенерировать и один файл HTML, в зависимости от структуры документа, который вы обрабатываете и правил таблицы стилей для разбиения выходной информации.
Пример A-5. Преобразование DocBook в Postscript
Исходный файл SGML должен быть преобразован в файл TeX.
% jade -Vtex-backend \
- Настройка таблиц стилей на использование различных опций, специфичных для создания выходной информации для TeX.
- Задает каталоги, которые нужно обработать Jade. Требуются три каталога. Первый является каталогом, в котором находится информация о таблицах стилей DSSSL. Второй содержит информацию о DocBook DTD. Третий содержит информацию, специфичную для Jade.
- Задает полный путь к таблице стилей DSSSL, которую Jade будет использовать при обработке документа.
- Указывает Jade на преобразование выходной информации в формат TeX.
Сгенерированный файл .tex теперь должен быть пропущен через tex, с указанием пакета макросов &jadetex.
% tex "&jadetex" file.tex
Вы запускаете команду tex не менее трех раз. При первом запуске документ обрабатывается и определяются области документа, которые ссылаются из других частей документа, используемые при индексации, и так далее.
Не беспокойтесь, если при этом вы увидите предупреждающие сообщения, такие, как LaTeX Warning: Reference `136' on page 5 undefined on input line 728..
При втором запуске документ повторно обрабатывается, но при этом некоторая часть информации уже известна (такая, как длина страницы документа). Это позволяет зафиксировать индексные записи и другие перекрестные ссылки.
При третьем проходе выполняются необходимые оставшиеся исправления.
На этом этапе выходной информацией будет file.dvi.
Наконец, запуск dvips преобразует файл .dvi в Postscript.
% dvips -o file.ps file.dvi
Пример A-6. Преобразование DocBook в PDF
Первая часть этого процесса идентична той, что выполняется при преобразовании DocBook в Postscript, используется та же самая команда jade (Прим. A-5).
Когда будет сгенерирован файл .tex, вы запускаете pdfTeX. Однако при этом нужно использовать пакет макросов &pdfjadetex.
% pdftex "&pdfjadetex" file.tex
И снова выполняйте эту команду три раза.
При этом будет получен файл file.pdf, который больше обрабатывать не нужно.