docbook-2-pdf - Интернет в облаке

ПРОГРАММА:

ИМЯ

sgml2x - легко форматирует документы SGML / XML с помощью таблиц стилей DSSSL.

СИНТАКСИС

sgml2x [кредита] [sgmlфайл | XML-файл ]

доккласс-2-целевой формат [кредита] [sgmlфайл | XML-файл ]

Описание

sgml2x позволяет легко форматировать документ SGML или XML с помощью таблиц стилей DSSSL, а также
предоставляет следующие возможности:

· Несколько возможных таблиц стилей для каждого класса документа

· Простая спецификация таблиц стилей с использованием псевдонимов с поддержкой параметра
наследование

· Простая интеграция новых таблиц стилей путем добавления простого нового файла определения в
каталог конфигурации

· Вызывающий может указать список каталогов конфигурации, подобный PATH, по умолчанию
общесистемные, для каждого пользователя и для каждого проекта каталоги конфигурации

· Автоматический выбор используемой таблицы стилей по умолчанию на основе назначенных
приоритеты

· Передавать произвольные параметры в нефрит(1)

Класс документа, используемый для поиска таблиц стилей и формата вывода, на данный момент
только производное от имени, с которым вызывается программа, поэтому вы захотите назвать это
программа через символические ссылки, такие как документ-2-pdf.

sgml2x реализован как оболочка вокруг нефрит(1) (или, предпочтительно, Openjade(1),
хотя мы используем общее название нефрит в этой документации), нефрит(1) и другие
инструментов.

Если надписи jadetex.cfg файл рядом с документом, копируется стандартный, что позволяет
изготовление закладок PDF.

Опции

-c|--каталог каталог
Используйте указанный каталог SGML вместо системного каталога по умолчанию.

-C|--confdirs каталог
Используйте (разделенный пробелами) список каталогов конфигурации. Этот вариант
накопительный, т.е. можно использовать несколько -C варианты и списки будут
соединены.

Элементы списка должны быть упорядочены из наиболее общей конфигурации (например, общесистемной).
к наиболее конкретным (например, в масштабах проекта).

Если с помощью этой опции предоставляется какой-либо каталог, список каталогов по умолчанию будет
игнорируются.

-D|--dssslproc dsssl-процессор
Используйте dsssl-процессор чтобы применить таблицу стилей вместо таблицы по умолчанию. Этот
процессор должен поддерживать нефрит-подобные варианты, такие как -V.

Когда эта опция отсутствует, первая найденная в dssslproc файлы из confdirs - это
взятый. Видеть "Файлы" Больше подробностей.

-h|--Помогите Отобразите справочное сообщение и выйдите.

-j|- нефрит dsssl-процессор
Устаревший синоним слова --dssslproc.

--jadetexfilter Perl-фильтр
Постобработка вывода jadetex с помощью фильтра Perl.

Это может быть полезно для принудительного разрыва страниц в некоторых определенных местах, чтобы преодолеть таблицу стилей.
проблемы, или для принудительной расстановки переносов там, где TeX не имеет достаточного количества шаблонов, или
другое умное преобразование, о котором вы могли бы подумать.

Смотрите пост в примеры / командные строки файл для возможного использования.

-n|- не действовать
Команды печати вместо их выполнения. Полезно узнать о нижнем уровне
инструменты и для отладки командной строки.

-o|--openjade
Эта вариант is устаревший. Openjade теперь используется по умолчанию, если доступно. Использовать
--dssslproc или dssslproc файл конфигурации, чтобы заставить конкретный процессор.

Этот параметр использовался для использования Openjade(1) как процессор DSSSL вместо нефрит(1).

-O|--жадеопты нефритовые варианты
Дополнительные параметры для перехода к нефрит(1). Этот вариант накопительный, вы можете
укажите несколько из них, предоставленные параметры будут объединены.

-q|--тихий
Установите уровень детализации на тихий

-r|--примечания
Вывести содержание примечаний к документу в документе (замечание элементы в
документальная книга 4, комментарий элементы в DocBook 3), что делает полученный результат
только для внутреннего пользования документ, напечатав на обложке жирное предупреждение.

Это особенность, специфичная для классов документов и таблиц стилей, и не все таблицы стилей будут использовать
.

-s|--стиль стиль
Выберите стиль вывода, чтобы переопределить (в конечном итоге, основанное на документе) значение по умолчанию.

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

Обратите внимание, что рекомендуется указывать этот параметр в процедуре сборки, чтобы получить
воспроизводимые результаты независимо от доступных таблиц стилей.

-v|--подробный
Увеличьте многословие. Этот параметр можно указывать несколько раз.

- многословие N
Установите уровень детализации на N. Уровни детализации определяются следующим образом:

тихий Только ошибки печати

по умолчанию Только распечатайте ошибки и предупреждения

подробный Также распечатайте уведомления

прослеживать Также печатайте важные команды по мере их выполнения (как - не действовать делает).

отлаживать Также распечатать отладочные сообщения

-V|--версия
Распечатайте версию программы и выйдите.

Конфигурация

sgml2x использует дерево каталогов конфигурации вместо файла конфигурации, поэтому
легко подключить другие пакеты с низким риском нарушения существующей установки.

Иерархии стилей расположены в каталогах с именами стили в каждой конфигурации
каталог. Старые версии этой программы помещали эти иерархии непосредственно в
каталоги конфигурации.

Каталог конфигурации содержит по одному каталогу для каждого известного класса документов с именем
псевдоним класса документа (например, документация). Эти каталоги docclass содержат один подкласс
каталог для каждого класса выходного формата (в настоящее время только HTML и Распечатать поддерживаются).

В настоящее время проблемы реализации приводят к ограничению использования псевдонимов для классов документов.
и таблицы стилей: они могут содержать только буквенно-цифровые символы и символы подчеркивания. Этот
ограничение может быть снято в будущем выпуске, но этого не произойдет до этого
сценарий переписывается на другом языке.

Каждый из этих каталогов содержит по одному файлу для каждого доступного стиля. Имена этих файлов
могут содержать только буквенно-цифровые символы и используются в качестве псевдонимов для стилей. Этот
файл содержит строки с ключ: ценностное шаблон, со следующими ключами в настоящее время
при поддержке:

Id Публичный идентификатор таблицы стилей

Описание изделия Краткое описание стилей для отображения в справочном сообщении

pdfOverride, psOverride,
rtfOverride, Мифоверрайд"10 Должен быть установлен символ dsssl из таблицы стилей печати.
в #t (или символ=ценностное пара, подходящая в качестве аргумента нефрит's -V вариант),
для использования в данном формате печати.

Допускается только один символ на строку переопределения. Чтобы определить значения для нескольких символов, используйте
несколько строк.

Наследует Псевдоним таблицы стилей, от которой наследуется эта таблица, во избежание ненужных
дублирование определений стиля.

В настоящее время это вызывает наследование только * Переопределить параметры.

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

Например, текущая рекомендуемая политика для таблиц стилей DocBook, полученная из
Норман Уолш таков (и может измениться, если опыт покажет, что этого недостаточно).

10 Базовые таблицы стилей, которые обычно необходимо настраивать.

0 Любая таблица стилей, написанная для сверхспециализированной цели (например,
лист маркетинговой продукции).

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

10-100 Разные общие настройки базовых таблиц стилей.

Когда вы пишете улучшенную версию таблицы стилей с приоритетом n, вы
обычно хотят выбрать более высокий приоритет.

Файлы

/ и т. д. / sgml / sgml2x /

~ / .sgml2x /

./sgml2x/ Каталоги конфигурации по умолчанию, в которых находятся файлы конфигурации.
искал. Документацию для --confdirs Больше подробностей.

Confdir/стиль/
Иерархия, определяющая используемые стили. Видеть «Конфигурация» для большего
Детали.

Confdir/ dssslproc
Файл, содержащий упорядоченный список процессоров dsssl для поиска, разделенных символом
новые строки и / или пробелы. Строки, начинающиеся с # персонажи рассматриваются как
Комментарии. Общие ценности включают Openjade и нефрит.

Указанные здесь процессоры DSSSL должны принимать -V и -D совместимый с нефритом
параметры командной строки.

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

Особая ценность ложный можно использовать для остановки поиска и предотвращения просмотра
более общие каталоги. Если, например, проект должен использовать
openjade-1.4devel команда и никакая другая, она может указывать openjade-1.4devel ложный
В своем dssslproc .

Предостережения

Когда используешь openjade-1.4devel как процессор DSSSL, вы увидите жалобу на
уровень потока-объект, созданный doctype.dsl, и автоматическое определение документа-
типа не получится. В остальном эта ошибка безвредна. Идеи, как с этим бороться, или
подтверждение того, что openjade-1.4devel слишком строгий, буду признателен :)

Ассоциация будущее

Планируемые функции для будущих выпусков включают:

· Интеграция генератора индексов

· Интеграция красивой печатной машины для примеров кода

· Спецификация преобразований, которые нужно связать

· Объявление подмножества docclasses, чтобы разрешить использование с любым docclass стиля -
листы, которые применяются к его расширенным классам документов.

· Работайте во временном месте, чтобы не загрязнять рабочий каталог
временные файлы. Это не так просто, как кажется, потому что это ломает документ.
относится к файлам изображений с использованием относительных путей. Это можно рассматривать как нефритовый жук,
Однако.

Просмотрите полный список TODO и отправьте нам больше идей!

Авторские права

Авторские права © 2001-2003 Альков и Янн Дирсон.

sgml2x под лицензией GNU General Public License, версия 2.

Эта документация находится под лицензией GNU Free Documentation License, версия 1.

Контакты us

sgml2x является частью АльковКнига Проект (ссылка в URL http://www.alcove-
labs.org/en/software/alcovebook/) , Пожалуйста, используйте АльковКнига рассылки списки (ссылка в URL
https://savannah.gnu.org/mail/?group_id=533) чтобы связаться с разработчиками и пользователями.

Список ошибок и пожеланий доступен через a Разработка интерфейс (ссылка в URL
https://savannah.gnu.org/support/?group_id=533) . Пожалуйста, используйте его, чтобы сообщить о проблемах и
идеи.

Читать Также

Openjade(1), нефрит(1), нефрит(1), Collateindex.pl(1).

sgml2x(1)

Используйте docbook-2-pdf в Интернете с помощью сервисов onworks.net