Ini ialah arahan db2x_xsltproc yang boleh dijalankan dalam penyedia pengehosan percuma OnWorks menggunakan salah satu daripada berbilang stesen kerja dalam talian percuma kami seperti Ubuntu Online, Fedora Online, emulator dalam talian Windows atau emulator dalam talian MAC OS.
JADUAL:
NAMA
db2x_xsltproc - pembalut panggilan pemproses XSLT
SINOPSIS
db2x_xsltproc [pilihan] xml-dokumen
DESCRIPTION
db2x_xsltproc menggunakan pemproses XSLT 1.0 untuk docbook2X.
Perintah ini menggunakan lembaran gaya XSLT (biasanya diberikan oleh --stylesheet pilihan) kepada
Dokumen XML dalam fail xml-dokumen. Hasilnya ditulis kepada output standard (melainkan
berubah dengan --pengeluaran).
Untuk membaca dokumen XML sumber daripada input standard, nyatakan - sebagai dokumen input.
PILIHAN
--versi
Paparkan versi docbook2X.
TRANSFORMASI OUTPUT PILIHAN
--pengeluaran fail, -o fail
Tulis output ke fail (atau URI) yang diberikan, bukannya output standard.
SUMBER DOKUMEN PILIHAN
--xtermasuk, -I
Proses XSertakan arahan dalam dokumen sumber.
--sgml, -S
Nyatakan bahawa dokumen input ialah SGML dan bukannya XML. Anda perlukan set ini
pilihan jika xml-dokumen sebenarnya adalah fail SGML.
Penghuraian SGML dilaksanakan dengan penukaran kepada XML melalui sgml2xml(1) daripada SP
pakej (atau OSX(1) daripada pakej OpenSP). Semua nama teg dalam fail SGML akan menjadi
dinormalkan kepada huruf kecil (iaitu -xlower pilihan untuk sgml2xml(1) digunakan). ID
atribut tersedia untuk lembaran gaya (iaitu pilihan -xid). Di samping itu, mana-mana
Entiti ISO SDATA yang digunakan dalam dokumen SGML ditukar secara automatik kepada entiti tersebut
Setara Unicode XML. (Ini dilakukan oleh a sed penapis.)
Pengekodan dokumen SGML, jika bukan us-ascii, mesti dinyatakan dengan
pembolehubah persekitaran SP standard: SP_CHARSET_FIXED=1 SP_ENCODING=pengekodan.
(Perhatikan bahawa fail XML menentukan pengekodannya dengan pengisytiharan XML <?xml
versi = "1.0" pengekodan="pengekodan" ?> di bahagian atas fail.)
Pilihan penukaran di atas tidak boleh diubah. Jika anda inginkan penukaran yang berbeza
pilihan, anda harus menggunakan sgml2xml(1) secara manual, dan kemudian lulus keputusan itu
penukaran kepada program ini.
CAPAI SEMULA PILIHAN
--katalog fail katalog, -C fail katalog
Tentukan katalog XML tambahan untuk digunakan untuk menyelesaikan Pengecam Awam Rasmi atau
URI. Katalog SGML tidak disokong.
Katalog ini adalah tidak digunakan untuk menghuraikan dokumen SGML di bawah --sgml pilihan.
Gunakan pembolehubah persekitaran SGML_CATALOG_FILES sebaliknya untuk menentukan katalog untuk
menghuraikan dokumen SGML.
--rangkaian, -N
db2x_xsltproc biasanya akan menolak untuk memuatkan sumber luaran daripada rangkaian, kerana
sebab keselamatan. Jika anda mahu memuatkan daripada rangkaian, tetapkan pilihan ini.
Biasanya anda ingin memasang DTD yang berkaitan dan fail lain secara setempat, dan
sediakan katalog untuk mereka, bukannya memuatkannya secara automatik daripada rangkaian.
LEMBARAN GAYA PILIHAN
--stylesheet fail, -s fail
Tentukan nama fail (atau URI) lembaran gaya untuk digunakan. Manusia nilai istimewa dan
texi diterima sebagai singkatan, untuk menyatakannya xml-dokumen berada dalam DocBook dan
hendaklah ditukar kepada halaman manual atau Texinfo (masing-masing).
--param nama=expr, -p nama=expr
Tambah atau ubah suai parameter pada lembaran gaya. nama ialah nama parameter XSLT, dan
expr ialah ungkapan XPath yang menilai kepada nilai yang dikehendaki untuk parameter.
(Ini bermakna rentetan mesti dipetik, in Selain itu kepada petikan biasa shell
hujah; guna --rentetan-param untuk mengelakkan ini.)
--rentetan-param nama=rentetan, -g nama=rentetan
Tambah atau ubah suai parameter bernilai rentetan pada lembaran gaya.
Rentetan mesti dikodkan dalam UTF-8 (tanpa mengira pengekodan aksara setempat).
MENGHILANGKAN DAN PROFIL
--nyahpepijat, -d
Paparkan, kepada ralat standard, log tentang perkara yang berlaku semasa XSL
transformasi.
--had-bersarang n, -D n
Tukar bilangan maksimum panggilan bersarang kepada templat XSL, digunakan untuk mengesan
gelung tak terhingga berpotensi. Jika tidak dinyatakan, hadnya ialah 500 (lalai libxslt).
--profil, -P
Paparkan maklumat profil: jumlah bilangan panggilan ke setiap templat dalam
lembaran gaya dan masa yang diambil untuk setiap satu. Maklumat ini dikeluarkan mengikut standard
kesilapan.
--xslt-pemproses pemproses, -X pemproses
Pilih pemproses XSLT asas yang digunakan. Pilihan yang mungkin untuk pemproses ialah:
libxslt, saxon, xalan-j.
Pemproses lalai ialah apa sahaja yang ditetapkan semasa docbook2X dibina. libxslt ialah
disyorkan (kerana ia kurus dan pantas), tetapi SAXON jauh lebih teguh dan akan
menjadi lebih membantu semasa menyahpepijat lembaran gaya.
Semua pemproses mempunyai sokongan katalog XML didayakan. (docbook2X memerlukannya.)
Tetapi ambil perhatian bahawa tidak semua pilihan di atas berfungsi dengan pemproses selain daripada libxslt
one.
PERSEKITARAN
XML_CATALOG_FILES
Tentukan Katalog XML. Jika tidak dinyatakan, katalog standard (/etc/xml/catalog) adalah
dimuatkan, jika tersedia.
DB2X_XSLT_PROCESSOR
Tentukan pemproses XSLT untuk digunakan. Kesannya sama seperti --xslt-pemproses
pilihan. Penggunaan utama pembolehubah ini adalah untuk membolehkan anda menguji berbeza dengan cepat
Pemproses XSLT tanpa perlu menambah --xslt-pemproses kepada setiap skrip atau buat fail
dalam sistem binaan dokumentasi anda.
MEMATUHI KEPADA
Bahasa Lembaran Gaya XML – Transformasi (XSLT), versi 1.0 ⟨http://www.w3.org/TR/xslt⟩
, Pengesyoran W3C.
NOTA
Dalam versi terdahulunya (< 0.8.4), docbook2X memerlukan sambungan XSLT untuk dijalankan dan
db2x_xsltproc ialah pemproses berasaskan libxslt khas yang mempunyai sambungan ini dikompilasi.
Apabila keperluan untuk sambungan XSLT digugurkan, db2x_xsltproc menjadi skrip Perl
yang menterjemah pilihan kepada db2x_xsltproc untuk mematuhi format yang diterima oleh
stok xsltproc(1) yang disertakan dengan libxslt.
Sebab utama kewujudan skrip ini adalah keserasian ke belakang dengan mana-mana
skrip atau buat fail yang menggunakan docbook2X. Walau bagaimanapun, ia juga menjadi mudah untuk ditambah
sokongan untuk menggunakan pemproses XSLT lain dengan antara muka baris arahan bersatu. Sesungguhnya,
tiada apa-apa yang istimewa dalam skrip ini untuk docbook2X, atau pun untuk DocBook, dan mungkin begitu
digunakan untuk menjalankan jenis lembaran gaya lain jika anda mahu. Sudah tentu penulis lebih suka
menggunakan arahan ini, kerana format doanya adalah waras dan mudah digunakan. (cth tidak
menaip nama kelas panjang untuk pemproses berasaskan Java!)
Gunakan db2x_xsltproc dalam talian menggunakan perkhidmatan onworks.net
