Gummi - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

Gummi - ein Bausystem für LaTeX-Dokumente

ZUSAMMENFASSUNG

Gummi [Optionen] Quellen ...
Gummirohr [Optionen]

BESCHREIBUNG

Rubber ist ein Wrapper für LaTeX und Begleitprogramme. Sein Zweck ist, gegeben ein LaTeX
zu verarbeitende Quelle, um sie oft genug zu kompilieren, um alle Verweise aufzulösen, möglicherweise ausgeführt
Satellitenprogramme wie BibTeX, makeindex, Metapost usw., um entsprechende Daten zu erzeugen
Dateien.

Der Befehl Gummi baut die angegebenen Dokumente vollständig auf. Die Quelldateien können sein
entweder LaTeX-Quellen (in diesem Fall kann das Suffix .tex weggelassen werden) oder Dokumente in a
Format Rubber kann in LaTeX übersetzen. Wenn eine Kompilierung fehlschlägt, das Ganze
Prozessstopps, einschließlich der Kompilierung der nächsten Dokumente auf der Kommandozeile, und
Gummi gibt einen Exit-Code ungleich null zurück.

Der Befehl Gummirohr macht dasselbe für ein Dokument, liest aber die LaTeX-Quelle aus
Standardeingabe und gibt das kompilierte Dokument auf der Standardausgabe aus.

Einige Informationen können nicht aus den LaTeX-Quellen extrahiert werden. Dies ist der Fall, denn
Instanz mit den Suchpfaden (die in Umgebungsvariablen wie
TEXINPUTS) oder der mit Makeindex zu verwendende Stil. Um dieses Problem anzugehen, kann man hinzufügen
Informationen zu Rubber in den Kommentaren der LaTeX-Quellen, siehe Abschnitt Richtlinien.

OPTIONAL

Die Optionen dienen entweder der Auswahl der auszuführenden Aktion oder der Konfiguration der
Bauprozess ein. Sie sind meistens gleich in Gummi und Gummirohr. Optionen werden geparst
unter Verwendung der GNU-Getopt-Konventionen.

-B, --bzip2
Komprimieren Sie das endgültige Dokument (in bzip2 Format). Dies ist äquivalent zu sagen -o
bzip2 nach allen anderen Möglichkeiten.

--sauber
Entfernen Sie alle Dateien, die durch die Kompilierung erzeugt wurden, anstatt das Dokument zu erstellen.
Diese Option ist vorhanden in Gummi nur. Es gilt für die Zusammenstellung, wie es wäre
mit den anderen Optionen der Befehlszeile getan werden, dh sagen "rubber --clean
foo" löscht foo.ps nicht, während "rubber --ps --clean foo" dies tut.

-C, --Befehl
Führen Sie den angegebenen Befehl (oder die Anweisung) aus bevor das Parsen der Eingabedateien. Sehen
Abschnitt Richtlinien .

-e, --Epilog
Führen Sie den angegebenen Befehl (oder die Anweisung) aus nachdem das Parsen der Eingabedateien. Sehen
Abschnitt Richtlinien .

-F, --Macht
Erzwingen Sie mindestens eine Kompilierung der Quelle. Dies kann beispielsweise nützlich sein, wenn
einige ungewöhnliche Abhängigkeiten wurden geändert (zB ein Paket in einem Systemverzeichnis). Dies
Option ist irrelevant in Gummirohr.

-z, --gzip
Komprimieren Sie das endgültige Dokument (in gzip Format). Dies ist äquivalent zu sagen -o gz
nach allen anderen Möglichkeiten.

-H, --help
Zeigen Sie die Liste aller verfügbaren Optionen an und beenden Sie das Programm.

--an Ort und Stelle
Gehen Sie vor dem Kompilieren in das Verzeichnis der Quelldateien, damit das Kompilieren
Ergebnisse sind an der gleichen Stelle wie ihre Quellen.

--hinein
Gehen Sie vor dem Kompilieren in das angegebene Verzeichnis, damit alle Dateien erzeugt werden
dort und nicht im aktuellen Verzeichnis.

--Berufsbezeichnung
Geben Sie einen anderen Jobnamen als den Basisdateinamen an. Dies ändert den Namen von
Ausgabedateien und gilt nur für das erste Ziel.

-k, --halten
Diese Option wird verwendet in Gummirohr nur. Mit dieser Option werden die temporären Dateien
wird nicht entfernt, nachdem das Dokument kompiliert und die Ergebnisse auf ausgegeben wurden
Standardausgabe. Das temporäre Dokument heißt rubtmpX.tex, wobei X eine Zahl ist
so dass anfänglich keine Datei mit diesem Namen existiert.

- l, --Landschaft
Geben Sie an, dass das endgültige Dokument Querformat verwenden soll. Das ist relevant
nur bei Verwendung dvips or dvipdfm.

-nicht, --maxerr
Legen Sie die maximale Anzahl angezeigter Fehler fest. Standardmäßig sind bis zu 10 Fehler
berichtet, sagend -n -1 zeigt alle Fehler an.

-M, --Modul [:]
Verwenden Sie das angegebene Modul zusätzlich zu den Paketen des Dokuments. Argumente können sein
an das Paket übergeben, indem sie nach einem Doppelpunkt hinzugefügt werden, entsprechen sie dem Paket
Optionen in LaTeX. Das Modul ist geladen bevor Analysieren der Quellen des Dokuments.

--nur
Kompilieren Sie das Dokument teilweise, einschließlich nur der angegebenen Quellen. Das funktioniert
indem Sie in der Befehlszeile einen Aufruf von \includeonly einfügen. Das Argument ist ein Komma
getrennte Liste von Dateinamen.

-Ö, --Post [:]
Verwenden Sie das angegebene Modul als Postprozessor. Dies ist ähnlich wie die -m Optionen
außer dass das Modul geladen ist nachdem das Dokument parsen.

-D, --pdf
PDF-Ausgabe erstellen. Wenn diese Option danach kommt --ps (zum Beispiel im Formular
-PD) ist ein Synonym für -o ps2pdf, sonst verhält es sich als -m pdftex, um zu verwenden
pdfLaTeX statt LaTeX.

-P, --ps
Verarbeiten Sie das durch den Prozess erzeugte DVI durch dvips(1) um ein PostScript zu erstellen
dokumentieren. Diese Option ist ein Synonym für -o dvips, es kann nicht danach kommen --pdf.

-Q, --ruhig
Verringern Sie die Ausführlichkeitsstufe. Das ist das Gegenteil von -v.

-R, --lesen
Lesen Sie zusätzliche Direktiven aus der angegebenen Datei (siehe auch Direktive "read").

-S, --src-specials
Aktivieren Sie die Generierung von Quelltexten, wenn der Compiler dies unterstützt. Das ist
entspricht dem Setzen der Variablen src-specials zu ja.

-S, --kurz
Zeigen Sie die Fehlermeldungen von LaTeX in kompakter Form an (ein Fehler pro Zeile).

-ICH, --textpath
Fügen Sie das angegebene Verzeichnis zum Suchpfad von TeX hinzu.

--synctex
Aktivieren Sie die SyncTeX-Unterstützung im LaTeX-Lauf.

--unsicher
Erlauben Sie dem Dokument, beliebige externe Programme aufzurufen. Das ist potentiell
gefährlich ist, verwenden Sie diese Option nur für Dokumente, die aus einer vertrauenswürdigen Quelle stammen.

-in, - ausführlich
Erhöhen Sie die Ausführlichkeitsstufe. Es gibt Level zwischen 0 und 4, das Standardlevel ist 1
für Gummi und 0 für Gummirohr. Vorsicht, Spruch -vvv lässt Rubber viel sprechen.

--Version
Drucken Sie die Versionsnummer und beenden Sie das Programm.

-W, --warnen
Melden Sie Informationen des angegebenen Typs, wenn beim Kompilieren kein Fehler aufgetreten ist. Die
verfügbare Typen sind: Boxen (überfüllte und unterfüllte Kästen), Ref (undefiniert oder
mehrfach definierte Referenzen), misc (andere Warnungen) und alle um alle Warnungen zu melden.

MODULE

Die Wirkung von Gummi wird durch Module beeinflusst. Module berücksichtigen die Besonderheiten von
Pakete und externe Programme.

Angebote
Für jedes Paket, das ein Dokument verwendet, sucht Rubber nach einem Modul mit demselben Namen, um
die Aufgaben ausführen, die dieses Paket erfordert, abgesehen von der Kompilierung durch LaTeX.
Module können zu den standardmäßig bereitgestellten Modulen hinzugefügt werden, um neue Funktionen aufzunehmen (dies ist die
Punkt des Modulsystems). Die Standardmodule sind die folgenden:

Asymptote
Verarbeiten Sie die vom LaTeX-Paket generierten .asy-Dateien und lösen Sie dann a . aus
Neukompilierung.

Beamer Dieses Modul behandelt die zusätzlichen Dateien von Beamer genauso wie andere Inhaltsverzeichnisse.

Bibtex, biblatex
Kümmert sich bei Bedarf um die Verarbeitung des Literaturverzeichnisses des Dokuments mit BibTeX. Dies
Modul wird automatisch geladen, wenn das Dokument das Makro \bibliography . enthält
(siehe auch in Richtlinien für Optionen).

kombinieren
Das Combine-Paket wird verwendet, um mehrere LaTeX-Dokumente zu einem einzigen zusammenzufassen.
und dieses Modul behandelt die Abhängigkeiten in diesem Fall.

epsfig Dieses Modul übernimmt die Grafikeinbindung für die Dokumente, die den alten Stil verwenden
\psfig-Makro. Es ist eigentlich eine Schnittstelle für das Grafikmodul, siehe diese hier
.

Glossare
Führen Sie makeglossaries aus und kompilieren Sie neu, wenn sich die .glo-Datei ändert.

Grafik, Grafikx
Diese Module identifizieren die im Dokument enthaltenen Grafiken und betrachten sie als
Abhängigkeiten für die Kompilierung. Sie verwenden auch Standardregeln, um diese Dateien zu erstellen
mit externen Programmen. Weitere Informationen finden Sie in der Info-Dokumentation.

Hyperref
Behandeln Sie die zusätzlichen Dateien, die dieses Paket in einigen Fällen erzeugt.

Index, makeidx, Bezeichnung
Verarbeiten Sie die Indizes und Nomenklaturen des Dokuments mit Makeindex(1) bei Bedarf (siehe
Abschnitt Richtlinien für Optionen).

ltxtable
Fügen Sie Abhängigkeiten für Dateien hinzu, die über das ltxtable LaTeX-Paket eingefügt wurden.

Minitoc, minitoc-hyper
Entfernen Sie beim Bereinigen zusätzliche Dateien, die erzeugt wurden, um Teiltabellen von . zu erstellen
Inhalt.

mehrverb, wörtlich
Fügt die in \verbatiminput und ähnlichen Makros enthaltenen Dateien zur Liste der hinzu
Abhängigkeiten.

Mehrfachbib
Behandelt die zusätzlichen Bibliographien, die dieses Paket erstellt, und entfernt die zusätzlichen
Dateien zum Reinigen.

xr Fügen Sie der Liste der Abhängigkeiten zusätzliche .aux-Dateien hinzu, die für externe Referenzen verwendet werden.
Daher erfolgt die Neukompilierung automatisch, wenn das referenzierte Dokument geändert wird.

Vorverarbeitung
Die folgenden Module werden für die Verwendung von Programmen bereitgestellt, die eine LaTeX-Quelle aus a
anderes Dateiformat:

cweb Der Zweck dieses Moduls ist es zu laufen flechten(1) bei Bedarf vor dem Kompilierungsvorgang zu
produzieren die LaTeX-Quelle. Dieses Modul wird automatisch geladen, wenn die Datei
in der Befehlszeile angegeben hat .w als Suffix.

lhs2TeX
Dieses Modul verwendet die lhs2TeX Präprozessor zum Generieren der LaTeX-Quelle aus a
Literate Haskell-Programm. Es wird automatisch ausgelöst, wenn der Name der Eingabedatei
endet mit .lhs.

Nachbearbeitung
Die folgenden Module werden bereitgestellt, um verschiedene Arten von Nachbearbeitungen zu unterstützen. Notiz
dass die Reihenfolge beim Einsatz dieser Module wichtig ist: wenn Sie eine Verarbeitungskette nutzen wollen
Gefällt mir
foo.tex -> foo.dvi -> foo.ps -> foo.pdf -> foo.pdf.gz
Sie müssen die Module laden dvips, ps2pdf und gz in dieser Reihenfolge, zum Beispiel mit dem
Befehlszeile
Gummi -p -o ps2pdf -z foo.tex

bzip2 Erstellen Sie eine Version der endgültigen Datei, die mit komprimiert wurde bzip2(1).

dvipdfm
Läuft dvipdfm(1) am Ende der Zusammenstellung, um ein PDF-Dokument zu erstellen.

dvips Läuft dvips(1) am Ende der Kompilierung, um ein PostScript-Dokument zu erstellen. Dies
Modul wird auch über die Kommandozeilenoption geladen --ps.

erweitern Erstellen Sie eine erweiterte LaTeX-Quelle, indem Sie \input-Makros durch enthaltene Dateien ersetzen.
Bibliographie-Makros von der Bibliographie erstellt von Bibtex(1) und lokale Klassen
und Pakete nach ihrer Quelle. Wenn die Hauptdatei foo.tex dann dann erweiterte Datei
wird benannt foo-final.tex. Weitere Informationen finden Sie in der Info-Dokumentation.

gz Erstellen Sie eine Version der endgültigen Datei, die mit komprimiert wurde gzip(1).

ps2pdf Angenommen, die Kompilierung erzeugt ein PostScript-Dokument (zum Beispiel mit
Modulen dvips), konvertieren Sie dieses Dokument in PDF mit ps2pdf(1).

Compiler Wahl
Die folgenden Module werden verwendet, um den LaTeX-Compiler zu ändern:

aleph Verwenden Sie den Aleph-Compiler anstelle von TeX, dh kompiliert das Dokument mit gelähmt(1)
statt Latex.

Omega Verwenden Sie den Omega-Compiler anstelle von TeX, dh kompiliert das Dokument mit Lambda(1)
statt Latex. Wenn das Modul dvips wird auch verwendet, es wird verwenden odvips(1) zu
Übersetzen Sie die DVI-Datei. Beachten Sie, dass dieses Modul automatisch ausgelöst wird, wenn die
Dokument verwendet das Paket Omega.

pdftex Weist Rubber an, zu verwenden pdflatex(1) statt Latex(1) um das Dokument zusammenzustellen. Von
Standardmäßig erzeugt dies eine PDF-Datei anstelle einer DVI-Datei, aber beim Laden des Moduls
mit der Option Dvi (zum Beispiel mit den Worten -m pdftex:dvi) das Dokument ist zusammengestellt
in DVI mit pdflatex. Dieses Modul wird auch von der Kommandozeilenoption geladen
--pdf.

vtex Weist Rubber an, den VTeX-Compiler zu verwenden. Standardmäßig verwendet dies Vlatex wie die
Compiler, um eine PDF-Ausgabe zu erstellen. Mit der Option ps (zB wenn man "Gummi -m . sagt
vtex:ps foo.tex") ist der verwendete Compiler vlatex und das Ergebnis ist eine PostScript-Datei.

Xelatex
Weist Rubber an, zu verwenden Xelatex(1) statt Latex.

Richtlinien

Das automatische Verhalten von Rubber basiert auf der Suche nach Makros in den LaTeX-Quellen.
Wenn dies nicht ausreicht, können Anweisungen in den Kommentaren der Quellen hinzugefügt werden. EIN
Direktive ist eine Zeile wie
% Gummi: cmd args
Die Zeile muss mit einem "%" beginnen, dann eine beliebige Folge von "%"-Zeichen und Leerzeichen, dann der Text
"rubber:" gefolgt von Leerzeichen und einem Befehlsnamen, möglicherweise gefolgt von Leerzeichen und
Argumente.

Allgemein Richtlinien
alias
Stellen Sie sich vor, dass das LaTeX-Makro name1 entspricht name2. Dies kann nützlich sein, wenn
Definieren von Wrappern um unterstützte Makros.

reinigen
Gibt an, dass die angegebene Datei beim Bereinigen mit . entfernt werden soll --sauber.

abhängen
Betrachten Sie die angegebene Datei als Abhängigkeit, damit ihre Änderungszeit beträgt
geprüft.

um []
Deklarieren Sie, dass die angegebene Datei generiert werden muss. Optionen können den Weg angeben
es hergestellt werden soll, sind die verfügbaren Optionen für die Quelle angeben
und mit um die Umrechnungsregel anzugeben. Sag zum Beispiel "make foo.pdf"
von foo.eps" weist darauf hin foo.pdf sollte hergestellt werden aus foo.eps, mit jedem
Umrechnungsregel, die es tun kann. Details zur Datei finden Sie in der Info-Dokumentation
Umwandlung.

Modulen []
Lädt das angegebene Modul, eventuell mit Optionen. Dies entspricht dem
Befehlszeilenoption --Modul.

bei Änderung
Führen Sie den angegebenen Shell-Befehl nach der Kompilierung aus, wenn der Inhalt der
angegebene Datei geändert haben. Der Dateiname endet am ersten Leerzeichen.

Krepppapier
Legen Sie Optionen für das Papierformat fest. Derzeit werden sie verwendet, um zu geben -t Optionen
zu dvips und -p Optionen zu dvipdfm.

Weg
Fügt das angegebene Verzeichnis zum Suchpfad für TeX (und Rubber) hinzu. Der Name von
das Verzeichnis ist alles, was auf die Leerzeichen nach "Pfad" folgt.

produziert
Deklariert, dass der LaTeX-Lauf die angegebene(n) Datei(en) erstellt oder aktualisiert.

besuch
Lesen Sie die angegebene Datei mit Anweisungen. Die Datei muss pro Anweisung eine Anweisung enthalten
Leitung. Leerzeilen und Zeilen, die mit "%" beginnen, werden ignoriert.

Ohne eine erfahrene Medienplanung zur Festlegung von Regeln und Strategien beschleunigt der programmatische Medieneinkauf einfach die Rate der verschwenderischen Ausgaben.
Lesen Sie zusätzliche Konvertierungsregeln aus der angegebenen Datei. Das Format dieser Datei ist
das gleiche wie das von regeln.ini, Einzelheiten finden Sie in der Info-Dokumentation.

kompensieren
Legen Sie den Wert einer Variablen als Zeichenfolge fest. Einzelheiten zu den vorhandenen Variablen und
ihre Bedeutung finden Sie in der Info-Dokumentation.

Setlist
Legen Sie den Wert einer Variablen als (durch Leerzeichen getrennte) Liste von Zeichenfolgen fest. Für Details zu
die vorhandenen Variablen und ihre Bedeutung finden Sie in der Info-Dokumentation.

shell_escape
Markieren Sie das Dokument als externe Programme erfordernd (shell-escape oder write18). Gummi
aktiviert dies nicht, es sei denn, es wird mit der Option --unsafe aufgerufen.

Synctex
Aktivieren Sie die SyncTeX-Unterstützung im LaTeX-Lauf.

ZEIT FÜR STORYTELLING
Beobachten Sie die angegebene Datei auf Änderungen. Wenn sich der Inhalt dieser Datei geändert hat
nach einer Kompilierung wird eine weitere Kompilierung angestoßen. Dies ist nützlich in der
zum Beispiel bei Inhaltsverzeichnissen.

Modulspezifisch Richtlinien
Wenn ein Befehl die Form hat foo.bar, es gilt als Befehl Bar für das Modul foo. Wenn
dieses Modul wird nicht registriert, wenn die Direktive gefunden wird, dann ist der Befehl still
ignoriert. Für die Standardmodule gelten folgende Richtlinien:

biblatex.pfad
Fügt das angegebene Verzeichnis zum Suchpfad für BibTeX-Datenbanken (.bib-Dateien) hinzu.

bibtex.crossrefs
Legen Sie die Mindestanzahl von fest Querverweis erforderlich für die automatische Aufnahme der
referenzierter Eintrag in der Zitationsliste. Dies setzt die Option -min-Querverweise wann
Aufruf Bibtex(1).

bibtex.pfad
Fügt das angegebene Verzeichnis zum Suchpfad für BibTeX-Datenbanken (.bib-Dateien) hinzu.

bibtex.stylepath
Fügt das angegebene Verzeichnis zum Suchpfad für BibTeX-Stile (.bst-Dateien) hinzu.

bibtex.tool
Verwenden Sie anstelle von BibTeX ein anderes Bibliographie-Tool.

dvipdfm.options
Übergeben Sie die angegebenen Befehlszeilenschalter an dvipdfm.

dvips.optionen
Übergeben Sie die angegebenen Befehlszeilenschalter an dvips.

index.tool (Index)
Gibt an, mit welchem ​​Werkzeug der Index verarbeitet werden soll. Die aktuell unterstützten
Werkzeuge sind Makeindex(1) (die Standardauswahl) und xindy(1). Das Argument Index is
optional, kann es verwendet werden, um die Liste der Indizes anzugeben, für die der Befehl gilt.
Wenn vorhanden, muss es in Klammern eingeschlossen werden; die Liste ist durch Kommas getrennt.
Wenn das Argument nicht vorhanden ist, gilt der Befehl für alle Indizes.

index.sprache (Index)
Wählt die Sprache aus, die zum Sortieren des Index verwendet wird. Dies gilt nur bei Verwendung
xindy(1) als Indexierungswerkzeug. Das optionale Argument hat die gleiche Semantik wie
zu teilen.

index.module (Index) ...
Geben Sie an, welche Module bei der Verarbeitung eines Index mit . verwendet werden sollen xindy(1). Die Wahl
Argument hat die gleiche Semantik wie oben.

index.order (Index)
Ändert die Sortieroptionen für die Indizes. Die Argumente sind Wörter (getrennt
durch Leerzeichen) unter Standard, deutsch und Brief. Dies gilt nur bei Verwendung
Makeindex(1). Das optionale Argument hat dieselbe Semantik wie oben.

index.pfad (Index)
Fügt das angegebene Verzeichnis zum Suchpfad für Indexstile (.ist-Dateien) hinzu. Die
Das optionale Argument hat dieselbe Semantik wie oben.

index.style (Index)
Gibt den zu verwendenden Indexstil an. Das optionale Argument hat die gleiche Semantik
wie oben.

makeidx.Sprache, .Module, .Auftrag, .Weg, .Stil, .Werkzeug
Diese Richtlinien sind die gleichen wie für die Index Modul, außer dass sie es nicht tun
akzeptieren Sie das optionale Argument.

multibib.crossrefs, .Weg, .stilpfad, .Werkzeug
Diese Richtlinien sind die gleichen wie für die Bibtex Modul, aber sie gelten für
Bibliographien verwaltet von der Mehrfachbib Paket. Sie nehmen eine optionale erste
Argument, mit der gleichen Konvention wie für die Richtlinien der Index Modul, das
kann verwendet werden, um die Liste der Bibliographien anzugeben, für die der Befehl gilt.

Verwenden Sie Gummi online mit den onworks.net-Diensten