xmlto - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

xmlto - застосувати таблицю стилів XSL до XML-документа

СИНТАКСИС

xmlto [-o вихідний_директор] [-x custom_xsl] [-m xsl_фрагмент] [-v] [-p postprocessor_opts]
[--розширення] [--шлях пошуку шлях] [--пропуск перевірки]
[--stringparam paramname=paramvalue] [--нечистий] [--безавторозміру] [--без розширень]
[--профіль] [--з-фоп] [--with-dblatex] {формат} {файл}

xmlto {[--довідка] | [--версія]}

ОПИС

Мета xmlto полягає в перетворенні XML файл до бажаного формат використовуючи будь-які засоби
необхідно. Це може включати два кроки:

1. Застосування відповідної таблиці стилів XSL за допомогою процесора XSL-T.

2. Подальша обробка іншими інструментами. Цей крок може не знадобитися.

Щоб вирішити, яку таблицю стилів використовувати і що, якщо є, потрібно зробити для подальшої обробки
вихід, xmlto використовує сценарії форматування, які є простими сценаріями оболонки, які xmlto дзвінки
під час перетворення.

Відповідний скрипт формату вибирається на основі типу XML-файлу та бажаного
вихідний формат. xmlto постачається з деякими форматами скриптів для перетворення файлів DocBook XML у формат a
різноманітність форматів. Ви можете вказати власний сценарій форматування, використовуючи абсолютне ім’я файлу
та цінності формат у командному рядку.

По-перше, якщо xmlto не вказано явно, яку таблицю стилів використовувати (з -x
параметр), скрипт формату буде викликаний with $1 встановити на таблицю стилів. Середовище
змінна XSLT_PROCESSOR містить базову назву виконуваного файлу, до якого буде використано
виконати перетворення XSL-T (наприклад, xsltproc). Сценарій формату повинен писати
ім'я таблиці стилів для використання для стандартного виводу та успішного виходу або виходу за допомогою a
ненульовий код повернення, якщо немає відповідної таблиці стилів для використання (наприклад, якщо
відомо, що тільки доступна таблиця стилів не працює з процесором XSL-T, який буде
використовується). Якщо в стандартний вихід нічого не записується, але сценарій успішно завершується, ні
Буде виконано перетворення XSL-T.

По-друге, після того, як процесор XSL-T був запущений за допомогою таблиці стилів, сценарію форматування
буде викликано знову, цього разу з $1 налаштовано на постобробку. Сценарій форматування повинен
виконайте всі необхідні кроки, щоб перевести оброблений XSL-T вихід у потрібний
вихідний формат, включаючи копіювання виводу в потрібний вихідний каталог. Для
Після обробки скрипт форматування запускається у тимчасовому каталозі, що містить лише файл
оброблений вихід (ім'я якого зберігається в XSLT_PROCESSED і чия базова назва є
оригінальний файл XML з будь-яким розширенням імені файлу, заміненим на .proc). INPUT_FILE встановлений в
ім'я вихідного файлу XML, OUTPUT_DIR встановлюється на ім’я каталогу, який
вихід (і тільки вихід) повинен опинитися в, і ШЛЯХ ПОШУКУ встановлюється роздільним двокрапкою
список резервних каталогів, у яких потрібно шукати вхідні дані (наприклад, зображення). Якщо це
крок невдалий, сценарій форматування має завершити роботу з ненульовим кодом повернення.

ВАРІАНТИ

-v
Будьте багатослівними (-вв для дуже багатослівного).

-x таблиця стилів
Скористайтесь таблиця стилів замість того, щоб просити сценарій форматування вибрати один.

-m фрагмент
Використовуйте наданий XSL фрагмент щоб змінити таблицю стилів.

-o каталог
Помістіть вихід у вказаний каталог замість поточного робочого каталогу.

-p postprocessor_opts
Проходити postprocessor_opts на етапи обробки після застосування таблиці стилів (наприклад, lynx
або посилання при переході через HTML до тексту, або xmltex при переході від TeX до
DVI). Якщо -p вказано вдруге, до них будуть передані вказані параметри
другий етап постобробки; наразі це застосовно лише під час проходження
xmltex і dvips на PostScript.

--розширення
Увімкніть розширення таблиці стилів для використовуваного ланцюга інструментів (use.extensions увімкнено).
Увімкнені змінні використовуються в таблицях стилів DocBook XSL Нормана Уолша.

--шлях пошуку шлях
Додайте список каталогів, розділених двокрапкою шлях як резервні каталоги для
включаючи введення.

--пропуск перевірки
Пропустіть крок перевірки, який зазвичай виконується.

--stringparam paramname=paramvalue
Передайте іменований параметр paramname зі значенням paramvalue до таблиці стилів з команди
лінія.

--нечистий
Тимчасові файли не видаляються (їх імена відображаються і зберігаються в каталозі tmp). Це
може допомогти в аналізі проблем.

--безавторозміру
За замовчуванням деякі змінні XSL замінюються автовизначенням (page.width та
page.height для використання paperconf (libpaper), папір.тип для локалі (LC_PAPER)
вибір). За допомогою цієї опції, xmlto не використовує це автовизначення, і користувач може це зробити
змінювати параметри за замовчуванням самостійно (або за допомогою модифікації param.xsl за замовчуванням, або за допомогою визначених користувачем
XSL фрагмент).

--без розширень
За замовчуванням xmlto вмикає параметри XSL passivetex.extensions для серверної частини passivetex і
fop.extensions та fop1.розширення для бекенда fop. Це зазвичай дає краще
результати. Якщо ви з якихось причин не хочете використовувати ці параметри, просто вимкніть їх
використовуючи цю опцію.

--профіль
Попередньо обробіть XML-документ за допомогою таблиці стилів профілювання.

--з-фоп
Використовуйте fop для форматування. Це експериментальний варіант, особливо очікує fop
розташування (виявлене в налаштований час), можна змінити вручну xmlto автор сценарію
модифікація FOP_PATH

--with-dblatex
Використовуйте dblatex для форматування. Це експериментальний варіант, який передбачає, зокрема, dblatex
розташування (виявлене в налаштований час), можна змінити вручну xmlto автор сценарію
модифікація DBLATEX_PATH

--допомога
Відобразити коротке повідомлення про використання. Тут будуть описані параметри xmlto та доступні
вихідні формати.

-- версія
Відобразити номер версії xmlto.

НАВКОЛИШНЄ СЕРЕДОВИЩЕ

XSLT_PROCESSOR
Базова назва виконуваного файлу, який буде використовуватися для виконання перетворення XSL-T
(за замовчуванням: xsltproc(1)).

TMPDIR
Каталог, де створювати тимчасові таблиці стилів (за замовчуванням: / Tmp).

ДІАГНОСТИКА

0
Все пройшло добре. Це очікуваний код виходу.

1
xmlto був викликаний з недостатніми аргументами.

2
mktemp(1) не вдалося створити файл/каталог. Переконайтеся / Tmp or TMPDIR є для запису.

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

10+ (Перевірка ненульовий помилка код)
xmlto спробував перевірити документ xml, але перевірку не вдалося. Для кращої діагностики,
надається вихідний результат перевірки та код виходу xmllint. Подумайте про виправлення
документ або використання --пропуск перевірки.

ПРИКЛАДИ

Щоб перетворити документ DocBook XML у PDF, скористайтеся:

xmlto PDF mydoc.xml

Щоб перетворити документ DocBook XML в HTML і зберегти отримані HTML-файли в окремому
використання каталогу:

xmlto -o html-директор HTML mydoc.xml

Щоб перетворити XML-документ DocBook в один файл HTML, скористайтеся:

xmlto html-ночків mydoc.xml

Щоб змінити вихід за допомогою фрагмента XSL, використовуйте:

xmlto -m ulink.xsl PDF mydoc.xml

Щоб вказати, яку таблицю стилів використовувати (замінюючи ту, яку скрипт форматування буде використовувати
вибрати) використовувати:

xmlto -x mystylesheet.xsl PDF mydoc.xml

AUTHORS

Тім Воу <[захищено електронною поштою]>
Оригінальний автор, супроводжувач до 0.0.18

Ондрей Вашик <[захищено електронною поштою]>
Підтримка з 0.0.19

АВТОРСЬКЕ

Використовуйте xmlto онлайн за допомогою служб onworks.net