db2x_xsltproc - Онлайн в облаке

ПРОГРАММА:

ИМЯ

db2x_xsltproc - оболочка вызова процессора XSLT

СИНТАКСИС

db2x_xsltproc [кредита] xml-документ

ОПИСАНИЕ

db2x_xsltproc вызывает процессор XSLT 1.0 для docbook2X.

Эта команда применяет таблицу стилей XSLT (обычно задаваемую --таблица стилей вариант) в
XML-документ в файле xml-документ. Результат выводится на стандартный вывод (если
изменено с --выход).

Чтобы прочитать исходный XML-документ из стандартного ввода, укажите - в качестве входного документа.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

--версия
Отобразите версию docbook2X.

ПРЕОБРАЗОВАНИЯ ВЫВОД ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ
--выход файл, -o файл
Записывать вывод в указанный файл (или URI) вместо стандартного вывода.

ИСТОЧНИК ДОКУМЕНТ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ
--xinclude, -I
Обработайте директивы XInclude в исходном документе.

--sgml, -S
Укажите, что входным документом является SGML вместо XML. Вам нужен этот набор
вариант, если xml-документ на самом деле является файлом SGML.

Разбор SGML осуществляется путем преобразования в XML через sgml2xml(1) из СП
пакет (или OSX(1) из пакета OpenSP). Все имена тегов в файле SGML будут
нормализованы к нижнему регистру (т. е. -xниже возможность sgml2xml(1)). Я БЫ
атрибуты доступны для таблицы стилей (т.е. опция -xid). Кроме того, любые
Объекты ISO SDATA, используемые в документе SGML, автоматически преобразуются в свои
Эквиваленты XML Unicode. (Это делается СЕПГ фильтр.)

Кодировка документа SGML, если это не us-ascii, должна быть указана с помощью
стандартные переменные среды SP: SP_CHARSET_FIXED = 1 SP_ENCODING =кодирование.
(Обратите внимание, что XML-файлы указывают свою кодировку с XML-объявлением <?xml
версия = "1.0" кодировка = "кодировка " ?> вверху файла.)

Вышеуказанные параметры преобразования нельзя изменить. Если вы хотите другое преобразование
варианты, вы должны вызвать sgml2xml(1) вручную, а затем передать результаты этого
преобразование в эту программу.

ВОЗВРАЩЕНИЕ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ
- каталоги каталог-файлы, -C каталог-файлы
Укажите дополнительные каталоги XML, которые будут использоваться для разрешения формальных общедоступных идентификаторов или
URI. Каталоги SGML не поддерживаются.

Эти каталоги не используется для анализа документа SGML под --sgml опцию.
Используйте переменную окружения SGML_CATALOG_FILES вместо этого указать каталоги для
разбор документа SGML.

--сеть, -N
db2x_xsltproc обычно отказывается загружать внешние ресурсы из сети, так как
причины безопасности. Если вы действительно хотите загружаться из сети, установите эту опцию.

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

СТИЛЬ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ
--таблица стилей файл, -s файл
Укажите имя файла (или URI) используемой таблицы стилей. Особые ценности человека и
texi принимаются как сокращения, чтобы указать, что xml-документ находится в DocBook и
должны быть преобразованы в страницы руководства или Texinfo (соответственно).

--парам имя=выраж, -p имя=выраж
Добавьте или измените параметр в таблицу стилей. имя - это имя параметра XSLT, а
выраж - это выражение XPath, которое возвращает желаемое значение параметра.
(Это означает, что строки должны быть заключены в кавычки, in дополнение к обычному цитированию оболочки
аргументы; использовать --строка-параметр чтобы избежать этого.)

--строка-параметр имя=string, -g имя=string
Добавьте или измените параметр со строковым значением в таблицу стилей.

Строка должна быть закодирована в UTF-8 (независимо от кодировки символов локали).

ОТЛАДКА И ПРОФИЛИРОВАНИЕ
--отлаживать, -d
Отображение стандартных ошибок журналов того, что происходит во время XSL.
преобразование.

--вложенность-лимит n, -D n
Измените максимальное количество вложенных вызовов к шаблонам XSL, используемым для обнаружения
потенциальные бесконечные петли. Если не указано, ограничение составляет 500 (по умолчанию для libxslt).

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

--xslt-процессор процессор, -X процессор
Выберите используемый процессор XSLT. Возможный выбор для процессор составляют:
libxslt, саксонский, xalan-j.

По умолчанию используется процессор, установленный при сборке docbook2X. libxslt - это
рекомендуется (потому что он компактный и быстрый), но SAXON намного надежнее и будет
быть более полезным при отладке таблиц стилей.

На всех процессорах включена поддержка каталогов XML. (docbook2X требует этого.)
Но учтите, что не все вышеперечисленные параметры работают с другими процессорами, кроме libxslt.
вариант.

ОКРУЖАЮЩАЯ СРЕДА

XML_CATALOG_FILES
Укажите каталоги XML. Если не указано иное, стандартный каталог (/ etc / xml / каталог) является
загружен, если есть.

DB2X_XSLT_ПРОЦЕССОР
Укажите используемый XSLT-процессор. Эффект такой же, как у --xslt-процессор
вариант. Основное использование этой переменной - позволить вам быстро тестировать различные
XSLT-процессоры без добавления --xslt-процессор к каждому скрипту или сделать файл
в вашей системе сборки документации.

СООТВЕТСТВИЕ К

Язык таблиц стилей XML - преобразования (XSLT), версия 1.0 ⟨http://www.w3.org/TR/xslt⟩
, Рекомендация W3C.

ПРИМЕЧАНИЯ

В своих более ранних версиях (<0.8.4) docbook2X требовал для работы расширений XSLT и
db2x_xsltproc был специальным процессором на основе libxslt, в который были встроены эти расширения.
Когда требование о расширениях XSLT было снято, db2x_xsltproc стал Perl-скриптом
что переводит параметры на db2x_xsltproc соответствовать формату, принятому
акции xsltproc(1) который поставляется с libxslt.

Основная причина существования этого скрипта - обратная совместимость с любыми
сценарии или создавать файлы, которые вызывают docbook2X. Однако также стало легко добавить
поддержка вызова других процессоров XSLT с помощью унифицированного интерфейса командной строки. Действительно,
в этом скрипте нет ничего особенного для docbook2X или даже для DocBook, и это может быть
используется для запуска других видов таблиц стилей, если хотите. Конечно, автор предпочитает
используя эту команду, потому что ее формат вызова нормален и прост в использовании. (например, нет
вводя длинные имена классов для процессоров на базе Java!)

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