docbook-2-pdf - Online di Cloud

PROGRAM:

NAMA

sgml2x — Memformat dokumen SGML/XML dengan mudah menggunakan lembar gaya DSSSL

RINGKASAN

sgml2x [Pilihan] [file sgml | file xml ]

kelas dokter-2-format target [Pilihan] [file sgml | file xml ]

Deskripsi Produk

sgml2x memungkinkan untuk dengan mudah memformat dokumen SGML atau XML menggunakan lembar gaya DSSSL, dan
menyediakan fitur berikut:

· Beberapa kemungkinan lembar gaya per kelas dokumen

· Spesifikasi style-sheet yang mudah menggunakan alias, dengan dukungan untuk parameter
warisan

· Integrasi yang mudah dari style-sheet baru dengan menambahkan file definisi baru yang sederhana di a
direktori konfigurasi

· Penelepon dapat menentukan daftar direktori konfigurasi seperti PATH, default ke
direktori konfigurasi seluruh sistem, per pengguna, dan per proyek

· Pemilihan otomatis lembar gaya default yang akan digunakan, berdasarkan yang ditetapkan
prioritas

· Berikan opsi sewenang-wenang ke giok(1)

Kelas dokumen yang digunakan untuk mencari lembar gaya, dan format output, adalah untuk saat ini
hanya berasal dari nama program yang dipanggil, jadi Anda ingin memanggil ini
program melalui tautan simbolik seperti buku dokumen-2-pdf.

sgml2x adalah diimplementasikan sebagai pembungkus shell di sekitar giok(1) (atau, sebaiknya, batu giok terbuka(1),
meskipun kami menggunakan nama generik giok seluruh dokumentasi ini), batu giok(1) dan lainnya
alat.

Jika tidak ada gioktex.cfg file di dekat dokumen, yang default disalin, yang memungkinkan
produksi bookmark PDF.

Opsi

-c|--katalog katalog
Gunakan katalog SGML yang ditentukan alih-alih default sistem.

-C|--confdir daftar-direktori
Gunakan daftar direktori konfigurasi (dipisahkan spasi). Pilihan ini adalah
kumulatif, yaitu Anda dapat menggunakan beberapa -C pilihan dan daftarnya adalah
bersambung.

Elemen daftar harus diurutkan dari konfigurasi yang paling umum (misalnya seluruh sistem)
ke yang paling spesifik (misalnya di seluruh proyek).

Jika ada direktori yang disediakan melalui opsi ini, daftar direktori default akan menjadi
diabaikan.

-D|--dsslproc dsssl-prosesor
penggunaan dsssl-prosesor untuk menerapkan style-sheet, bukan yang default. Ini
prosesor harus mendukung giok-seperti opsi, seperti -V.

Ketika opsi ini tidak ada, yang pertama ditemukan di dsslproc file dari confdirs adalah
diambil. Lihat "File" lebih lanjut.

-h|--membantu Tampilkan pesan bantuan dan keluar.

-j|--giok dsssl-prosesor
Sinonim usang untuk --dsslproc.

--jadetexfilter filter-perl
Pasca-proses keluaran jadetex menggunakan filter perl.

Ini dapat berguna untuk memaksa pagebreak di beberapa tempat tertentu untuk mengatasi stylesheet
masalah, atau untuk memaksa tanda hubung di mana TeX tidak memiliki pola yang cukup, atau melakukan apa pun
transformasi pintar lainnya yang akan Anda pikirkan.

Lihat contoh/baris perintah file untuk kemungkinan penggunaan.

-n|--tidak bertindak
Cetak perintah alih-alih menjalankannya. Berguna untuk belajar tentang level yang lebih rendah
alat, dan untuk men-debug baris perintah.

-o|--openjade
Kredensial mikro Option is usang. batu giok terbuka sekarang menjadi default jika tersedia. Menggunakan
--dsslproc atau dsslproc file konfigurasi untuk memaksa prosesor tertentu.

Opsi ini digunakan untuk menggunakan batu giok terbuka(1) sebagai prosesor DSSSL alih-alih giok(1).

-O|--jadeopts pilihan batu giok
Opsi tambahan untuk diteruskan ke giok(1). Opsi ini bersifat kumulatif, Anda dapat
tentukan beberapa di antaranya, opsi yang disediakan akan digabungkan.

-q|--diam
Setel verbositas ke tenang

-r|--perkataan
Render isi keterangan dokumen dalam dokumen (komentar elemen di
DokBuku 4, komentar elemen dalam DocBook 3), membuat output yang dihasilkan menjadi
hanya untuk penggunaan internal dokumen, mencetak peringatan tebal pada sampulnya.

Ini adalah fitur khusus docclass dan style-sheet, dan tidak semua style-sheet akan digunakan
ini.

-s|--gaya gaya
Pilih gaya keluaran untuk mengganti default (akhirnya diturunkan dari dokumen).

Gaya yang saat ini tersedia untuk kelas dokumen tertentu dan untuk setiap format output adalah
tergantung pada isi direktori konfigurasi, dan dapat ditampilkan dengan
--membantu .

Perhatikan bahwa ini adalah praktik yang baik untuk menentukan opsi ini dalam prosedur build, sehingga Anda mendapatkan
hasil yang dapat direproduksi terlepas dari style-sheet yang tersedia.

-v|--bertele-tele
Meningkatkan verbositas. Opsi ini dapat ditentukan beberapa kali.

--verbositas N
Setel verbositas ke N. Tingkat verbositas didefinisikan sebagai berikut:

tenang Hanya kesalahan cetak

kegagalan Hanya kesalahan cetak dan peringatan

bertele-tele Juga cetak pemberitahuan

jejak Juga cetak perintah penting saat dijalankan (sebagai --tidak bertindak melakukan).

men-debug Juga cetak pesan debug

-V|--Versi: kapan
Cetak versi program dan keluar.

konfigurasi

sgml2x menggunakan pohon direktori konfigurasi alih-alih file konfigurasi, sehingga
mudah bagi paket lain untuk dipasang dengan risiko rendah merusak pengaturan yang ada.

Hirarki gaya terletak di direktori bernama gaya di setiap konfigurasi
direktori. Versi lama dari program ini digunakan untuk menempatkan hierarki tersebut secara langsung di
direktori konfigurasi.

Direktori konfigurasi berisi satu direktori untuk setiap kelas dokumen yang dikenal, dinamai dengan
nama panggilan kelas dokumen (mis buku dokumen). Direktori docclass tersebut berisi satu sub-
direktori untuk setiap kelas format output (saat ini, hanya html dan mencetak didukung).

Saat ini, masalah implementasi memberlakukan batasan pada nama panggilan untuk kelas dokumen
dan style-sheet: hanya boleh berisi karakter alfanumerik dan garis bawah. Ini
batasan mungkin dijatuhkan di rilis mendatang, tetapi itu tidak akan terjadi sebelum ini
skrip akan ditulis ulang dalam bahasa lain.

Masing-masing direktori tersebut berisi satu file per gaya yang tersedia. Nama-nama file ini
hanya boleh berisi karakter alfanumerik, dan digunakan sebagai nama panggilan untuk gaya. Ini
file berisi baris dengan a kunci: nilai pola, dengan kunci berikut saat ini
didukung:

Id Pengidentifikasi publik untuk lembar gaya

Penj Deskripsi singkat tentang gaya, yang akan ditampilkan dalam pesan bantuan

pdfOverride, psOverride,
rtfOverride, mifOverride" 10 Simbol dsssl dari lembar gaya cetak yang akan disetel
untuk #t (atau a simbol=nilai pasangan, cocok sebagai argumen untuk giok's -V pilihan),
yang akan digunakan untuk format cetak yang diberikan.

Hanya satu simbol per baris override yang diperbolehkan. Untuk menentukan nilai untuk beberapa simbol, gunakan
beberapa baris.

Warisan Julukan dari style-sheet yang satu ini diwarisi, untuk menghindari hal yang tidak perlu
duplikasi definisi gaya.

Saat ini, ini hanya menyebabkan pewarisan *Mengesampingkan parameter.

Prioritas Bilangan bulat positif untuk membantu memilih gaya default ketika seseorang tidak bisa
berasal dari dokumen. Nilai yang lebih tinggi mendapatkan peluang lebih tinggi untuk diambil sebagai
bawaan. Berhati-hatilah menggunakan prioritas rendah untuk gaya yang sangat terspesialisasi untuk a
jenis dokumen generik, sehingga tidak digunakan oleh kesalahan.

Misalnya, kebijakan yang direkomendasikan saat ini untuk lembar gaya DocBook yang berasal dari
Norman Walsh adalah sebagai berikut (dan dapat berubah jika pengalaman membuktikannya tidak memadai).

10 Lembar gaya dasar, yang biasanya harus disesuaikan.

0 Setiap lembar gaya yang ditulis untuk tujuan yang sangat terspesialisasi (mis
lembar produk pemasaran).

1000 Gaya default untuk semua dokumen yang dihasilkan oleh organisasi. Biasanya
kustomisasi ringan, menampilkan preferensi tata letak, organisasi
logo, atau semacamnya.

10-100 Kustomisasi generik lain-lain dari lembar gaya dasar.

Saat Anda menulis versi yang lebih baik dari lembar gaya dengan prioritas n, Anda
biasanya ingin memilih prioritas yang lebih tinggi.

File

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ Direktori konfigurasi default, di mana file konfigurasi berada
mencari. Lihat dokumentasi untuk --confdir lebih lanjut.

kepercayaan/gaya/
Hirarki yang mendefinisikan gaya yang dapat digunakan. Lihat "Konfigurasi" keahlian yang lebih
rincian.

kepercayaan/dssslproc
File yang berisi daftar urutan prosesor dsssl yang harus dicari, dipisahkan oleh
baris baru dan/atau spasi. Garis yang dimulai dengan a # karakter diperlakukan sebagai
komentar. Nilai umum termasuk batu giok terbuka dan giok.

Prosesor DSSSL yang ditentukan di sini harus menerima: -V dan -D kompatibel dengan batu giok
opsi baris perintah.

Direktori konfigurasi dicari mulai dengan yang paling spesifik
satu, sehingga, dengan konfigurasi default, pengaturan proyek dapat menimpa pengguna
pengaturan, yang pada gilirannya dapat mengesampingkan pengaturan sistem.

Nilai khusus palsu dapat digunakan untuk menghentikan pencarian dan mencegah pencarian
direktori yang lebih umum. Jika misalnya sebuah proyek harus menggunakan
openjade-1.4devel perintah dan tidak ada yang lain, itu dapat menentukan openjade-1.4devel palsu
dalam Surat dsslproc file.

Peringatan

Ketika menggunakan openjade-1.4devel sebagai prosesor DSSSL, Anda akan melihat keluhan tentang top-
tingkat aliran-objek yang dihasilkan oleh doctype.dsl, dan penentuan otomatis dokumen-
jenis akan gagal. Kesalahan ini sebaliknya tidak berbahaya. Gagasan tentang bagaimana menghadapi ini, atau
konfirmasi bahwa openjade-1.4devel terlalu ketat, akan dihargai :)

Grafik masa depan

Fitur yang direncanakan untuk rilis mendatang meliputi:

· Integrasi generator indeks

· Integrasi mesin cetak cantik untuk contoh kode

· Spesifikasi transformasi yang akan dirantai

· Deklarasi subset docclasses untuk memungkinkan penggunaan dengan docclass apapun dari style-
lembar yang berlaku untuk docclasses supersetnya.

· Bekerja di lokasi sementara agar tidak mencemari direktori kerja dengan
berkas sementara. Ini tidak semudah kedengarannya, karena merusak dokumen
mengacu pada file gambar menggunakan jalur relatif. Itu mungkin terlihat sebagai serangga giok,
namun.

Jelajahi daftar TODO lengkap dan kirimkan lebih banyak ide kepada kami!

Hak Cipta

Hak Cipta © 2001-2003 Alcove & Yann Dirson.

sgml2x dilisensikan di bawah GNU General Public License, versi 2.

Dokumentasi ini dilisensikan di bawah Lisensi Dokumentasi Gratis GNU, versi 1.

Kontak us

sgml2x merupakan bagian dari Buku Ceruk proyek (link untuk URL http://www.alcove-
labs.org/en/software/alcovebook/) . Silakan gunakan Buku Ceruk mailing daftar (link untuk URL
https://savannah.gnu.org/mail/?group_id=533) untuk berhubungan dengan pengembang dan pengguna.

Daftar bug dan permintaan fitur tersedia melalui a jaringan antarmuka (link untuk URL
https://savannah.gnu.org/support/?group_id=533) . Silakan gunakan untuk mengirimkan masalah dan
ide ide.

Lihat juga

batu giok terbuka(1), giok(1), batu giok(1), collateindex.pl(1).

sgml2x(1)

Gunakan docbook-2-pdf online menggunakan layanan onworks.net