docbook-2-html - Dalam Talian di Awan

JADUAL:

NAMA

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

SINOPSIS

sgml2x [pilihan] [sgmlfile | xmlfile ]

docclass2-format sasaran [pilihan] [sgmlfile | xmlfile ]

Penerangan Produk

sgml2x membolehkan anda memformat dokumen SGML atau XML dengan mudah menggunakan helaian gaya DSSSL, dan
menyediakan ciri-ciri berikut:

· Pelbagai helaian gaya yang mungkin bagi setiap kelas dokumen

· Spesifikasi mudah lembaran gaya menggunakan alias, dengan sokongan untuk parameter
warisan

· Penyepaduan mudah helaian gaya baharu dengan menambah fail definisi baharu yang ringkas dalam a
direktori konfigurasi

· Pemanggil boleh menentukan senarai direktori konfigurasi seperti PATH, secara lalai kepada
direktori konfigurasi seluruh sistem, setiap pengguna dan setiap projek

· Pemilihan automatik helaian gaya lalai untuk digunakan, berdasarkan yang ditetapkan
keutamaan

· Lulus pilihan sewenang-wenangnya kepada jed(1)

Kelas dokumen yang digunakan untuk mencari helaian gaya, dan format output, adalah buat masa ini
hanya berasal daripada nama yang digunakan untuk program, jadi anda akan mahu memanggil ini
program melalui pautan simbolik seperti docbook-2-pdf.

sgml2x adalah dilaksanakan sebagai pembungkus cangkerang jed(1) (atau, sebaik-baiknya, openjade(1),
walaupun kami menggunakan nama generik jed sepanjang dokumentasi ini), jadetex(1) dan lain-lain
alat.

Sekiranya tidak ada jadetex.cfg fail berhampiran dokumen, fail lalai disalin, yang membolehkan
pengeluaran penanda halaman PDF.

Pilihan

-c|--katalog katalog
Gunakan katalog SGML yang ditentukan dan bukannya lalai sistem.

-C|--confdirs senarai dir
Gunakan senarai direktori konfigurasi (dipisahkan ruang putih). Pilihan ini adalah
kumulatif, iaitu anda boleh menggunakan beberapa -C pilihan dan senarai akan
bercantum.

Elemen senarai hendaklah disusun daripada konfigurasi yang paling generik (cth seluruh sistem)
kepada yang paling khusus (cth seluruh projek).

Jika mana-mana direktori disediakan melalui pilihan ini, senarai direktori lalai adalah
diabaikan.

-D|--dssslproc dsssl-pemproses
Penggunaan dsssl-pemproses untuk menggunakan lembaran gaya, bukannya yang lalai. ini
pemproses perlu menyokong jed-seperti pilihan, seperti -V.

Apabila pilihan ini tidak ada, yang pertama ditemui dalam dssslproc fail daripada confdirs ialah
diambil. Lihat "Fail" untuk maklumat lanjut.

-h|- membantu Paparkan mesej bantuan dan keluar.

-j|--jed dsssl-pemproses
Sinonim usang untuk --dssslproc.

--penapis jadetex penapis perl
Pasca proses output jadetex menggunakan penapis perl.

Ini boleh berguna untuk memaksa pecah halaman di beberapa tempat tertentu untuk mengatasi helaian gaya
masalah, atau untuk memaksa tanda sempang apabila TeX tidak mempunyai corak yang mencukupi, atau melakukan apa-apa
transformasi pintar lain yang anda fikirkan.

Melihat contoh/baris arahan fail untuk kegunaan yang mungkin.

-n|--tidak-bertindak
Cetak arahan dan bukannya menjalankannya. Berguna untuk belajar tentang peringkat rendah
alat, dan untuk menyahpepijat baris arahan.

-o|--openjade
ini pilihan is usang. openjade kini menjadi lalai apabila tersedia. guna
--dssslproc atau dssslproc fail konfigurasi untuk memaksa pemproses tertentu.

Pilihan ini digunakan untuk digunakan openjade(1) sebagai pemproses DSSSL dan bukannya jed(1).

-O|--jadeopts pilihan jed
Pilihan tambahan untuk dilalui jed(1). Pilihan ini adalah terkumpul, anda boleh
nyatakan beberapa daripadanya, pilihan yang disediakan akan digabungkan.

-q|--senyap
Tetapkan verbositi kepada tenang

-r|--kenyataan
Berikan kandungan catatan dokumen dalam dokumen (kata unsur dalam
Buku Dokumen 4, komen elemen dalam DocBook 3), menjadikan output yang dihasilkan sebagai
kegunaan dalaman sahaja dokumen, mencetak amaran tebal pada kulit.

Ini ialah ciri khusus docclass dan helaian gaya, dan bukan semua helaian gaya akan digunakan
ini.

-s|--gaya gaya
Pilih gaya output untuk mengatasi lalai (yang akhirnya diperolehi dokumen).

Gaya yang tersedia pada masa ini untuk kelas dokumen tertentu dan untuk setiap format output ialah
bergantung pada kandungan direktori konfigurasi, dan boleh dipaparkan dengan
- membantu pilihan.

Ambil perhatian bahawa amalan yang baik untuk menentukan pilihan ini dalam prosedur binaan, supaya anda mendapat
hasil yang boleh dihasilkan tanpa mengira helaian gaya yang tersedia.

-v|--verbose
Tingkatkan verbositi. Pilihan ini boleh ditentukan beberapa kali.

--verbosity N
Tetapkan verbositi kepada N. Tahap verbositi ditakrifkan seperti berikut:

tenang Hanya ralat cetakan

lalai Hanya ralat cetak dan amaran

kata kerja Juga cetak notis

mengesan Cetak juga arahan penting semasa ia dijalankan (sebagai --tidak-bertindak adakah).

debug Juga cetak mesej penyahpepijatan

-V|--versi
Cetak versi program dan keluar.

konfigurasi

sgml2x menggunakan pepohon direktori konfigurasi dan bukannya fail konfigurasi, supaya ia
mudah untuk pakej lain dipalamkan dengan risiko rendah untuk memecahkan persediaan sedia ada.

Hierarki gaya terletak dalam direktori yang dinamakan gaya dalam setiap konfigurasi
direktori. Versi lama program ini digunakan untuk meletakkan hierarki tersebut secara langsung dalam
direktori konfigurasi.

Direktori konfigurasi mengandungi satu direktori untuk setiap kelas dokumen yang diketahui, dinamakan dengan
nama panggilan kelas dokumen (cth buku dokumen). Direktori kelas doc tersebut mengandungi satu sub-
direktori untuk setiap kelas format output (pada masa ini, sahaja html and cetak disokong).

Pada masa ini, isu pelaksanaan menguatkuasakan pengehadan pada nama panggilan untuk kelas dokumen
dan helaian gaya: ia hanya boleh mengandungi aksara abjad angka dan garis bawah. ini
pengehadan mungkin digugurkan dalam keluaran akan datang, tetapi itu tidak akan berlaku sebelum ini
skrip akan ditulis semula dalam bahasa lain.

Setiap direktori tersebut mengandungi satu fail bagi setiap gaya yang tersedia. Nama fail ini
hanya boleh mengandungi aksara alfanumerik, dan digunakan sebagai nama panggilan untuk gaya. ini
fail mengandungi baris dengan a kekunci: nilai corak, dengan kekunci berikut adalah pada masa ini
disokong:

Id Pengecam awam untuk helaian gaya

Desc Penerangan ringkas tentang gaya, untuk dipaparkan dalam mesej bantuan

pdfOverride, psOverride,
rtfOverride, mifOverride" 10 Simbol dsssl daripada helaian gaya cetakan untuk ditetapkan
kepada #t (atau a lambang=nilai berpasangan, sesuai sebagai hujah kepada jed's -V pilihan),
untuk digunakan untuk format cetakan yang diberikan.

Hanya satu simbol bagi setiap baris penggantian dibenarkan. Untuk menentukan nilai bagi beberapa simbol, gunakan
beberapa baris.

Warisan Nama panggilan helaian gaya yang diwarisi daripadanya, untuk mengelakkan perkara yang sia-sia
pertindihan definisi gaya.

Pada masa ini, ini hanya menyebabkan pewarisan *Timpa parameter.

Keutamaan Integer positif untuk membantu memilih gaya lalai apabila seseorang itu tidak boleh
diperoleh daripada dokumen tersebut. Nilai yang lebih tinggi mendapat peluang yang lebih tinggi untuk diambil sebagai
lalai. Berhati-hati menggunakan keutamaan rendah untuk gaya hiper-pengkhususan untuk a
jenis dokumen generik, supaya ia tidak digunakan secara ralat.

Sebagai contoh, dasar disyorkan semasa untuk helaian gaya DocBook yang diperoleh daripada
Norman Walsh adalah seperti berikut (dan mungkin berubah jika pengalaman membuktikan ia tidak mencukupi).

10 Lembaran gaya asas, yang biasanya mesti disesuaikan.

0 Mana-mana helaian gaya yang ditulis untuk tujuan hiper-pengkhususan (cth
helaian produk pemasaran).

1000 Gaya lalai untuk semua dokumen yang dihasilkan oleh organisasi. Biasanya a
penyesuaian ringan, menampilkan keutamaan susun atur, organisasi
logo, atau sebagainya.

10-100 Pelbagai penyesuaian generik bagi helaian gaya asas.

Apabila anda menulis versi lembaran gaya yang dipertingkatkan dengan keutamaan n, Anda
biasanya mahu memilih keutamaan yang lebih tinggi.

Fail

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ Direktori konfigurasi lalai, di mana fail konfigurasi berada
dicari. Lihat dokumentasi untuk --confdirs untuk maklumat lanjut.

confdir/gaya/
Hierarki yang mentakrifkan gaya yang boleh digunakan. Lihat "Tatarajah" selama lebih
butiran.

confdir/dssslproc
Fail yang mengandungi senarai tertib pemproses dsssl untuk dicari, dipisahkan oleh
baris baharu dan/atau ruang putih. Garisan bermula dengan a # watak dianggap sebagai
komen. Nilai biasa termasuk openjade and jed.

Pemproses DSSSL yang dinyatakan di sini harus menerima -V and -D serasi jed
pilihan baris arahan.

Direktori konfigurasi dicari bermula dengan yang paling khusus
satu, supaya, dengan confdir lalai, tetapan projek mungkin mengatasi pengguna
tetapan, yang seterusnya boleh mengatasi tetapan sistem.

Nilai istimewa palsu boleh digunakan untuk menghentikan carian dan menghalang melihat ke dalam
direktori yang lebih generik. Jika contohnya projek mesti menggunakan
openjade-1.4devel perintah dan tiada yang lain, ia boleh menentukan openjade-1.4devel palsu
dalam yang dssslproc fail.

Kaveat

Apabila menggunakan openjade-1.4devel sebagai pemproses DSSSL, anda akan melihat aduan tentang
tahap aliran-objek yang dihasilkan oleh doctype.dsl, dan penentuan automatik dokumen-
jenis akan gagal. Ralat ini sebaliknya tidak berbahaya. Idea bagaimana untuk menangani perkara ini, atau
pengesahan bahawa openjade-1.4devel terlalu ketat, akan dihargai :)

. masa depan

Ciri yang dirancang untuk keluaran masa hadapan termasuk:

· Penyepaduan penjana indeks

· Penyepaduan enjin cetakan cantik untuk contoh kod

· Spesifikasi transformasi yang akan dirantai

· Pengisytiharan subset docclass untuk membenarkan penggunaan dengan mana-mana docclass bagi gaya-
helaian yang digunakan pada docclass supersetnya.

· Bekerja di lokasi sementara supaya tidak mencemarkan direktori kerja dengan
fail-fail sementara. Ini tidak semudah yang disangkakan, kerana ia memecahkan dokumen
merujuk kepada fail imej menggunakan laluan relatif. Itu boleh dilihat sebagai pepijat jed,
Walau bagaimanapun.

Semak imbas senarai TODO penuh dan hantarkan lebih banyak idea kepada kami!

hak cipta

Hak Cipta © 2001-2003 Alcove & Yann Dirson.

sgml2x dilesenkan di bawah Lesen Awam Am GNU, versi 2.

Dokumentasi ini dilesenkan di bawah Lesen Dokumentasi Percuma GNU, versi 1.

Hubungi Kami us

sgml2x adalah sebahagian daripada AlcoveBook projek (pautan kepada URL http://www.alcove-
labs.org/en/software/alcovebook/) . Sila gunakan AlcoveBook mel senarai (pautan kepada URL
https://savannah.gnu.org/mail/?group_id=533) untuk berhubung dengan pembangun dan pengguna.

Senarai pepijat dan permintaan ciri tersedia melalui a web antara muka (pautan kepada URL
https://savannah.gnu.org/support/?group_id=533) . Sila gunakan untuk mengemukakan masalah dan
idea.

Lihat Juga

openjade(1), jed(1), jadetex(1), collateindex.pl(1).

sgml2x(1)

Gunakan docbook-2-html dalam talian menggunakan perkhidmatan onworks.net