pdfroff - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

pdfroff - PDF-Dokumente mit groff erstellen

ZUSAMMENFASSUNG

pdfroff [-abcegilpstzCEGNRSUVXZ] [-d cs] [-f fam] [-F dir] [-I dir] [-L arg] [-m Name]
[-M dir] [-n num] [-o Liste] [-P arg] [-r cn] [-T dev] [-w Name] [-W Name]
[--emit-ps] [--no-toc-umzug] [--no-kill-null-pages] [--stylesheet=Name]
[--keine-pdf-Ausgabe] [--pdf-ausgabe=Name] [--no-reference-dictionary]
[--Referenzwörterbuch=Name] [--Fortschritt melden] [--temporäre-dateien behalten] Datei
...
pdfroff -h | --help
pdfroff -v | --Version [ganz ohne irgendetwas tun oder drücken zu müssen. ...]

BESCHREIBUNG

pdfroff ist ein Wrapper-Programm für das GNU-Textverarbeitungssystem, groff. Es transparent
behandelt die Mechanik von mehreren Durchgängen groff Verarbeitung, wenn auf entsprechend gekennzeichnete
up groff Quelldateien, sodass Inhaltsverzeichnisse und Fließtext formatiert werden
getrennt und anschließend in der richtigen Reihenfolge zur endgültigen Veröffentlichung als
einzelnes PDF-Dokument. Eine weitere optionale „Stylesheet“-Funktion wird bereitgestellt; Dies erlaubt
für die Inhaltsdefinition, die dem Inhaltsverzeichnis vorangestellt werden muss, in der
veröffentlichtes Dokument.

Für jeden Aufruf von pdfroff, der ultimative groff Der Ausgabestrom wird von der nachbearbeitet
GhostScript-Interpreter, um ein fertiges PDF-Dokument zu erzeugen.

pdfroff macht keine Annahmen über die Verwendung von groff
Makropakete, die der Benutzer verwenden kann, um ein gewünschtes Dokument zu erhalten
Format; Wie auch immer, es die enthalten spezifische integrierte Unterstützung für die pdfmark Makropaket,
sollte der Benutzer es verwenden. Insbesondere, wenn die pdfref Makro, definiert im
pdfmark.tmac Paket, wird verwendet, um öffentliche Referenzmarken oder dynamische Links zu solchen zu definieren
Referenzmarken, dann pdfroff führt so viele Vorformatierungen durch groff Pässe nach Bedarf, bis
bis zu einer Höchstgrenze von vier, um ein Dokumentenreferenzwörterbuch zu erstellen, zu
Verweise aufzulösen und den dynamisch definierten Inhalt von Links zu erweitern.

ANWENDUNG

Die Befehlszeile wird gemäß den normalen GNU-Konventionen geparst, jedoch mit einem
Ausnahme — bei der Angabe einer Kurzformoption (dh einer Einzelzeichenoption
durch einen einzelnen Bindestrich eingeleitet) und wenn diese Option ein Argument erwartet, dann sollen be
unabhängig angegeben (dh es kann nicht an eine beliebige Gruppe anderer Singles angehängt werden
Zeichen-Kurzformoptionen).

Optionsnamen in langer Form (dh solche, die durch einen doppelten Bindestrich eingeleitet werden) können abgekürzt werden zu
ihre minimale Länge eindeutige anfängliche Teilzeichenfolge.

Andernfalls pdfroff Verwendung spiegelt stark die von groff selbst. Tatsächlich, mit Ausnahme
-h, -v und -T dev Kurzformoptionen und alle Langformoptionen, die analysiert werden
intern von pdfroff, alle Optionen und Dateinamenargumente, die in der Befehlszeile angegeben sind
werden weitergegeben an groff, um die Formatierung des PDF-Dokuments zu steuern. Folglich,
pdfroff akzeptiert alle Optionen und Argumente, wie in angegeben groff(1), was auch sein kann
gilt als endgültige Referenz für alle Standards pdfroff Optionen und Argumente
Verwendung.

OPTIONAL

pdfroff akzeptiert alle Kurzformoptionen (dh diejenigen, die durch einen einzelnen Bindestrich eingeleitet werden),
die sind erhältlich mit groff selbst. In den meisten Fällen werden diese einfach bestanden
transparent zu groff; die folgenden werden jedoch speziell von pdfroff.

-h Das gleiche wie --help; siehe unten.

-i Verarbeiten Sie die Standardeingabe nach allen anderen angegebenen Eingabedateien. Das ist bestanden
transparent zu groff, aber wenn es mit anderen Optionen gruppiert wird, ist es sollen sei der erste in
die Gruppe. Das Ausblenden innerhalb einer Gruppe unterbricht die Standard-Eingabeverarbeitung, in der
mehrere Durchgänge groff Verarbeitungskontext von pdfroff.

-T dev Nur -T ps wird unterstützt von pdfroff. Der Versuch, andere Geräteursachen anzugeben
pdfroff abbrechen.

-v Das gleiche wie --Version; siehe unten.

Weitere Informationen finden Sie auch in den groff(1) für eine Beschreibung aller anderen Kurzformoptionen, die transparent sind
durchgekommen pdfroff zu groff.

Alle Langformoptionen (dh diejenigen, die durch einen doppelten Bindestrich eingeleitet werden) werden lokal interpretiert
by pdfroff;; Sie sind nicht weitergegeben an groff, sofern unten nicht anders angegeben.

--help Ursachen pdfroff um eine Zusammenfassung der Verwendungssyntax und der unterstützten Optionen anzuzeigen,
und dann aussteigen.

--emit-ps
Unterdrückt den letzten Ausgabekonvertierungsschritt und verursacht pdfroff PostScript ausgeben
Ausgabe statt PDF. Dies kann nützlich sein, um ZwischenpostScript zu erfassen
Ausgabe, wenn ein spezieller Postprozessor verwendet wird, wie z gpräsent zum Beispiel in
Ort der Vorgabe GhostScript PDF-Schreiber.

--temporäre-dateien behalten
Unterdrückt das Löschen von temporären Dateien, das normalerweise nach pdfroff hat
abgeschlossene PDF-Dokumentformatierung; Dies kann nützlich sein, wenn Sie die Formatierung debuggen
Probleme.

Siehe Sektion DATEIEN, für eine Beschreibung der temporären Dateien, die von . verwendet werden pdfroff.

--keine-pdf-Ausgabe
Kann mit dem verwendet werden --Referenzwörterbuch=Name Option (unten beschrieben) zu
Eliminieren Sie den Overhead der PDF-Formatierung bei der Ausführung pdfroff ein erstellen
Referenzwörterbuch zur Verwendung in einem anderen Dokument.

--no-reference-dictionary
Kann verwendet werden, um den Aufwand für die Erstellung eines Referenzwörterbuchs zu eliminieren, wenn es
bekannt ist, dass das Ziel-PDF-Dokument keine öffentlichen Referenzen enthält, die von der
pdfref Makro.

--no-toc-umzug
Kann verwendet werden, um das Extra zu eliminieren groff Bearbeitungspass, der erforderlich ist, um
ein Inhaltsverzeichnis generieren und an den Anfang des PDF-Dokuments verschieben,
bei der Verarbeitung eines Dokuments, dem eine automatisch generierte Tabelle von . fehlt
Inhalt.

--no-kill-null-pages
Während der Vorbereitung auf die Simulation des manuellen Kollationierungsschritts, der traditionell
erforderlich, um von a . umzuziehen Tabelle of Inhalt zum Anfang eines Dokuments, pdfroff
akkumuliert eine Reihe von leeren Seitenbeschreibungen im Zwischenprodukt Postscript
Ausgabestrom. Während des letzten Sortierschritts sind diese leeren Seiten normalerweise
aus dem fertigen Dokument verworfen; diese Option erzwingt pdfroff sie drin lassen
statt.

--pdf-ausgabe=Name
Gibt den Namen an, der für das resultierende PDF-Dokument verwendet werden soll; wenn nicht angegeben, die
Die PDF-Ausgabe wird in die Standardausgabe geschrieben. Eine zukünftige Version von pdfroff kann das gebrauchen
Option, um den Dokumentnamen in einem generierten Referenzwörterbuch zu codieren.

--Referenzwörterbuch=Name
Gibt den Namen an, der für die generierte Referenzwörterbuchdatei verwendet werden soll; wenn
nicht angegeben, wird das Referenzwörterbuch in einer temporären Datei erstellt, die
gelöscht, wenn pdfroff schließt die Verarbeitung des aktuellen Dokuments ab. Diese Option
sollen angegeben werden, wenn das Referenzwörterbuch gespeichert werden soll, zur Verwendung in
Verweise in anderen PDF-Dokumenten.

--Fortschritt melden
Ursachen pdfroff um beim Start eine Informationsmeldung über Standardfehler anzuzeigen
jedes groff Bearbeitungspass.

--stylesheet=Name
Gibt den Namen eines an Varianten des Eingangssignals: Datei, zur Verwendung als Stylesheet für die Formatierung von
Inhalt, der platziert werden soll bevor das Inhaltsverzeichnis im formatierten PDF
Dokument.

--Version
Ursachen pdfroff um eine Meldung zur Versionsidentifikation anzuzeigen. Der gesamte Befehl
Zeile wird dann transparent an . übergeben groff, In einem dank One Passbetrieb einzige, In Ordnung
um das zugehörige anzuzeigen groff Versionsinformationen, bevor Sie das Programm verlassen.

Die folgenden Umgebungsvariablen können gesetzt und exportiert werden, um das Verhalten von
pdfroff.

PDFROFF_COLLATE
Gibt das Programm an, das zum Sortieren des fertigen PDF-Dokuments verwendet werden soll.

Dieser Sortierschritt kann zum Verschieben erforderlich sein Tabellen of Inhalt zum Anfang des
fertiges PDF-Dokument beim Formatieren mit herkömmlichen Makropaketen, die drucken
sie am Ende. Benutzer sollten jedoch normalerweise keine Angaben machen müssen
PDFROFF_COLLATE, (und werden tatsächlich nicht dazu ermutigt). Wenn nicht angegeben,
pdfroff verwendet Durst(1) standardmäßig, was normalerweise ausreicht.

If PDFROFF_COLLATE is angegeben, dann muss es als Filter fungieren und eine Liste von akzeptieren
Dateinamenargumente und schreibe seine Ausgabe in die stdout Strom, woher es geleitet wird
zu den PDFROFF_POSTPROCESSOR_COMMAND, um die fertige PDF-Ausgabe zu erstellen.

Bei der Angabe PDFROFF_COLLATE, muss normalerweise auch angegeben werden
PDFROFF_KILL_NULL_PAGES.

PDFROFF_COLLATE wird ignoriert, wenn pdfroff wird mit dem aufgerufen --no-kill-null-pages
.

PDFROFF_KILL_NULL_PAGES
Gibt Optionen an, die an die . übergeben werden sollen PDFROFF_COLLATE

Es sollte normalerweise nicht notwendig sein, anzugeben PDFROFF_KILL_NULL_PAGESdem „Vermischten Geschmack“. Seine
interner Standard ist a Durst(1) Skript, das dazu gedacht ist, vollständig leer zu entfernen
Seiten aus dem sortierten Ausgabestrom, und die in den meisten Fällen angemessen sein sollten
Anwendungen von pdfroff. Wenn jedoch eine Alternative zu Durst(1) ist angegeben für
PDFROFF_COLLATE, dann ist es wahrscheinlich, dass eine entsprechende alternative Spezifikation
für PDFROFF_KILL_NULL_PAGES erforderlich.

Wie im Fall von PDFROFF_COLLATE, PDFROFF_KILL_NULL_PAGES wird ignoriert, wenn pdfroff
wird mit dem aufgerufen --no-kill-null-pages .

PDFROFF_POSTPROCESSOR_COMMAND
Gibt den Befehl an, der für die endgültige Dokumentkonvertierung von PostScript verwendet werden soll
Zwischenausgabe als PDF. Es muss sich wie ein Filter verhalten und seine Ausgabe in den schreiben
stdout stream und muss eine beliebige Anzahl von Dateien ... Argumente, mit dem
Sonderfall von - vertritt die Standard Strom.

Falls nicht angegeben, PDFROFF_POSTPROCESSOR_COMMAND Standardmäßig ist

gs -dBATCH -dRUHE -dNOPAUSE -dSICHER -sDEVICE=pdfwrite -sAusgabedatei=-

GROFF_TMPDIR
Identifiziert das Verzeichnis, in dem pdfroff sollte temporäre Dateien erstellen. Wenn
GROFF_TMPDIR is nicht angegeben, dann die Variablen TMPDIR, TMP und TEMP sind
wiederum als mögliche temporäre Datei-Repositorys in Betracht gezogen. Wenn keines davon ist
gesetzt, dann werden temporäre Dateien im aktuellen Verzeichnis erstellt.

GROFF_GHOSTSCRIPT_INTERPRETER
Gibt das Programm an, das aufgerufen werden soll, wenn pdfroff Konvertiten groff PostScript-Ausgabe
zu PDF. Wenn PDFROFF_POSTPROCESSOR_COMMAND angegeben ist, dann der Befehlsname it
spezifiziert ist implizit Zugewiesen an GROFF_GHOSTSCRIPT_INTERPRETER, überschreibt alle
explizite Einstellung in der Umgebung angegeben. Wenn GROFF_GHOSTSCRIPT_INTERPRETER is
nicht angegeben, dann pdfroff durchsucht den Prozess PATH, suche ein Programm mit
einen der bekannten Namen für den GhostScript-Interpreter; wenn kein GhostScript
Dolmetscher gefunden werden, pdfroff bricht ab.

GROFF_AWK_INTERPRETER
Gibt das Programm an, das aufgerufen werden soll, wenn pdfroff extrahiert Referenz
Wörterbucheinträge von a groff Zwischennachrichtenstrom. Wenn
GROFF_AWK_INTERPRETER nicht angegeben ist, dann pdfroff durchsucht den Prozess PATH,
Suche nach einem der bevorzugten Programme 'gawk', 'mawk', 'nawk' und awk', in
diese Bestellung; wenn nichts davon gefunden wird, pdfroff gibt eine Warnmeldung aus und
Weiterverarbeitung; in diesem Fall wird jedoch kein Referenzwörterbuch erstellt.

OSTYP In der Regel automatisch vom Betriebssystem definiert, OSTYP wird am verwendet
Microsoft Win32/MS-DOS-Plattformen einzige, um die Vorgabe abzuleiten PATH_SEPARATOR
Zeichen, das beim Parsen des Prozesses verwendet wird PATH nach extern suchen
Hilfsprogramme bzw.

PATH_SEPARATOR
Wenn eingestellt, PATH_SEPARATOR überschreibt das Standardtrennzeichen (':' on
POSIX/UNIX-Systeme, abgeleitet aus OSTYP auf Microsoft Win32/MS-DOS), welches verwendet wird
beim Parsen des Prozesses PATH um nach externen Hilfsprogrammen zu suchen.

SHOW_PROGRESS
Wenn dieser auf einen nicht leeren Wert gesetzt ist, dann pdfroff verhält sich immer so, als ob die
--Fortschritt melden Option wird in der Befehlszeile angegeben.

Verwenden Sie pdfroff online mit den onworks.net-Diensten