xmlto - Online în cloud

PROGRAM:

NUME

xmlto - aplicați o foaie de stil XSL unui document XML

REZUMAT

xmlto [-o output_dir] [-x custom_xsl] [-m xsl_fragment] [-v] [-p postprocessor_opts]
[--extensii] [--căutare cale] [--skip-validare]
[--stringparam paramname=paramvaloare] [--nocurat] [--noautosize] [--noextensions]
[--profil] [--cu-fop] [--cu-dblatex] {format} {fişier}

xmlto {[--ajutor] | [--versiune]}

DESCRIERE

Scopul xmlto este de a converti un XML fişier la dorit format folosind orice mijloace
necesar. Acest lucru poate implica doi pași:

1. Aplicarea unei foi de stil XSL adecvate folosind un procesor XSL-T.

2. Prelucrare ulterioară cu alte instrumente. Este posibil ca acest pas să nu fie necesar.

Pentru a decide ce foaie de stil să utilizați și ce, dacă este cazul, trebuie făcut pentru a post-procesa fișierul
ieșire, xmlto folosește scripturi de format, care sunt simple scripturi shell care xmlto Apeluri
în timpul conversiei.

Scriptul de format adecvat este selectat pe baza tipului de fișier XML și a celui dorit
format de iesire. xmlto vine cu unele scripturi de format pentru conversia fișierelor XML DocBook în a
varietate de formate. Puteți specifica propriul script de format folosind un nume de fișier absolut
pentru format pe linia de comandă.

În primul rând, dacă xmlto nu a fost spus în mod explicit ce foaie de stil să folosească (cu -x
opțiunea), scriptul de format va fi apelat cu $1 setată la foaia de stil. Mediul
variabil XSLT_PROCESSOR conține numele de bază al executabilului pentru care va fi folosit
efectuați transformarea XSL-T (de exemplu xsltproc). Scriptul de format ar trebui să scrie
numele foii de stil de utilizat la ieșirea standard și de ieșire cu succes sau ieșiți cu a
cod returnat diferit de zero dacă nu există nicio foaie de stil adecvată de utilizat (de exemplu, dacă
se știe că numai foaia de stil disponibilă nu funcționează cu procesorul XSL-T care va fi
folosit). Dacă nu este scris nimic în ieșirea standard, dar scriptul se iese cu succes, nu
Se va efectua transformarea XSL-T.

În al doilea rând, după ce un procesor XSL-T a fost rulat folosind foaia de stil, scriptul de format
va fi apelat din nou, de data aceasta cu $1 setată la post-procesare. Scriptul de format ar trebui
efectuați pașii necesari pentru a traduce rezultatul procesat XSL-T în rezultatul dorit
formatul de ieșire, inclusiv copierea rezultatului în directorul de ieșire dorit. Pentru
post-procesare, scriptul de format este rulat într-un director temporar care conține doar fișierul
ieșire procesată (al cărei nume este stocat în XSLT_PROCESSED și al cărui nume de bază este cel al
fișier XML original cu orice extensie de nume de fișier înlocuită cu .proc). FIȘIER DE INTRARE este setat la
numele fișierului XML original, OUTPUT_DIR este setat la numele directorului pe care
ieșirea (și numai ieșirea) trebuie să ajungă în și CALEA DE CĂUTARE este setat la un punct separat
listă de directoare de rezervă în care să căutați intrare (pentru imagini, de exemplu). Dacă aceasta
pasul nu reușește, scriptul de format ar trebui să iasă cu un cod de returnare diferit de zero.

OPŢIUNI

-v
Fii verbis (-vv pentru foarte verbose).

-x stylesheet
Utilizare stylesheet în loc să ceară scriptului de format să aleagă unul.

-m fragment
Utilizați XSL-ul furnizat fragment pentru a modifica foaia de stil.

-o director
Puneți ieșirea în specificat director în locul directorului de lucru curent.

-p postprocessor_opts
Trece postprocessor_opts la etapele de procesare după aplicarea foii de stil (de exemplu lynx
sau link-uri când treceți prin HTML la text, sau xmltex când treceți de la TeX la
DVI). Dacă -p este specificat a doua oară, opțiunile specificate vor fi transmise
postprocesare a doua etapă; în prezent, acest lucru este aplicabil numai atunci când treceți prin
xmltex și dvips la PostScript.

--extensii
Activați extensiile foilor de stil pentru lanțul de instrumente în uz (folosi.extensii este pornit).
Variabilele activate sunt cele utilizate de foile de stil DocBook XSL ale lui Norman Walsh.

--căutare cale
Adăugați lista de directoare separate prin două puncte în cale ca directoare alternative pentru
inclusiv intrarea.

--skip-validare
Omiteți pasul de validare care este efectuat în mod normal.

--stringparam paramname=paramvaloare
Transmite un parametru numit paramname cu valoare paramvaloare la foaia de stil din comandă
linia.

--nocurat
Fișierele temporare nu sunt șterse (numele lor sunt afișate și păstrate în directorul tmp). Aceasta
ar putea ajuta la analiza problemelor.

--noautosize
În mod implicit, unele variabile XSL sunt suprascrise de autodetecție (lăţimea paginii și
pagină.înălțimea pentru utilizarea paperconf (libpaper), tip de hârtie pentru locale (LC_PAPER)
selecţie). Cu această opțiune, xmlto nu folosește această autodetecție și utilizatorul o poate
modifică el însuși valorile implicite (fie prin modificarea param.xsl implicită, fie prin definirea de utilizator
fragment XSL).

--noextensions
În mod implicit, xmlto activează parametrii XSL passivetex.extensii pentru backend passivetex și
fop.extensii și fop1.extensii pentru backend fop. Aceasta produce de obicei mai bine
rezultate. Dacă dintr-un motiv oarecare nu doriți să utilizați acești parametri, dezactivați-i
folosind această opțiune.

--profil
Preprocesează documentul XML cu foaia de stil de profilare.

--cu-fop
Folosiți fop pentru formatare. Este o opțiune experimentală, se așteaptă fop în mod specific
locația (detectată la ora configurată), ar putea fi schimbată manual în xmlto scenariu de
modificare a FOP_PATH

--cu-dblatex
Utilizați dblatex pentru formatare. Este o opțiune experimentală, se așteaptă în mod specific dblatex
locația (detectată la ora configurată), ar putea fi schimbată manual în xmlto scenariu de
modificare a DBLATEX_PATH

--Ajutor
Afișează un mesaj scurt de utilizare. Acesta va descrie opțiunile xmlto și cele disponibile
formate de ieșire.

--versiune
Afișează numărul versiunii xmlto.

MEDIUL

XSLT_PROCESSOR
Numele de bază al executabilului care va fi folosit pentru a efectua transformarea XSL-T
(Mod implicit: xsltproc(1)).

TMPDIR
Director, unde se creează foi de stil temporare (implicit: / tmp).

DIAGNOSTIC

0
Totul a mers bine. Acesta este codul de ieșire așteptat.

1
xmlto a fost chemat cu argumente insuficiente.

2
mktemp(1) nu a reușit să creeze un fișier/director. A te asigura / tmp or TMPDIR este inscriptibil.

3
xmlto nu a reușit să găsească un fișier binar în locația configurată. Asigurați-vă că toate sunt necesare
pachetele sunt instalate și căile în scriptul xmlto sunt setate corect.

10+ (Validare diferit de zero eroare cod)
xmlto am încercat să valideze un document xml, dar validarea a eșuat. Pentru un diagnostic mai bun,
ieșirea de validare și codul de ieșire xmllint sunt furnizate. Luați în considerare fie să vă reparați
document sau folosire --skip-validare.

EXEMPLE

Pentru a converti un document DocBook XML în PDF, utilizați:

xmlto pdf mydoc.xml

Pentru a converti un document XML DocBook în HTML și pentru a stoca fișierele HTML rezultate într-o formă separată
utilizarea directorului:

xmlto -o html-dir html mydoc.xml

Pentru a converti un document XML DocBook într-un singur fișier HTML, utilizați:

xmlto html-nochunks mydoc.xml

Pentru a modifica rezultatul utilizând un fragment XSL, utilizați:

xmlto -m ulink.xsl pdf mydoc.xml

Pentru a specifica ce foaie de stil să utilizați (înlocuind-o pe cea pe care o ar face scriptul de format
alege) folosește:

xmlto -x mystylesheet.xsl pdf mydoc.xml

AUTORI

Tim waugh <[e-mail protejat]>
Autor original, întreținător până la 0.0.18

Ondrej Vašík <[e-mail protejat]>
Mentenant din 0.0.19

DREPTURI DE AUTOR

Utilizați xmlto online folosind serviciile onworks.net