docbook-2-pdf - Online în cloud

PROGRAM:

NUME

sgml2x — Formatează cu ușurință documente SGML/XML folosind foi de stil DSSSL

REZUMAT

sgml2x [Opțiuni] [sgmlfile | xmlfile ]

docclass-2-targetformat [Opțiuni] [sgmlfile | xmlfile ]

Descriere

sgml2x permite formatarea cu ușurință a unui document SGML sau XML folosind foi de stil DSSSL și
oferă următoarele caracteristici:

· Mai multe foi de stil posibile pentru fiecare clasă de document

· Specificarea simplă a foilor de stil folosind aliasuri, cu suport pentru parametru
moștenire

· Integrare ușoară a noilor foi de stil prin adăugarea unui fișier de definiție nou simplu în a
directorul de configurare

· Apelantul poate specifica o listă asemănătoare PATH de directoare de configurare, implicit la
un director de configurare la nivel de sistem, unul per utilizator și unul pe proiect

· Selectarea automată a unei foi de stil implicite care urmează să fie utilizată, pe baza atribuirii
priorități

· Transmite opțiuni arbitrare către jad(1)

Clasa de document folosită pentru a căuta foile de stil și formatul de ieșire, este pentru moment
derivat numai din numele cu care este apelat programul, așa că veți dori să apelați acest lucru
program prin link-uri simbolice precum docbook-2-pdf.

sgml2x este implementat ca un shell wrapper jad(1) (sau, de preferință, openjade(1),
deși folosim denumirea generică jad pe parcursul acestei documentații), jadetex(1) si alte
unelte.

Dacă nu există jadetex.cfg fișier lângă document, unul implicit este copiat, care permite
producerea de marcaje PDF.

Opţiuni

-c|--catalog catalog
Utilizați catalogul SGML specificat în loc de sistemul implicit.

-C|--confdirs dir-list
Utilizați lista (separată prin spații albe) de directoare de configurare. Această opțiune este
cumulativ, adică poți folosi mai multe -C opțiuni și listele vor fi
concatenat.

Elementele listei ar trebui să fie ordonate din configurația cea mai generică (de exemplu, la nivelul întregului sistem)
la cele mai specifice (de exemplu, la nivelul întregului proiect).

Dacă orice director este furnizat prin această opțiune, lista implicită de directoare va fi
ignorat.

-D|--dssslproc dsssl-procesor
Utilizare dsssl-procesor pentru a aplica foaia de stil, în loc de cea implicită. Acest
procesorul trebuie să suporte jad-ca opțiuni, cum ar fi -V.

Când această opțiune nu este prezentă, prima se găsește în dssslproc fișierele din confdirs este
Luat. Vedea „Fișiere” pentru mai multe detalii.

-h|--Ajutor Afișați un mesaj de ajutor și ieșiți.

-j|--jad dsssl-procesor
Sinonim învechit pentru --dssslproc.

--jadetexfilter filtru perl
Post-procesează ieșirea jadetex folosind un filtru perl.

Acest lucru poate fi util pentru a forța întreruperile de pagină în anumite locuri pentru a depăși foaia de stil
probleme, sau pentru a forța scrierea cu silabe în cazul în care TeX nu are suficiente modele, sau face vreuna
altă transformare inteligentă la care te-ai gândi.

A se vedea exemple/linii de comandă fișier pentru posibile utilizări.

-n|--nu-act
Imprimați comenzi în loc să le executați. Util pentru a afla despre nivelul inferior
instrumente și pentru depanarea liniei de comandă.

-o|--openjada
Acest opțiune is învechit. openjade este acum implicit atunci când este disponibil. Utilizare
--dssslproc sau un dssslproc fișier de configurare pentru a forța un anumit procesor.

Se folosea această opțiune openjade(1) ca procesor DSSSL în loc de jad(1).

-O|--jadeopts jad-opțiuni
Opțiuni suplimentare la care să treceți jad(1). Această opțiune este cumulativă, puteți
specificați mai multe dintre ele, opțiunile oferite vor fi concatenate.

-q|--Liniște
Setați verbozitatea la liniştit

-r|--remarci
Redați conținutul observațiilor documentului în document (remarcă elemente în
DocBook 4, comentariu elemente din DocBook 3), făcând rezultatul produs un
numai pentru uz intern document, imprimând un avertisment îndrăzneț pe copertă.

Aceasta este o caracteristică specifică docclass-ului și foilor de stil și nu toate foile de stil vor folosi
acest.

-s|--stil stil
Selectați un stil de ieșire pentru a înlocui implicit (eventual derivat din document).

Stilurile disponibile în prezent pentru o anumită clasă de document și pentru fiecare format de ieșire sunt
depinde de conținutul directoarelor de configurare și poate fi afișat cu
--Ajutor opțiune.

Rețineți că este o practică bună să specificați această opțiune într-o procedură de compilare, astfel încât să obțineți
rezultate reproductibile, indiferent de foile de stil disponibile.

-v|--verbos
Creșteți verbozitatea. Această opțiune poate fi specificată de mai multe ori.

--verbositate N
Setați verbozitatea la N. Nivelurile de verbozitate sunt definite după cum urmează:

liniştit Doar erori de tipărire

lipsă Tipăriți numai erori și avertismente

prolix Tipăriți, de asemenea, notificări

urmări De asemenea, imprimați comenzi semnificative pe măsură ce sunt rulate (ca --nu-act face).

depana Tipăriți și mesajele de depanare

-V|--versiune
Imprimați versiunea programului și ieșiți.

Configuraţie

sgml2x folosește un arbore de director de configurare în loc de un fișier de configurare, astfel încât să fie
ușor de conectat pentru alte pachete, cu un risc scăzut de a rupe o configurație existentă.

Ierarhiile de stiluri sunt situate în directoarele numite stiluri în fiecare configurație
director. Versiunile vechi ale acestui program obișnuiau să pună acele ierarhii direct în
directoarele de configurare.

Un director de configurare conține un director pentru fiecare clasă de document cunoscută, numit cu
o poreclă de clasă de document (de ex docbook). Acele directoare docclass conțin un sub-
director pentru fiecare clasă de format de ieșire (în prezent, numai html și imprima sunt acceptate).

În prezent, problemele de implementare impun o limitare a poreclelor pentru clasele de documente
și foi de stil: pot conține doar caractere alfanumerice și caractere de subliniere. Acest
limitarea poate fi eliminată într-o versiune viitoare, dar asta nu se va întâmpla înainte de aceasta
scenariul este rescris într-o altă limbă.

Fiecare dintre aceste directoare conține un fișier pentru fiecare stil disponibil. Numele acestor fișiere
poate conține doar caractere alfanumerice și sunt folosite ca porecle pentru stiluri. Acest
fișierul conține linii cu a cheie: valoare model, cu următoarele chei fiind în prezent
sprijinit:

Id Identificatorul public pentru foaia de stil

Desc O scurtă descriere a stilurilor, care urmează să fie afișată în mesajul de ajutor

pdfAnulare, psOverride,
rtfOverride, mifOverride" 10 Un simbol dsssl din foaia de stil de imprimare care urmează să fie setat
la #t (sau a simbol=valoare pereche, potrivită ca argument pentru jad's -V opțiune),
pentru a fi utilizat pentru formatul de imprimare dat.

Este permis doar un simbol pe fiecare linie de anulare. Pentru a defini valori pentru mai multe simboluri, utilizați
mai multe rânduri.

Moștenește Porecla unei foi de stil de la care aceasta moștenește, pentru a evita inutil
duplicarea definițiilor de stil.

În prezent, acest lucru cauzează doar moștenirea *Trece peste parametri.

Prioritate Un număr întreg pozitiv pentru a ajuta la selectarea stilului implicit atunci când nu se poate
derivate din document. Valorile mai mari au șanse mai mari de a fi luate ca
Mod implicit. Ai grijă să folosești priorități scăzute pentru stiluri hiperspecializate pentru a
tip de document generic, astfel încât să nu fie folosit de eroare.

De exemplu, politica actuală recomandată pentru foile de stil DocBook derivată din
Norman Walsh este după cum urmează (și se poate schimba dacă experiența dovedește că este inadecvat).

10 Foile de stil de bază, care de obicei trebuie personalizate.

0 Orice foaie de stil care a fost scrisă într-un scop hiperspecializat (de ex
fișa produsului de marketing).

1000 Un stil implicit pentru toate documentele produse de o organizație. De obicei a
personalizare ușoară, cu preferințe de aspect, ale organizației
logo, sau astfel de lucruri.

10-100 Diverse personalizări generice ale foilor de stil de bază.

Când scrieți o versiune îmbunătățită a unei foi de stil cu prioritate n, Vă
de obicei doriți să selectați o prioritate mai mare.

Fişiere

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ Directoarele de configurare implicite, în care se află fișierele de configurare
căutat. Consultați documentația pentru --confdirs pentru mai multe detalii.

confdir/stil/
Ierarhia care definește stilurile utilizabile. Vedea "Configurare" pentru mai multe
Detalii.

confdir/dssslproc
Un fișier care conține o listă ordonată de procesoare dsssl de căutat, separate prin
linii noi și/sau spații albe. Linii care încep cu a # caractere sunt tratate ca
comentarii. Valorile comune includ openjade și jad.

Procesoarele DSSSL specificate aici ar trebui să accepte -V și -D compatibil cu jad
opțiunile din linia de comandă.

Directoarele de configurare sunt căutate începând cu cele mai specifice
unul, astfel încât, cu confdir-urile implicite, setările proiectului pot suprascrie utilizatorul
setări, care la rândul lor pot suprascrie setările sistemului.

Valoarea specială fals poate fi folosit pentru a opri căutarea și a preveni investigarea
directoare mai generice. Dacă de exemplu un proiect trebuie să folosească
openjade-1.4devel comandă și nu alta, poate specifica openjade-1.4devel fals
În dssslproc fișier.

Rezerve

Atunci când se utilizează openjade-1.4devel ca procesor DSSSL, veți vedea o plângere cu privire la
nivel flux-obiect generat de doctype.dsl, și determinarea automată a documentului-
tipul va eșua. Această eroare este altfel inofensivă. Idei despre cum să faci față asta, sau
confirmare că openjade-1.4devel este prea strict, va fi apreciat :)

viitor

Funcțiile planificate pentru versiunile viitoare includ:

· Integrarea unui generator de index

· Integrarea unui motor de tipărire frumos pentru exemple de cod

· Specificarea transformărilor care urmează să fie înlănțuite

· Declararea subsetului de docclass pentru a permite utilizarea cu orice docclass a stilului-
foi care se aplică la superseturile sale docclasses.

· Lucrați într-o locație temporară pentru a nu polua directorul de lucru cu
fișiere temporare. Acest lucru nu este atât de ușor pe cât pare, deoarece sparge un document
se referă la fișierele imagine care utilizează căi relative. Asta poate fi văzut ca o insectă de jad,
in orice caz.

Răsfoiți lista completă de TODO și trimiteți-ne mai multe idei!

Drepturi de autor

Copyright © 2001-2003 Alcove & Yann Dirson.

sgml2x este licențiat conform GNU General Public License, versiunea 2.

Această documentație este licențiată sub Licența GNU Free Documentation License, versiunea 1.

Contact us

sgml2x face parte din AlcoveBook proiect (legătură la URL-ul http://www.alcove-
labs.org/en/software/alcovebook/) . Vă rugăm să utilizați AlcoveBook discuții Listele (legătură la URL-ul
https://savannah.gnu.org/mail/?group_id=533) pentru a intra în contact cu dezvoltatorii și utilizatorii.

Lista erorilor și solicitărilor de funcții este disponibilă prin a web interfață (legătură la URL-ul
https://savannah.gnu.org/support/?group_id=533) . Vă rugăm să-l utilizați pentru a trimite probleme și
idei.

Vedea de asemenea

openjade(1), jad(1), jadetex(1), colateindex.pl(1).

sgml2x(1)

Utilizați docbook-2-pdf online folosind serviciile onworks.net