xmlto - Dalam talian dalam Awan

JADUAL:

NAMA

xmlto - gunakan lembaran gaya XSL pada dokumen XML

SINOPSIS

xmlto [-o output_dir] [-x custom_xsl] [-m xsl_fragment] [-v] [-p postprocessor_opts]
[--sambungan] [--laluan carian jalan] [--langkau-pengesahan]
[--stringparam nama param=nilai param] [--noclean] [--noautosize] [--noextensions]
[--profil] [--dengan-fop] [--dengan-dblatex] {format} {fail}

xmlto {[--bantuan] | [--versi]}

DESCRIPTION

Tujuan xmlto adalah untuk menukar XML fail kepada yang dikehendaki format menggunakan apa sahaja cara
perlu. Ini mungkin melibatkan dua langkah:

1. Penggunaan lembaran gaya XSL yang sesuai menggunakan pemproses XSL-T.

2. Pemprosesan lanjut dengan alatan lain. Langkah ini mungkin tidak perlu.

Untuk memutuskan helaian gaya yang hendak digunakan dan perkara, jika ada, perlu dilakukan untuk pasca memproses
pengeluaran, xmlto menggunakan skrip format, iaitu skrip shell mudah yang xmlto panggilan
semasa penukaran.

Skrip format yang sesuai dipilih berdasarkan jenis fail XML dan yang dikehendaki
format keluaran. xmlto disertakan dengan beberapa skrip format untuk menukar fail XML DocBook kepada a
pelbagai format. Anda boleh menentukan skrip format anda sendiri dengan menggunakan nama fail mutlak
Untuk format pada baris arahan.

Pertama, jika xmlto belum diberitahu secara eksplisit lembaran gaya yang hendak digunakan (dengan -x
pilihan), skrip format akan dipanggil dengan $1 ditetapkan kepada lembaran gaya. Alam sekitar
berubah-ubah XSLT_PROCESSOR mengandungi nama asas boleh laku yang akan digunakan untuk
lakukan transformasi XSL-T (contohnya xsltproc). Skrip format harus ditulis
nama lembaran gaya untuk digunakan untuk keluaran standard dan keluar dengan jayanya, atau keluar dengan a
kod pulangan bukan sifar jika tiada helaian gaya yang sesuai untuk digunakan (contohnya, jika
hanya lembaran gaya yang tersedia diketahui tidak berfungsi dengan pemproses XSL-T yang akan digunakan
digunakan). Jika tiada apa yang ditulis pada output standard tetapi skrip keluar dengan jayanya, tidak
Transformasi XSL-T akan dilakukan.

Kedua, selepas pemproses XSL-T telah dijalankan menggunakan lembaran gaya, skrip format
akan dipanggil semula, kali ini dengan $1 ditetapkan kepada pasca proses. Skrip format sepatutnya
lakukan sebarang langkah yang perlu untuk menterjemah keluaran yang diproses XSL-T ke dalam yang dikehendaki
format output, termasuk menyalin output ke direktori output yang dikehendaki. Untuk
pasca pemprosesan, skrip format dijalankan dalam direktori sementara yang mengandungi hanya fail
output yang diproses (yang namanya disimpan dalam XSLT_PROCESSED dan yang nama asasnya ialah
fail XML asal dengan sebarang sambungan nama fail digantikan dengan .proc). INPUT_FILE ditetapkan untuk
nama fail XML asal, OUTPUT_DIR ditetapkan kepada nama direktori yang
output (dan hanya output) mesti berakhir dalam, dan SEARCHPATH ditetapkan kepada berasingan kolon
senarai direktori sandaran untuk mencari input (untuk imej, contohnya). Jika ini
langkah tidak berjaya skrip format harus keluar dengan kod pulangan bukan sifar.

PILIHAN

-v
Berkata-kata (-vv untuk sangat verbose).

-x stylesheet
Penggunaan stylesheet bukannya meminta skrip format untuk memilih satu.

-m serpihan
Gunakan XSL yang disediakan serpihan untuk mengubah suai lembaran gaya.

-o direktori
Letakkan output dalam yang ditentukan direktori bukannya direktori kerja semasa.

-p postprocessor_opts
Pas postprocessor_opts kepada peringkat pemprosesan selepas penggunaan lembaran gaya (cth. lynx
atau pautan apabila melalui HTML ke teks, atau xmltex apabila melalui TeX ke
DVI). Jika -p ditentukan untuk kali kedua, pilihan yang dinyatakan akan diserahkan kepada
pasca pemprosesan peringkat kedua; pada masa ini ini hanya terpakai apabila melalui
xmltex dan dvips ke PostScript.

--sambungan
Hidupkan sambungan lembaran gaya untuk rantai alat yang sedang digunakan (penggunaan.sambungan dihidupkan).
Pembolehubah yang dihidupkan ialah yang digunakan oleh helaian gaya DocBook XSL Norman Walsh.

--laluan carian jalan
Tambahkan senarai direktori yang dipisahkan bertindih dalam jalan sebagai direktori sandaran untuk
termasuk input.

--langkau-pengesahan
Langkau langkah pengesahan yang biasa dilakukan.

--stringparam nama param=nilai param
Lulus parameter bernama nama param dengan nilai nilai param ke lembaran gaya daripada arahan
line.

--noclean
Fail sementara tidak dipadamkan (nama mereka ditunjukkan dan disimpan dalam direktori tmp). Ia
boleh membantu menganalisis masalah.

--noautosize
Secara lalai, beberapa pembolehubah XSL ditindih oleh pengesanan automatik (muka surat.lebar and
halaman.tinggi untuk kegunaan paperconf (libpaper), kertas.jenis untuk berasaskan tempatan (LC_KERTAS)
pemilihan). Dengan pilihan ini, xmlto tidak menggunakan pengesanan automatik ini dan pengguna boleh
ubah suai lalai sendiri (sama ada melalui pengubahsuaian param.xsl lalai atau oleh pengguna-defined
Serpihan XSL).

--noextensions
Secara lalai, xmlto membolehkan params XSL passivetex.extensions untuk bahagian belakang passivetex dan
fop.sambungan and fop1.sambungan untuk fop backend. Ini biasanya menghasilkan lebih baik
keputusan. Jika anda atas sebab tertentu tidak mahu menggunakan parameter ini, lumpuhkan sahaja parameter tersebut
menggunakan pilihan ini.

--profil
Pra-proses dokumen XML dengan helaian gaya pemprofilan.

--dengan-fop
Gunakan fop untuk memformat. Ia adalah pilihan percubaan, mengharapkan fop secara khusus
lokasi (dikesan pada masa yang dikonfigurasikan), boleh ditukar secara manual xmlto skrip oleh
pengubahsuaian daripada FOP_PATH

--dengan-dblatex
Gunakan dblatex untuk pemformatan. Ia adalah pilihan percubaan, menjangkakan dblatex secara khusus
lokasi (dikesan pada masa yang dikonfigurasikan), boleh ditukar secara manual xmlto skrip oleh
pengubahsuaian daripada DBLATEX_PATH

- membantu
Paparkan mesej penggunaan ringkas. Ia akan menerangkan pilihan xmlto, dan pilihan yang tersedia
format output.

--versi
Paparkan nombor versi xmlto.

PERSEKITARAN

XSLT_PROCESSOR
Nama asas boleh laku yang akan digunakan untuk melakukan transformasi XSL-T
(lalai: xsltproc(1)).

TMPDIR
Direktori, tempat untuk membuat helaian gaya sementara (lalai: / tmp).

DIAGNOSTIK

0
Semuanya berjalan lancar. Ini ialah kod keluar yang dijangkakan.

1
xmlto dipanggil dengan hujah yang tidak mencukupi.

2
mktemp(1) gagal mencipta fail/direktori. Pastikan / tmp or TMPDIR boleh ditulis.

3
xmlto gagal menemui beberapa binari pada lokasi yang dikonfigurasikan. Pastikan semua yang diperlukan
pakej dipasang dan laluan dalam skrip xmlto ditetapkan dengan betul.

10+(Pengesahan bukan sifar kesilapan kod)
xmlto cuba mengesahkan dokumen xml, tetapi pengesahan gagal. Untuk diagnostik yang lebih baik,
output pengesahan dan kod keluar xmllint disediakan. Pertimbangkan sama ada membetulkan anda
dokumen atau menggunakan --langkau-pengesahan.

CONTOH

Untuk menukar dokumen XML DocBook kepada PDF, gunakan:

xmlto pdf mydoc.xml

Untuk menukar dokumen XML DocBook kepada HTML dan menyimpan fail HTML yang terhasil secara berasingan
penggunaan direktori:

xmlto -o html-dir html mydoc.xml

Untuk menukar dokumen XML DocBook kepada satu fail HTML gunakan:

xmlto html-nochunks mydoc.xml

Untuk mengubah suai output menggunakan penggunaan serpihan XSL:

xmlto -m ulin.xsl pdf mydoc.xml

Untuk menentukan helaian gaya yang hendak digunakan (mengatasi helaian gaya yang akan digunakan oleh skrip format
pilih) gunakan:

xmlto -x mystylesheet.xsl pdf mydoc.xml

PENGARANG

Tim waugh <[e-mel dilindungi]>
Pengarang asal, penyelenggara sehingga 0.0.18

Ondrej Vašík <[e-mel dilindungi]>
Penyelenggara sejak 0.0.19

HAKCIPTA

Gunakan xmlto dalam talian menggunakan perkhidmatan onworks.net