docbook-2-rtf - Online in de cloud

PROGRAMMA:

NAAM

sgml2x — Formatteert eenvoudig SGML/XML-documenten met behulp van DSSSL-stijlbladen

KORTE INHOUD

sgml2x [opties] [sgml-bestand | xml-bestand ]

docklasse-2-doelformaat [opties] [sgml-bestand | xml-bestand ]

Omschrijving

sgml2x maakt het mogelijk om eenvoudig een SGML- of XML-document op te maken met behulp van DSSSL-stijlbladen, en
biedt de volgende functies:

· Meerdere mogelijke style-sheets per documentklasse

· Eenvoudige specificatie van style-sheets met behulp van aliassen, met ondersteuning voor parameters
erfenis

· Gemakkelijke integratie van nieuwe style-sheets door een eenvoudig nieuw definitiebestand toe te voegen in een
configuratiemap

· De beller kan een PATH-achtige lijst met configuratiemappen specificeren, standaard ingesteld op
een systeembrede, een per gebruiker en een per project configuratiemappen

· Automatische selectie van een te gebruiken standaard style-sheet, op basis van toegewezen
prioriteiten

· Geef willekeurige opties door aan jade(1)

De documentklasse die wordt gebruikt om naar de stijlbladen te zoeken, en het uitvoerformaat, is voorlopig
alleen afgeleid van de naam waarmee het programma wordt aangeroepen, dus u zult dit willen aanroepen
programma via symbolische koppelingen zoals docboek-2-pdf.

sgml2x is een geïmplementeerd als een shell wrapper rond jade(1) (of liever openjade(1),
hoewel we de generieke naam gebruiken jade in deze documentatie), jadetex(1) en andere
gereedschap.

Als er geen jadetex.cfg bestand in de buurt van het document, wordt een standaardbestand gekopieerd, dat het mogelijk maakt
productie van PDF-bladwijzers.

Opties

-c|--catalogus catalogus
Gebruik de opgegeven SGML-catalogus in plaats van de systeemstandaard.

-C|--confdirs dir-lijst
Gebruik een (door spaties gescheiden) lijst met configuratiemappen. Deze optie is
cumulatief, dwz u kunt er meerdere gebruiken -C opties en de lijsten zullen zijn
aaneengeschakeld.

De lijstelementen moeten worden besteld vanuit de meest generieke configuratie (bijvoorbeeld systeembreed)
tot het meest specifieke (bijvoorbeeld projectbreed).

Als er via deze optie een directory wordt aangeboden, is de standaarddirectorylijst
buiten beschouwing gelaten.

-D|--dssslproc dsssl-processor
Te gebruiken dsssl-processor om de style-sheet toe te passen, in plaats van de standaard. Dit
processor moet ondersteunen jade-achtige opties, zoals -V.

Wanneer deze optie niet aanwezig is, wordt de eerste gevonden in de dsslproc bestanden van confdirs is
genomen. Zien "Bestanden" voor meer details.

-h|--help Geef een helpbericht weer en sluit af.

-j|--jade dsssl-processor
Verouderd synoniem voor --dssslproc.

--jadetexfilter perl-filter
Verwerk de jadetex-uitvoer na met behulp van een perl-filter.

Dit kan handig zijn om pagina-einden op sommige specifieke plaatsen te forceren om het stylesheet te omzeilen
problemen, of om woordafbrekingen te forceren waar TeX niet genoeg patronen heeft, of geen
andere slimme transformatie waar je aan zou denken.

Zie de voorbeelden/opdrachtregels bestand voor mogelijk gebruik.

-n|--geen-act
Druk opdrachten af ​​in plaats van ze uit te voeren. Handig om te leren over lager niveau
tools en voor het debuggen van de opdrachtregel.

-o|--openjade
Deze optie is verouderd. openjade is nu de standaard indien beschikbaar. Gebruik
--dssslproc of dsslproc configuratiebestand om een ​​specifieke processor te forceren.

Deze optie gebruikt om te gebruiken openjade(1) als een DSSSL-processor in plaats van jade(1).

-O|--jadeopt jade-opties
Extra opties om door te geven jade(1). Deze optie is cumulatief, dat kan
specificeer er meerdere, de aangeboden opties worden aaneengeschakeld.

-q|--stil
Stel breedsprakigheid in op rustig

-r|--opmerkingen
Geef de inhoud van documentopmerkingen weer in het document (opmerking elementen in
DocBoek 4, commentaar elementen in DocBook 3), waardoor de geproduceerde output een
enkel inwendig gebruik document, met een gewaagde waarschuwing op de omslag.

Dit is een docclass- en stylesheet-specifieke functie, en niet alle stylesheets zullen deze gebruiken
deze.

-s|--stijl stijl
Selecteer een uitvoerstijl om de (uiteindelijk van het document afgeleide) standaard te overschrijven.

Stijlen die momenteel beschikbaar zijn voor een specifieke documentklasse en voor elk uitvoerformaat
afhankelijk van de inhoud van de configuratiemappen en kan worden weergegeven met de
--help optie.

Merk op dat het een goede gewoonte is om deze optie in een build-procedure te specificeren, zodat u krijgt
reproduceerbare resultaten ongeacht de beschikbare stylesheets.

-v|--uitgebreid
Verhoog de breedsprakigheid. Deze optie kan meerdere keren worden opgegeven.

--breedsprakigheid N
Stel breedsprakigheid in op N. De niveaus van breedsprakigheid worden als volgt gedefinieerd:

rustig Alleen afdrukfouten

verzuim Druk alleen fouten en waarschuwingen af

breedsprakig Druk ook mededelingen af

opsporen Druk ook belangrijke opdrachten af ​​terwijl ze worden uitgevoerd (als --geen-act doet).

debug Druk ook foutopsporingsberichten af

-V|--versie
Druk de programmaversie af en sluit af.

Configuratie

sgml2x gebruikt een configuratiemapboom in plaats van een configuratiebestand, zodat het is
gemakkelijk voor andere pakketten om in te pluggen met een laag risico op het verbreken van een bestaande installatie.

Stijlhiërarchieën bevinden zich in mappen met de naam stijlen in elke configuratie
map. Oude versies van dit programma plaatsten die hiërarchieën rechtstreeks in de
configuratie mappen.

Een configuratiedirectory bevat één directory voor elke bekende documentklasse, genaamd with
een bijnaam van een documentklasse (bijv documentenboek). Die docclass-directories bevatten één sub-
directory voor elke klasse uitvoerformaat (momenteel alleen html en print worden ondersteund).

Momenteel dwingen implementatieproblemen een beperking af op bijnamen voor documentklassen
en stijlbladen: deze kunnen alleen alfanumerieke tekens en onderstrepingstekens bevatten. Dit
beperking kan worden geschrapt in een toekomstige release, maar dat gaat niet eerder gebeuren
script wordt herschreven in een andere taal.

Elk van deze mappen bevat één bestand per beschikbare stijl. De namen van deze bestanden
mogen alleen alfanumerieke tekens bevatten en worden gebruikt als bijnamen voor de stijlen. Dit
bestand bevat regels met een key: waarde patroon, met de volgende toetsen momenteel
ondersteund:

Id De publieke identifier voor de stylesheet

desc Een korte beschrijving van de stijlen, te tonen in het helpbericht

pdfOverschrijven, psOverschrijven,
rtfOverschrijven, mifOverschrijven" 10 Adsssl-symbool uit het in te stellen afdrukstijlblad
naar #t (Of symbool=waarde paar, geschikt als argument voor jade's -V optie),
te gebruiken voor het opgegeven afdrukformaat.

Er is slechts één symbool per overschrijflijn toegestaan. Gebruik om waarden voor verschillende symbolen te definiëren
meerdere lijnen.

Erft De bijnaam van een stylesheet waarvan deze erft, om onnodig te voorkomen
duplicatie van stijldefinities.

Momenteel veroorzaakt dit alleen overerving van de * Overschrijven parameters.

Prioriteit Een positief geheel getal om te helpen bij het selecteren van de standaardstijl wanneer dat niet kan
ontleend aan het document. Hogere waarden krijgen een grotere kans om als aangenomen te worden
standaard. Zorg ervoor dat u lage prioriteiten gebruikt voor hypergespecialiseerde stijlen voor a
generiek documenttype, zodat het niet per ongeluk wordt gebruikt.

Bijvoorbeeld het huidige aanbevolen beleid voor de DocBook-stijlbladen die zijn afgeleid van
Die van Norman Walsh is als volgt (en kan veranderen als uit ervaring blijkt dat deze niet toereikend is).

10 De basisstijlbladen, die meestal moeten worden aangepast.

0 Elke stylesheet die is geschreven voor een hypergespecialiseerd doel (bijv
marketingproductblad).

1000 Een standaardstijl voor alle documenten die door een organisatie worden geproduceerd. Meestal een
licht maatwerk, met lay-outvoorkeuren, die van de organisatie
logo of zo.

10-100 Diverse generieke aanpassingen van de basisstijlbladen.

Wanneer u met voorrang een verbeterde versie van een stylesheet schrijft n, Je
meestal een hogere prioriteit wilt selecteren.

Bestanden

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ De standaard configuratiemappen, waarin de configuratiebestanden zich bevinden
gezocht naar. Zie documentatie voor --confdirs voor meer details.

conf/stijl/
De hiërarchie die bruikbare stijlen definieert. Zien "Configuratie" meer
details.

conf/dssslproc
Een bestand met een geordende lijst van dsssl-processors om naar te zoeken, gescheiden door
nieuwe regels en/of witruimte. Regels beginnend met een # karakter worden behandeld als
opmerkingen. Gemeenschappelijke waarden omvatten openjade en jade.

DSSSL-processors die hier worden gespecificeerd, moeten de -V en -D jade-compatibel
opdrachtregelopties.

De configuratiemappen worden gezocht, te beginnen met de meest specifieke
one, zodat met de standaardconfdirs de projectinstellingen user
instellingen, die op hun beurt de systeeminstellingen kunnen overschrijven.

De speciale waarde vals kan worden gebruikt om het zoeken te stoppen en te voorkomen dat er in gekeken wordt
meer algemene mappen. Als een project bijvoorbeeld de
openjade-1.4devel commando en geen ander, het kan specificeren openjade-1.4devel vals
in de dsslproc bestand.

Voorbehoud

Tijdens gebruik openjade-1.4devel als DSSSL-processor ziet u een klacht over de top-
level flow-object gegenereerd door doctype.dslen automatische bepaling van de document-
typen zal mislukken. Deze fout is verder onschadelijk. Ideeën hoe hiermee om te gaan, of
bevestiging dat openjade-1.4devel is te streng, wordt gewaardeerd :)

De toekomst

Geplande functies voor toekomstige releases zijn onder meer:

· Integratie van een indexgenerator

· Integratie van een mooie print-engine voor codevoorbeelden

· Specificatie van aan te sluiten transformaties

· Declaratie van subset docclasses om het gebruik met elke docclass van de stijl mogelijk te maken
bladen die van toepassing zijn op de superset docclasses.

· Werk op een tijdelijke locatie om de werkmap niet te vervuilen
tijdelijke bestanden. Dit is niet zo eenvoudig als het klinkt, omdat het een document kapot maakt
verwijst naar afbeeldingsbestanden met behulp van relatieve paden. Dat kan gezien worden als een jade bug,
echter.

Blader door de volledige TODO-lijst en stuur ons meer ideeën!

Auteursrechten

Copyright © 2001-2003 Alkoof & Yann Dirson.

sgml2x is gelicenseerd onder de GNU General Public License, versie 2.

Deze documentatie is gelicenseerd onder de GNU Free Documentation License, versie 1.

Neem contact op us

sgml2x deel van de Alkoof Boek project (link naar URL http://www.alcove-
labs.org/en/software/alkoofboek/) . Gebruik alstublieft de Alkoof Boek mailing lijsten (link naar URL
https://savannah.gnu.org/mail/?group_id=533) om in contact te komen met ontwikkelaars en gebruikers.

De lijst met bugs en functieverzoeken is beschikbaar door a Web interface (link naar URL
https://savannah.gnu.org/support/?group_id=533) . Gebruik het om problemen en
ideeën.

Bekijk ook

openjade(1), jade(1), jadetex(1), verzamelindex.pl(1).

sgml2x(1)

Gebruik docbook-2-rtf online met behulp van onworks.net-services