docbook-2-ps - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

sgml2x — Einfaches Formatieren von SGML/XML-Dokumenten mit DSSSL-Stylesheets

ZUSAMMENFASSUNG

sgml2x [Optionen] [sgml-Datei | xml-Datei ]

docclass-2-Zielformat [Optionen] [sgml-Datei | xml-Datei ]

Beschreibung

sgml2x ermöglicht die einfache Formatierung eines SGML- oder XML-Dokuments mit DSSSL-Stylesheets und
bietet folgende Funktionen:

· Mehrere mögliche Stylesheets pro Dokumentenklasse

· Einfache Spezifikation von Stylesheets unter Verwendung von Aliasen, mit Unterstützung für Parameter
Erbschaft

· Einfache Integration neuer Stylesheets durch Hinzufügen einer einfachen neuen Definitionsdatei in a
Konfigurationsverzeichnis

· Der Anrufer kann eine PATH-ähnliche Liste von Konfigurationsverzeichnissen angeben, standardmäßig
ein systemweites, ein benutzerspezifisches und ein projektbezogenes Konfigurationsverzeichnis

· Automatische Auswahl eines zu verwendenden Standard-Stylesheets basierend auf zugewiesenen
Prioritäten

· Übergeben Sie beliebige Optionen an Jade(1)

Die Dokumentklasse, die verwendet wird, um nach den Stylesheets und dem Ausgabeformat zu suchen, ist vorerst
nur von dem Namen abgeleitet, mit dem das Programm aufgerufen wird, also sollten Sie dies nennen
Programm über symbolische Links wie docbook-2-pdf.

sgml2x ist eine als Shell-Wrapper implementierte Umgebung Jade(1) (oder vorzugsweise Openjade(1),
obwohl wir den generischen Namen verwenden Jade in dieser Dokumentation), Jadetex(1) und andere
Werkzeuge.

Wenn es nein gibt jadetex.cfg Datei in der Nähe des Dokuments wird eine Standarddatei kopiert, die es ermöglicht
Erstellung von PDF-Lesezeichen.

Optionen

-c|--Katalog Katalog
Verwenden Sie den angegebenen SGML-Katalog anstelle des Systemstandard.

-C|--vertraut dir-Liste
Verwenden Sie eine (durch Leerzeichen getrennte) Liste von Konfigurationsverzeichnissen. Diese Option ist
kumulativ, dh Sie können mehrere verwenden -C Optionen und die Listen werden
verkettet.

Die Listenelemente sollten aus der allgemeinsten Konfiguration geordnet werden (zB systemweit)
auf die spezifischsten (zB projektweit).

Wenn über diese Option ein Verzeichnis bereitgestellt wird, ist die Standardverzeichnisliste
ignoriert.

-D|--dsslproc dsssl-prozessor
Verwenden Sie die dsssl-prozessor um das Stylesheet anstelle des Standardformats anzuwenden. Dies
Prozessor muss unterstützen Jade-ähnliche Optionen, wie z -V.

Wenn diese Option nicht vorhanden ist, wird die erste gefundene im dsslproc Dateien von confdirs ist
vergriffen. Sehen "Dateien" für weitere Informationen an.

-h|--help Eine Hilfemeldung anzeigen und beenden.

-j|--Jade dsssl-prozessor
Überholtes Synonym für --dsslproc.

--jadetexfilter Perl-Filter
Verarbeiten Sie die Jadetex-Ausgabe mit einem Perl-Filter.

Dies kann nützlich sein, um an bestimmten Stellen Seitenumbrüche zu erzwingen, um das Stylesheet zu umgehen
Probleme zu lösen oder Silbentrennungen zu erzwingen, wenn TeX nicht genügend Muster hat, oder
andere clevere Transformation, an die Sie denken würden.

Weitere Informationen im Beispiele/Befehlszeilen Datei für mögliche Verwendungen.

-n|--no-act
Befehle ausgeben, anstatt sie auszuführen. Nützlich, um mehr über die untergeordnete Ebene zu erfahren
Tools und zum Debuggen der Befehlszeile.

-o|--openjade
Dieses zu erhalten is überholt. Openjade ist jetzt die Standardeinstellung, wenn verfügbar. Verwenden
--dsslproc oder eine dsslproc Konfigurationsdatei, um einen bestimmten Prozessor zu erzwingen.

Diese Option wurde früher verwendet Openjade(1) als DSSSL-Prozessor statt Jade(1).

-O|--jadeopts Jade-Optionen
Zusätzliche Optionen zum Weitergeben an Jade(1). Diese Option ist kumulativ, Sie können
Wenn Sie mehrere davon angeben, werden die bereitgestellten Optionen verkettet.

-q|--ruhig
Ausführlichkeit auf setzen ruhig

-r|--Bemerkungen
Rendern Sie den Inhalt von Dokumentanmerkungen im Dokument (Anmerkung Elemente in
DocBook 4, Kommentar Elemente in DocBook 3), wodurch die produzierte Ausgabe zu einem
nur für den internen Gebrauch Dokument, druckt eine fette Warnung auf das Cover.

Dies ist eine Docclass- und Stylesheet-spezifische Funktion, und nicht alle Stylesheets werden verwendet
Dies.

-s|--Stil Stil
Wählen Sie einen Ausgabestil aus, um den (eventuell vom Dokument abgeleiteten) Standard zu überschreiben.

Derzeit verfügbare Stile für eine bestimmte Dokumentklasse und für jedes Ausgabeformat sind
abhängig vom Inhalt der Konfigurationsverzeichnisse und kann mit der
--help .

Beachten Sie, dass es sich empfiehlt, diese Option in einer Build-Prozedur anzugeben, damit Sie
reproduzierbare Ergebnisse unabhängig von den verfügbaren Stylesheets.

-v|- ausführlich
Erhöhen Sie die Ausführlichkeit. Diese Option kann mehrfach angegeben werden.

--ausführlich N
Ausführlichkeit auf setzen N. Die Ausführlichkeitsstufen sind wie folgt definiert:

ruhig Nur Druckfehler

Standard Nur Druckfehler und Warnungen

ausführlich Auch Mitteilungen drucken

Spur Drucken Sie auch wichtige Befehle, während sie ausgeführt werden (wie --no-act tut).

debuggen Drucken Sie auch Debugging-Meldungen

-V|--Version
Programmversion drucken und beenden.

Konfiguration

sgml2x verwendet einen Konfigurationsverzeichnisbaum anstelle einer Konfigurationsdatei, so dass es
Einfaches Einbinden anderer Pakete mit geringem Risiko, ein bestehendes Setup zu zerstören.

Stilhierarchien befinden sich in Verzeichnissen namens Stile in jeder Konfiguration
Verzeichnis. In alten Versionen dieses Programms wurden diese Hierarchien direkt in die
Konfigurationsverzeichnisse.

Ein Konfigurationsverzeichnis enthält ein Verzeichnis für jede bekannte Dokumentenklasse, benannt mit
ein Dokumentklassen-Spitzname (zB docbook). Diese docclass-Verzeichnisse enthalten eine Unter-
Verzeichnis für jede Klasse des Ausgabeformats (derzeit nur html und drucken sind unterstützt).

Derzeit erzwingen Implementierungsprobleme eine Beschränkung der Kurznamen für Dokumentklassen
und Stylesheets: Sie dürfen nur alphanumerische Zeichen und Unterstriche enthalten. Dies
Die Einschränkung kann in einer zukünftigen Version aufgehoben werden, aber das wird nicht vorher passieren
Skript wird in einer anderen Sprache umgeschrieben.

Jedes dieser Verzeichnisse enthält eine Datei pro verfügbarem Stil. Die Namen dieser Dateien
dürfen nur alphanumerische Zeichen enthalten und werden als Spitznamen für die Stile verwendet. Dies
Datei enthält Zeilen mit a Schlüssel: Wert Muster, mit den folgenden Tasten derzeit
unterstützt:

Id Der öffentliche Bezeichner für das Stylesheet

Beschr Eine kurze Beschreibung der Stile, die in der Hilfenachricht angezeigt werden soll

pdfÜberschreiben, psÜberschreiben,
rtfOverride, mifOverride" 10 Ein dsssl-Symbol aus dem einzustellenden Druck-Stylesheet
zu #t (oder ein Symbol=Wert Paar, geeignet als Argument zu Jade's -V Möglichkeit),
für das angegebene Druckformat zu verwenden.

Es ist nur ein Symbol pro Override-Zeile zulässig. Um Werte für mehrere Symbole zu definieren, verwenden Sie
mehrere Zeilen.

Erbt Der Spitzname eines Stylesheets, von dem dieses erbt, um unnötiges zu vermeiden
Duplizierung von Stildefinitionen.

Derzeit führt dies nur zur Vererbung der *Überschreiben Parameter.

Priorität Eine positive ganze Zahl, um die Auswahl des Standardstils zu erleichtern, wenn einer nicht möglich ist
aus dem Dokument abgeleitet. Höhere Werte haben eine höhere Chance, als angenommen zu werden
Ursprünglich. Achten Sie darauf, niedrige Prioritäten für hyperspezialisierte Stile für a . zu verwenden
generische Dokumentart, damit sie nicht irrtümlich verwendet wird.

Zum Beispiel die aktuell empfohlene Richtlinie für die DocBook-Stylesheets, abgeleitet von
Norman Walsh lautet wie folgt (und kann sich ändern, wenn die Erfahrung sich als unzureichend erweist).

10 Die Basis-Stylesheets, die normalerweise angepasst werden müssen.

0 Jedes Stylesheet, das für einen hyperspezialisierten Zweck geschrieben wurde (zB
Produktdatenblatt).

1000 Ein Standardstil für alle Dokumente, die von einer Organisation erstellt werden. Normalerweise a
leichte Anpassung, mit Layout-Präferenzen, der Organisation
Logo oder ähnliches.

10-100 Verschiedene generische Anpassungen der Basis-Stylesheets.

Wenn Sie eine verbesserte Version eines Stylesheets mit Priorität schreiben nSie
normalerweise eine höhere Priorität wählen möchten.

Mappen

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ Die Standardkonfigurationsverzeichnisse, in denen sich die Konfigurationsdateien befinden
gesucht für. Siehe Dokumentation für --vertraut für weitere Informationen an.

vertrau/Stil/
Die Hierarchie, die verwendbare Stile definiert. Sehen "Aufbau" Für weitere
Details.

vertrau/dssslproc
Eine Datei, die eine geordnete Liste von zu suchenden dsssl-Prozessoren enthält, getrennt durch
Zeilenumbrüche und/oder Leerzeichen. Zeilen beginnend mit a # Charakter werden behandelt als
Kommentare. Gängige Werte umfassen Openjade und Jade.

Hier angegebene DSSSL-Prozessoren sollten die -V und -D Jade-kompatibel
Befehlszeilenoptionen.

Die Konfigurationsverzeichnisse werden beginnend mit den spezifischsten gesucht
eine, damit die Projekteinstellungen mit den Standardconfdirs den Benutzer überschreiben können
Einstellungen, die wiederum die Systemeinstellungen überschreiben können.

Der besondere Wert falsch kann verwendet werden, um die Suche zu stoppen und das Einsehen zu verhindern
mehr generische Verzeichnisse. Wenn zum Beispiel ein Projekt die
openjade-1.4devel Befehl und kein anderer, es kann spezifizieren openjade-1.4devel falsch
in ihrer dsslproc Datei.

Vorsichtsmaßnahmen

Beim Benutzen openjade-1.4devel als DSSSL-Prozessor sehen Sie eine Beschwerde über die Top-
Level Flow-Objekt erzeugt von doctype.dsl, und automatische Ermittlung der Beleg-
Typ wird fehlschlagen. Dieser Fehler ist ansonsten harmlos. Ideen, wie man damit umgeht, oder
Bestätigung, dass openjade-1.4devel ist zu streng, wird geschätzt :)

Die Zukunft

Geplante Funktionen für zukünftige Versionen umfassen:

· Integration eines Indexgenerators

· Integration einer Pretty-Printing-Engine für Codebeispiele

· Spezifikation der zu verkettenden Transformationen

· Deklaration von Teilmengen-Dokumentklassen, um die Verwendung mit jeder Dokumentklasse des Stils zu ermöglichen.
Arbeitsblätter, die für seine übergeordneten Docclasses gelten.

· Arbeiten Sie an einem temporären Ort, um das Arbeitsverzeichnis nicht mit . zu verschmutzen
temporäre Dateien. Das ist nicht so einfach, wie es sich anhört, denn es bricht ein Dokument
verweist auf Bilddateien mit relativen Pfaden. Das kann als Jade-Bug angesehen werden,
aber.

Durchsuchen Sie die vollständige TODO-Liste und senden Sie uns weitere Ideen!

Urheberrecht

Copyright © 2001-2003 Alkoven & Yann Dirson.

sgml2x ist unter der GNU General Public License, Version 2, lizenziert.

Diese Dokumentation ist unter der GNU Free Documentation License, Version 1 lizenziert.

Kontakt us

sgml2x ist in der AlkovenBuch Projekt (Verknüpfung zu URL http://www.alcove-
labs.org/de/software/alkovebook/) . Bitte benutzen Sie die AlkovenBuch Postversand Listen (Verknüpfung zu URL
https://savannah.gnu.org/mail/?group_id=533) um mit Entwicklern und Benutzern in Kontakt zu treten.

Die Liste der Fehler und Funktionsanfragen ist verfügbar bis a Web Schnittstelle (Verknüpfung zu URL
https://savannah.gnu.org/support/?group_id=533) . Bitte verwenden Sie es, um Probleme zu melden und
Ideen.

Weitere Informationen finden Sie auch in den ebenfalls

Openjade(1), Jade(1), Jadetex(1), collateindex.pl(1).

sgml2x(1)

Verwenden Sie docbook-2-ps online mit den onworks.net-Diensten