gropdf - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

gropdf - PDF-Treiber für groff

ZUSAMMENFASSUNG

großpdf [-delvs] [-F dir] [-p Papier größe] [-y Gießerei] [-u [cmapp-Datei]] [Dateien ...]

Es ist möglich, Leerzeichen zwischen einer Befehlszeilenoption und ihrem Parameter zu verwenden.

BESCHREIBUNG

großpdf übersetzt die Ausgabe von GNU troff zu PDF. Normalerweise großpdf sollte aufgerufen werden von
Verwenden des groff-Befehls mit a -Tpdf Möglichkeit. Wenn keine Dateien angegeben sind, großpdf liest die
Standardeingabe. Ein Dateiname von - verursacht auch großpdf um die Standardeingabe zu lesen. PDF
Ausgabe wird auf die Standardausgabe geschrieben. Wann großpdf wird von betrieben groff Optionen können sein
weitergereicht an großpdf Verwendung von groff's -P .

Siehe Sektion FONT INSTALLATION Unten finden Sie eine Anleitung zum Installieren von Schriftarten für großpdf.

OPTIONAL

-d Fügen Sie Debug-Informationen als Kommentare in das PDF ein. Produziert auch ein
unkomprimiertes PDF.

-e Erzwingen, dass alle Schriftarten in das PDF eingebettet werden.

-Fdir Verzeichnis voranstellen dir/ devName zum Suchpfad für Schriftart und Gerätebeschreibung
Dateien; Name ist normalerweise der Name des Geräts pdf.

-l Drucken Sie das Dokument im Querformat aus.

-pPapier größe
Stellen Sie die physische Dimension des Ausgabemediums ein. Dies überschreibt die Papier größe,
Papierlänge und Papierbreite Befehle in der DESC Datei; es akzeptiert dasselbe
Argumente wie die Papier größe Befehl. Sehen groff_font (5) für weitere Einzelheiten.

-v Drucken Sie die Versionsnummer.

-yGießerei
Legen Sie den Hersteller fest, der für die Auswahl von Schriftarten mit demselben Namen verwendet werden soll.

-e Streitkräfte großpdf um ALLE Schriftarten einzubetten (auch die 14 Basis-PDF-Schriftarten).

-s Fügen Sie eine Kommentarzeile an das Ende der PDF-Datei an, die Statistiken anzeigt, z. B. Anzahl der Seiten in
dokumentieren. Ghostscripts ps2pdf beschwert sich über diese Zeile, wenn sie enthalten ist, aber
funktioniert sowieso.

-u
-ucm-Dateiname
Gropdf enthält normalerweise eine ToUnicode CMap mit jeder Schriftart, die mit erstellt wurde text.enc as
die Kodierungsdatei, dies erleichtert die Suche nach Wörtern, die . enthalten
Ligaturen. Sie können Ihre eigene CMap einschließen, indem Sie a . angeben cm-Dateiname oder habe keine
CMap überhaupt durch Weglassen des Arguments.

ANWENDUNG

Die Eingabe zu großpdf muss im Ausgabeformat von . sein troff(1). Dies ist beschrieben in
groff_out(5).

Darüber hinaus müssen die Geräte- und Schriftbeschreibungsdateien für das verwendete Gerät bestimmte
Anforderungen: Die Auflösung muss ein ganzzahliges Vielfaches des 72-fachen der Größenskaladem „Vermischten Geschmack“. Seine
pdf Das Gerät verwendet eine Auflösung von 72000 und eine Größenskala von 1000.

Die Gerätebeschreibungsdatei muss ein gültiges Papierformat enthalten; sehen groff_font(5) für mehr
Informationen. großpdf verwendet die gleichen Typ-1-Adobe-Postscript-Schriften wie die tastet Gerät
Treiber. Obwohl der PDF-Standard die Verwendung anderer Schriftarten (wie TrueType) erlaubt, ist dies
-Implementierung akzeptiert nur die Postscript-Schriftart Typ 1. Es werden weniger Type 1-Schriften unterstützt
nativ in PDF-Dokumenten als die 35 standardmäßig unterstützten Schriftarten tastet und alle Nachschrift
Drucker, aber alle Schriftarten sind verfügbar, da alle, die nicht nativ unterstützt werden, verfügbar sind
automatisch in das PDF eingebettet.

großpdf unterstützt das Konzept der Gießereien, d. h. verschiedene Versionen von im Grunde dasselbe
Schriftart. Während der Installation a Giesserei Dateisteuerelemente, in denen Schriftarten gefunden und erstellt werden groff Schriftarten
aus den Dateien, die es auf Ihrem System erkennt.

Jede Schriftbeschreibungsdatei muss einen Befehl enthalten

Interner Name PS-Name

was besagt, dass der PostScript-Name der Schriftart PS-Name. Zeilen beginnend mit # und
Leerzeilen werden ignoriert. Der Code für jedes in der Schriftartdatei angegebene Zeichen muss
entsprechen dem Code in der Standardcodierung für die Schriftart. Dieser Code kann mit verwendet werden
\N Escape-Sequenz in troff um den Charakter auszuwählen, auch wenn der Charakter dies nicht tut
einen Groff-Namen haben. Jedes Zeichen in der Schriftartdatei muss in der PostScript-Schriftart vorhanden sein,
und die in der Schriftdatei angegebenen Breiten müssen mit den in der PostScript-Schrift verwendeten Breiten übereinstimmen.

Beachten Sie, dass großpdf kann derzeit nur die ersten 256 Glyphen in einer beliebigen Schriftart anzeigen. Dies
Beschränkung wird in einer späteren Version aufgehoben.

großpdf kann automatisch die herunterladbaren Schriftarten einschließen, die zum Drucken des Dokuments erforderlich sind.
Schriftarten können im PFA- oder PFB-Format vorliegen.

Alle herunterladbaren Schriftarten, die bei Bedarf von großpdf muss aufgelistet sein
in der Datei /usr/share/groff/1.22.3/font/devpdf/download; dies sollte aus Zeilen von bestehen
die Form

Gießerei Schriftart Dateinamen

woher Gießerei ist der Herstellername oder leer für den Standardhersteller. Schriftart lernen muss die
PostScript-Name der Schriftart und Dateinamen ist der Name der Datei, die die Schriftart enthält;
Zeilen beginnend mit # und Leerzeilen werden ignoriert; Felder müssen durch Tabulatoren getrennt werden
(Leerzeichen sind nicht dürfen); Dateinamen wird mit dem gleichen Mechanismus gesucht, der verwendet wird
für metrische Dateien für Groff-Schriftarten. Die herunterladen Datei selbst wird auch mit dieser gesucht
Mechanismus; derzeit wird nur die erste gefundene Datei im Schriftartenpfad verwendet. Gießereinamen
sind normalerweise ein einzelnes Zeichen (wie 'U' für URW Foundry) oder leer für die Standardeinstellung
Gießerei. Dieser Standard verwendet die gleichen Schriftarten wie Ghostscript verwendet, wenn es Schriftarten in a . einbettet
PDF Datei.

Im Standard-Setup gibt es Stile namens R, I, B und BI montiert an Schriftpositionen 1
zu 4. Die Schriften sind in Familien gruppiert A, BM, C, H, HN, N, P und T Mitglieder haben
jeder dieser Stile:

AR Avantgarde-Buch
AI Avantgarde-BuchOblique
AB Avantgarde-Demi
ABI AvantGarde-DemiOblique
BMR Bookman-Licht
BMI Bookman-LightItalic
BMB Bookman-Demi
BMBI Bookman-DemiItalic
CR Courier
CI Kurier-Schräg
CB Kurier-Fett
CBI Kurier-BoldOblique
HR Helvetica
HI Helvetica-Schräg
HB Helvetica-Bold
HBI Helvetica-BoldOblique
HNR Helvetica-Schmal
HNI Helvetica-Schmal-Schräg
HNB Helvetica-Schmal-Bold
HNBI Helvetica-Narrow-BoldOblique
NR NewCenturySchlbk-Roman
NI NewCenturySchlbk-Kursiv
NB NewCenturySchlbk-Bold
NBI NewCenturySchlbk-BoldItalic
PR Pfalz-Röm.
PI Palatino-Kursiv
PB Palatino-Bold
PBI Palatino-BoldItalic
TR Zeiten-Roman
TI Times-Kursiv
TB Mal fett
TBI Times-BoldItalic

Es gibt auch die folgende Schriftart, die nicht zu einer Familie gehört:

ZCMI ZapfChancery-MediumItalic

Es gibt auch einige spezielle Schriftarten namens S für die PS Symbol-Schriftart. Die Kleinbuchstaben griechisch
Zeichen werden automatisch geneigt (entsprechend der verfügbaren SymbolSlanted-Schriftart (SS)
Nachschrift). Zapf Dingbats ist erhältlich als ZD, die Glyphe "Hand zeigt nach links" (\[lh]) ist
verfügbar, da es mit der Erweiterung \X'pdf: xrev' definiert wurde, die die
Richtung der Buchstaben innerhalb von Wörtern.

Die Standardfarbe für \m und \M ist schwarz; für Farben, die im 'rgb'-Farbraum definiert sind
setrgbcolor wird verwendet, für 'cmy' und 'cmyk' setcmykcolor, und für 'grau' gesetztgrau. Beachten Sie, dass
setcmykcolor ist ein PostScript LanguageLevel 2-Befehl und daher auf einigen älteren
Drucker.

großpdf versteht einige der X-Befehle, die mit der \X Escape-Sequenzen unterstützt
by gruppiert. Insbesondere wird Folgendes unterstützt.

\X'ps: invis'
Ausgabe unterdrücken.

\X'ps: endinvis'
Stoppen Sie die Unterdrückung der Ausgabe.

\X'ps: exec gsave Strompunkt 2 Kopieren Übersetzen n drehen neg austauschen neg austauschen Übersetzen'
woher n ist der Drehwinkel. Dies dient der Unterstützung der ausrichten Befehl in gpic.

\X'ps: exec grestore'
Wieder verwendet von gpic nach der Drehung wiederherstellen.

\X'ps: exec n setlinebeitreten
woher n kann einer der folgenden Werte sein.

0 = Gehrungsverbindung
1 = Round Join
2 = Fasenverbindung

\X'ps: exec n setlinecap'
woher n kann einer der folgenden Werte sein.

0 = Kolbenkappe
1 = Runde Kappe und
2 = vorstehende quadratische Kappe

\X'ps: ... pdfmark'
Um so pdfmark Makros installiert mit -m pdfmark or -m mspdf (siehe Dokumentation
in 'pdfmark.pdf'). Eine Teilmenge dieser Makros wird automatisch installiert, wenn Sie
- -Tpdf Sie sollten also nicht '-m pdfmark' verwenden müssen, um die meisten PDF-Dateien zu verwenden
Funktionalität.

Alles Andere ps: Tags werden stillschweigend ignoriert.

Eins \X speziell vom DVI-Treiber verwendet wird auch erkannt:

\X'Papiergröße=Papier größe'
wo die Papier größe Parameter ist derselbe wie der Papier größe Befehl. Sehen
groff_font(5) für Einzelheiten. Das bedeutet, dass Sie die Seitengröße nach Belieben ändern können
innerhalb der PDF-Datei, die von . erstellt wird großpdf. Wenn Sie das Papier wechseln möchten
Größe, muss dies erfolgen, bevor Sie mit der Erstellung der Seite beginnen.

Zudem hat auch Frau großpdf unterstützt eine eigene Suite von pdf: Stichworte. Die folgenden Tags sind
unterstützt:

\X'pdf: pdfpic Datei Ausrichtung Breite Höhe Linienlänge'
Platzieren Sie ein Bild des angegebenen Breite enthält die PDF-Zeichnung aus der Datei Datei of
erwünscht Breite und Höhe (ob Höhe fehlt oder null dann wird es skaliert
anteilig). Wenn Ausrichtung is -L die Zeichnung ist linksbündig. Wenn es ist -C or
-R a Linienlänge größer als die Breite der Zeichnung ist ebenfalls erforderlich. Wenn
Breite mit Null angegeben wird, wird die Breite proportional zur Höhe skaliert.

\X'pdf: xrev'
Dies schaltet ein Flag um, das die Druckrichtung umkehrt Brief by Brief,
dh jeder einzelne Buchstabe wird umgekehrt, nicht das ganze Wort. Das ist nützlich für
Umkehren der Richtung von Glyphen in der Dingbats-Schriftart. Um zur Normalität zurückzukehren
Drucken wiederholen Sie den Befehl erneut.

\X'pdf: Markstart /ANN Definition'
Die Makros, die PDF-Lesezeichen unterstützen, verwenden diesen Aufruf intern, um die
Definition des Lesezeichen-Hotspots (Benutzer hat '.pdfhref L' mit dem Text aufgerufen
die zur „Hot-Spot“-Region werden wird). Normalerweise wird dies nie verwendet, außer von
innerhalb der pdfmark-Makros.

\X'pdf: markieren'
Die Makros, die PDF-Lesezeichen unterstützen, verwenden diesen Aufruf intern, um die
Definition des Lesezeichen-Hotspots (Benutzer hat '.pdfhref L' mit dem Text aufgerufen
die zur „Hot-Spot“-Region werden wird). Normalerweise wird dies nie verwendet, außer von
innerhalb der pdfmark-Makros.

\X'pdf: Marksuspend'
\X'pdf: Neustart markieren'
Wenn Sie Pagetraps verwenden, um Überschriften, Fußzeilen usw. zu erstellen, müssen Sie verwenden
diese für den Fall, dass ein 'Hot Spot' eine Seitengrenze überschreitet, andernfalls jede Textausgabe von
das Kopf- oder Fußmakro wird als Teil des 'Hot Spots' markiert. Stoppen
Wenn dies passiert, platzieren Sie einfach '.pdfmarksuspend' und '.pdfmarkrestart' am Anfang und
Ende des Page-Trap-Makros. (Dies sind nur Komfortmakros, die
den \X-Code ausgeben. Diese Makros dürfen nur innerhalb von Pagetraps verwendet werden.)

Einfuhr Grafik
großpdf unterstützt nur den Import anderer PDF-Dateien als Grafiken. Aber diese PDF-Datei kann enthalten
eines der vom PDF-Standard unterstützten Grafikformate (wie JPEG, PNG, GIF usw.).
So kann jede Anwendung, die PDF ausgibt, als eingebettete Datei in verwendet werden großpdf. Das PDF
Datei, die Sie einfügen möchten, muss eine einzelne Seite sein und die Zeichnung muss gerade in die Datei passen
Mediengröße der PDF-Datei. Also, in Inkscape(1) oder Gimp(1) (zum Beispiel) stellen Sie sicher, dass die
Leinwandgröße passt einfach zum Bild.

Der in verwendete PDF-Parser großpdf wurde nicht rigoros mit allen möglichen getestet
Anwendungen, die PDFs erstellen. Wenn Sie ein einseitiges PDF finden, das nicht importiert werden kann
richtig, es lohnt sich, es durch die pdftk(1) Programm durch Ausgabe des Befehls:

pdftk alte Datei.pdf Ausgabe neue Datei.pdf

Sie können das finden neue Datei.pdf wird nun erfolgreich geladen.

TrueType und Sonstiges Schriftart Formate
großpdf unterstützt keine anderen Schriftarten außer Adobe Type 1 (PFA oder PFB).

FONT INSTALLATION

Dieser Abschnitt enthält eine Zusammenfassung der obigen Erläuterungen; es kann als Schritt für Schritt dienen
Schriftarteninstallationsanleitung für großpdf.

· Konvertieren Sie Ihre Schriftart in etwas, das Groff versteht. Dies ist entweder ein PostScript Typ 1
Schriftart in PFA oder PFB, zusammen mit einer AFM-Datei.

Die allererste Zeile in einer PFA/PFB-Datei enthält dies:

%!PS-AdobeFont-1.0:

Eine PFB-Datei hat dies auch in der ersten Zeile, aber dem String wird einiges vorangestellt
binäre Bytes.

· Konvertieren Sie die AFM-Datei in eine Groff-Schriftbeschreibungsdatei mit dem Afmtodit(1) Programm.
Ein Beispielaufruf ist

afmtodit Foo-Bar-Bold.afm Karte/Textkarte FBB

die die metrische Datei 'Foo-Bar-Bold.afm' in die Groff-Schriftart 'FBB' konvertiert. wenn du
eine Schriftfamilie mit normalen, fetten, kursiven und fetten kursiven Schriften haben, ist es
empfohlen, die Buchstaben zu verwenden R, B, I und BI, bzw. als Postfixes im
groff-Schriftnamen, damit die '.fam'-Anfrage von groff funktioniert. Ein Beispiel ist Groffs eingebautes
Times-Roman-Schrift: Der Name der Schriftfamilie lautet T, und die Groff-Schriftnamen sind TR, TB, TI,
und TBI.

· Installieren Sie sowohl die groff-Schriftbeschreibungsdateien als auch die Schriftarten in einem 'devpdf'-Unterverzeichnis
des Schriftpfads, den groff findet. Siehe die Abschnitt in der troff(1) Mann
Seite, die den tatsächlichen Wert des Schriftpfads auflistet. Beachten Sie, dass Groff das nicht verwendet
AFM-Dateien (aber es ist trotzdem eine gute Idee, sie zu speichern).

· Registrieren Sie alle Schriftarten, die auf den Drucker heruntergeladen werden müssen, im 'devpdf/download'
Datei. Nur das erste Vorkommen dieser Datei im Fontpfad wird gelesen. Das heisst
dass Sie die Standard-Download-Datei in das erste Verzeichnis in Ihrer Schriftart kopieren sollten
Pfad und fügen Sie dort Ihre Schriftarten hinzu. Um das obige Beispiel fortzusetzen, nehmen wir an, dass die PS
Fontname für Foo-Bar-Bold.pfa ist 'XY-Foo-Bar-Bold' (der PS-Fontname wird im
Interner Name Feld in der 'FBB'-Datei) und gehört zur Gießerei 'Fcq] also folgendes
Zeile sollte zu 'download' hinzugefügt werden:

F XY-Foo-Bar-Fett Foo-Bar-Bold.pfa

Verwenden Sie ein Tabulatorzeichen, um die Felder zu trennen, und das Feld 'Foundry' sollte null sein für
die Standardgießerei.

GROFF_FONT_PATH
Eine Liste von Verzeichnissen, in denen nach den devName Verzeichnis zusätzlich zu
die Standardwerte. Wenn in der Datei 'Download' die Schriftartdatei angegeben wurde
bei einem vollständigen Pfad werden keine Verzeichnisse durchsucht. Sehen troff(1) und groff_font(5) für
mehr Details.

SOURCE_DATE_EPOCH
Ein Zeitstempel (ausgedrückt als Sekunden seit der Unix-Epoche), der als Erstellung verwendet werden soll
Zeitstempel anstelle der aktuellen Uhrzeit.

Verwenden Sie gropdf online mit den onworks.net-Diensten