docbook-2-pdf - Online sa Cloud

PROGRAMA:

NAME

sgml2x — Madaling i-format ang mga SGML/XML na dokumento gamit ang DSSSL style-sheet

SINOPSIS

sgml2x [pagpipilian] [sgmlfile | xmlfile ]

docclass-2targetformat [pagpipilian] [sgmlfile | xmlfile ]

paglalarawan

sgml2x nagbibigay-daan sa madaling pag-format ng SGML o XML na dokumento gamit ang DSSSL style-sheet, at
nagbibigay ng mga sumusunod na tampok:

· Maramihang posibleng mga style-sheet bawat klase ng dokumento

· Madaling pagtutukoy ng mga style-sheet gamit ang mga alias, na may suporta para sa parameter
mana

· Madaling pagsasama ng mga bagong style-sheet sa pamamagitan ng pagdaragdag ng isang simpleng bagong file ng kahulugan sa a
direktoryo ng pagsasaayos

· Maaaring tukuyin ng tumatawag ang isang parang PATH na listahan ng mga direktoryo ng pagsasaayos, na nagde-default sa
isang system-wide, isang per-user, at isang per-project na mga direktoryo ng configuration

· Awtomatikong pagpili ng default na style-sheet na gagamitin, batay sa itinalaga
prayoridad

· Ipasa ang mga arbitrary na opsyon sa magpapagod(1)

Ang klase ng dokumento na ginamit upang hanapin ang mga style-sheet, at ang format ng output, ay sa ngayon
nagmula lamang sa pangalan kung saan tinawag ang programa, kaya gugustuhin mong tawagan ito
programa sa pamamagitan ng simbolikong mga link tulad ng docbook-2-pdf.

sgml2x ay isang ipinatupad bilang isang shell wrapper sa paligid magpapagod(1) (o, mas mabuti, openjade(1),
kahit na ginagamit namin ang generic na pangalan magpapagod sa buong dokumentasyong ito), jadetex(1) at iba pang
kagamitan.

Kung wala jadetex.cfg file na malapit sa dokumento, ang isang default ay kinopya, na nagpapagana
paggawa ng mga PDF bookmark.

Options

-c|--catalog katalogo
Gamitin ang tinukoy na SGML catalog sa halip na ang default ng system.

-C|--confdirs dir-list
Gumamit ng (whitespace-separated) na listahan ng mga direktoryo ng pagsasaayos. Ang pagpipiliang ito ay
pinagsama-samang, ibig sabihin, maaari kang gumamit ng ilan -C mga pagpipilian at ang mga listahan ay magiging
pinagsama-sama.

Ang mga elemento ng listahan ay dapat na inayos mula sa pinaka-generic na configuration (hal. system-wide)
sa pinaka-espesipiko (hal. project-wide).

Kung ang anumang direktoryo ay ibinigay sa pamamagitan ng opsyong ito, ang default na listahan ng direktoryo ay magiging
hindi pinansin

-D|--dssslproc dsssl-processor
paggamit dsssl-processor upang ilapat ang style-sheet, sa halip na ang default. Ito
kailangang suportahan ng processor magpapagod-tulad ng mga pagpipilian, tulad ng -V.

Kapag wala ang opsyong ito, ang unang makikita sa dssslproc mga file mula sa confdirs ay
kinuha. Tingnan mo "Mga file" para sa karagdagang detalye.

-h|- Tumulong Magpakita ng mensahe ng tulong at lumabas.

-j|--jade dsssl-processor
Hindi na ginagamit ang kasingkahulugan ng --dssslproc.

--jadetexfilter perl-filter
I-post-proseso ang output ng jadetex gamit ang isang perl filter.

Maaari itong maging kapaki-pakinabang upang pilitin ang mga pagebreak sa ilang partikular na lugar upang madaig ang stylesheet
mga problema, o upang pilitin ang mga hyphenation kung saan ang TeX ay walang sapat na mga pattern, o wala
ibang matalinong pagbabagong maiisip mo.

Tingnan ang mga halimbawa/mga command-line file para sa mga posibleng gamit.

-n|--walang-kilos
Mag-print ng mga command sa halip na patakbuhin ang mga ito. Kapaki-pakinabang upang matuto tungkol sa mas mababang antas
tool, at para sa pag-debug ng command-line.

-o|--openjade
ito opsyon is lipas na. openjade ay ngayon ang default kapag available. Gamitin
--dssslproc o isang dssslproc configuration file upang pilitin ang isang partikular na processor.

Ginagamit ang pagpipiliang ito openjade(1) bilang DSSSL processor sa halip na magpapagod(1).

-O|--jadeopts jade-opsyon
Mga karagdagang opsyon na ipapasa magpapagod(1). Ang pagpipiliang ito ay pinagsama-sama, maaari mo
tukuyin ang ilan sa mga ito, ang mga ibinigay na opsyon ay pagsasama-samahin.

-q|--tahimik
Itakda ang verbosity sa tahimik

-r|--remarks
I-render ang nilalaman ng mga komento ng dokumento sa dokumento (pangungusap elemento sa
DocBook 4, puna mga elemento sa DocBook 3), na ginagawang isang output ang ginawa
panloob na paggamit lamang dokumento, nagpi-print ng matapang na babala sa pabalat.

Isa itong tampok na docclass- at style-sheet-specific, at hindi lahat ng style-sheet ay gagamit
na ito.

-s|--estilo estilo
Pumili ng istilo ng output para i-override ang default na (sa kalaunan ay hango sa dokumento).

Ang mga istilo na kasalukuyang magagamit para sa isang partikular na klase ng dokumento at para sa bawat format ng output ay
nakadepende sa mga nilalaman ng mga direktoryo ng pagsasaayos, at maaaring ipakita kasama ng
- Tumulong pagpipilian.

Tandaan na magandang kasanayan na tukuyin ang opsyong ito sa isang pamamaraan ng pagbuo, upang makuha mo
mga reproducible na resulta anuman ang magagamit na mga style-sheet.

-v|--verbose
Dagdagan ang verbosity. Maaaring tukuyin ang opsyong ito nang maraming beses.

--verbosity N
Itakda ang verbosity sa N. Ang mga antas ng verbosity ay tinukoy bilang mga sumusunod:

tahimik Mga error sa pag-print lamang

default Mga error at babala lamang sa pag-print

pandiwang Mag-print din ng mga abiso

kopyahin o sipiin sa pamamagitan ng pag-aninag Mag-print din ng mga makabuluhang command habang pinapatakbo ang mga ito (bilang --walang-kilos ginagawa).

mag-alis ng mga insekto Mag-print din ng mga mensahe sa pag-debug

-V|--bersyon
I-print ang bersyon ng programa at lumabas.

Configuration

sgml2x gumagamit ng puno ng direktoryo ng pagsasaayos sa halip na isang file ng pagsasaayos, upang ito ay
madali para sa iba pang mga pakete na mag-plug in na may mababang panganib na masira ang isang umiiral na setup.

Ang mga hierarchy ng mga istilo ay matatagpuan sa mga direktoryo na pinangalanan estilo sa bawat pagsasaayos
direktoryo. Ang mga lumang bersyon ng program na ito ay ginamit upang direktang ilagay ang mga hierarchy na iyon sa
mga direktoryo ng pagsasaayos.

Ang isang direktoryo ng pagsasaayos ay naglalaman ng isang direktoryo para sa bawat kilalang klase ng dokumento, na pinangalanang may
isang palayaw sa klase ng dokumento (hal docbook). Ang mga direktoryo ng docclass na iyon ay naglalaman ng isang sub-
direktoryo para sa bawat klase ng output-format (sa kasalukuyan, lamang html at i-print ay suportado).

Sa kasalukuyan, ang mga isyu sa pagpapatupad ay nagpapatupad ng limitasyon sa mga palayaw para sa mga klase ng dokumento
at mga style-sheet: maaari lamang silang maglaman ng mga alphanumeric at underscore na character. Ito
Ang limitasyon ay maaaring ibagsak sa isang release sa hinaharap, ngunit hindi iyon mangyayari bago ito
ang script ay muling naisulat sa ibang wika.

Ang bawat isa sa mga direktoryo ay naglalaman ng isang file sa bawat magagamit na istilo. Ang mga pangalan ng mga file na ito
maaari lamang maglaman ng mga alphanumeric na character, at ginagamit bilang mga palayaw para sa mga istilo. Ito
file ay naglalaman ng mga linya na may a susi: halaga pattern, na ang mga sumusunod na key ay kasalukuyang
suportado:

Id Ang pampublikong identifier para sa style-sheet

Pagl Isang maikling paglalarawan ng mga istilo, na ipapakita sa mensahe ng tulong

pdfOverride, psOverride,
rtfOverride, mifOverride" 10 Isang dsssl na simbolo mula sa print style-sheet na itatakda
sa #t (o a simbolo=halaga pares, angkop bilang argumento sa magpapagod's -V opsyon),
na gagamitin para sa ibinigay na format ng pag-print.

Isang simbolo lamang sa bawat override na linya ang pinapayagan. Upang tukuyin ang mga halaga para sa ilang mga simbolo, gamitin
ilang linya.

Mga mana Ang palayaw ng isang style-sheet na namana nito, upang maiwasan ang hindi kailangan
pagdoble ng mga kahulugan ng istilo.

Sa kasalukuyan, nagdudulot lamang ito ng pamana ng *I-override parameter.

Karapatang mauna Isang positibong integer upang tumulong sa pagpili ng default na istilo kapag hindi maaaring
nagmula sa dokumento. Ang mas mataas na halaga ay nakakakuha ng mas mataas na pagkakataong makuha bilang
default. Ingatan ang paggamit ng mababang priyoridad para sa mga hyper-specialized na istilo para sa a
generic na uri ng dokumento, upang hindi ito magamit ng error.

Halimbawa, ang kasalukuyang inirerekomendang patakaran para sa DocBook style-sheet na hinango
Ang kay Norman Walsh ay ang mga sumusunod (at maaaring magbago kung mapatunayan ng karanasan na hindi ito sapat).

10 Ang mga base na style-sheet, na karaniwang dapat i-customize.

0 Anumang style-sheet na isinulat para sa hyper-specialized na layunin (hal
sheet ng produkto sa marketing).

1000 Isang default na istilo para sa lahat ng dokumentong ginawa ng isang organisasyon. Karaniwan a
magaan na pagpapasadya, na nagtatampok ng mga kagustuhan sa layout, ng organisasyon
logo, o mga ganoong bagay.

10-100 Sari-saring mga generic na pag-customize ng mga base style-sheet.

Kapag sumulat ka ng pinahusay na bersyon ng isang style-sheet na may priyoridad n, Mo
karaniwang gustong pumili ng mas mataas na priyoridad.

File

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ Ang mga default na direktoryo ng pagsasaayos, kung saan ang mga file ng pagsasaayos ay
hinanap. Tingnan ang dokumentasyon para sa --confdirs para sa karagdagang detalye.

confdir/style/
Ang hierarchy na tumutukoy sa mga magagamit na istilo. Tingnan mo "Configuration" para sa karagdagang
mga detalye.

confdir/dssslproc
Isang file na naglalaman ng nakaayos na listahan ng mga dsssl processor na hahanapin, na pinaghihiwalay ng
mga bagong linya at/o whitespace. Mga linyang nagsisimula sa a # ang karakter ay tinatrato bilang
mga komento. Kasama sa mga karaniwang halaga openjade at magpapagod.

Ang mga processor ng DSSSL na tinukoy dito ay dapat tanggapin ang -V at -D jade-compatible
mga pagpipilian sa command-line.

Ang mga direktoryo ng pagsasaayos ay hinahanap na nagsisimula sa pinakaspesipiko
isa, nang sa gayon, gamit ang mga default na confdir, maaaring ma-override ng mga setting ng proyekto ang user
mga setting, na maaaring mag-override sa mga setting ng system.

Ang espesyal na halaga hindi totoo ay maaaring gamitin upang ihinto ang paghahanap at maiwasan ang pagtingin sa
higit pang mga generic na direktoryo. Kung halimbawa ang isang proyekto ay dapat gumamit ng
openjade-1.4devel command at walang iba, maaari nitong tukuyin openjade-1.4devel hindi totoo
sa kanyang dssslproc file.

Caveats

Kapag gumagamit openjade-1.4devel bilang DSSSL processor, makakakita ka ng reklamo tungkol sa nangungunang-
antas ng daloy-bagay na nabuo ng doctype.dsl, at awtomatikong pagtukoy ng dokumento-
type ay mabibigo. Ang error na ito ay hindi nakakapinsala. Mga ideya kung paano haharapin ito, o
kumpirmasyon na openjade-1.4devel ay masyadong mahigpit, ay pahalagahan :)

Ang hinaharap

Kasama sa mga nakaplanong feature para sa mga release sa hinaharap ang:

· Pagsasama ng isang index generator

· Pagsasama ng isang pretty-printing engine para sa mga halimbawa ng code

· Pagtutukoy ng mga pagbabagong ikakadena

· Deklarasyon ng mga subset na docclasses upang payagan ang paggamit sa anumang docclass ng istilo-
mga sheet na nalalapat sa mga superset na docclass nito.

· Magtrabaho sa isang pansamantalang lokasyon upang hindi marumihan ang gumaganang direktoryo gamit ang
pansamantalang mga file. Ito ay hindi kasingdali ng tila, dahil sinisira nito ang isang dokumento
tumutukoy sa mga file ng imahe gamit ang mga kamag-anak na landas. Iyon ay maaaring makita bilang isang jade bug,
gayunpaman.

I-browse ang buong listahan ng TODO at padalhan kami ng higit pang mga ideya!

Karapatang magpalathala

Copyright © 2001-2003 Alcove & Yann Dirson.

sgml2x ay lisensyado sa ilalim ng GNU General Public License, bersyon 2.

Ang dokumentasyong ito ay lisensyado sa ilalim ng GNU Free Documentation License, bersyon 1.

Makipag-ugnay sa us

sgml2x ay bahagi ng AlcoveBook proyekto (link sa URL http://www.alcove-
labs.org/en/software/alcovebook/) . Mangyaring gamitin ang AlcoveBook mailing mga listahan (link sa URL
https://savannah.gnu.org/mail/?group_id=533) upang makipag-ugnayan sa mga developer at user.

Ang listahan ng mga bug at mga kahilingan sa tampok ay magagamit sa pamamagitan ng a web interface (link sa URL
https://savannah.gnu.org/support/?group_id=533) . Mangyaring gamitin ito upang magsumite ng mga problema at
mga ideya.

Tingnan Rin

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

sgml2x(1)

Gamitin ang docbook-2-pdf online gamit ang mga serbisyo ng onworks.net