Dies ist der Befehl, der beim kostenlosen Hosting-Anbieter OnWorks mit einer unserer zahlreichen kostenlosen Online-Workstations wie Ubuntu Online, Fedora Online, dem Windows-Online-Emulator oder dem MAC OS-Online-Emulator ausgeführt werden kann
PROGRAMM:
NAME/FUNKTION
tth, latex2gif, ps2gif, ps2png – TeX- und LaTeX-zu-HTML-Übersetzer und sein Hilfsprogramm
Programm
ZUSAMMENFASSUNG
tth [Optionen] [<file.tex] [>Datei.html] [2>irr]
tth [Optionen] Datei.tex [2>irr]
latex2gif Datei (keine Verlängerung)
ps2gif Datei.ps Datei.gif [icon.gif]
ps2png Datei.ps Datei.gif [icon.gif]
BESCHREIBUNG
tth übersetzt TeX-Quellen, die das einfache Makropaket oder LaTeX verwenden, einschließlich der meisten
Mathematik, in ein nahezu äquivalentes HTML. Der formale Standard, den TTH übersetzt hat
Dokumente folgen ist ausschließlich HTML4.0 Transitional.
Die vollständige Dokumentation ist in der mit dem Programm gelieferten Datei „tth_manual.html“ enthalten.
Diese Manpage ist eine unvollständige Zusammenfassung und wird unregelmäßig aktualisiert. [Zuletzt aktualisiert 1
Mai 2002 von Hans Fredrik Nordhaug.]
Das Programm ist ein Filter, dh es liest von der Standardeingabe und schreibt auf die Standardausgabe.
Darüber hinaus werden Diagnosemeldungen bezüglich der Erkennung von unbekannten oder nicht übersetzten
Konstrukte werden an Standardfehler gesendet.
Beim Umgang mit eingebetteten Grafikdateien tth kann Hilfsprogramme nutzen, ps2gif or
ps2png, die wiederum den Ghostscript-Interpreter nutzen gs (1) und das tragbare
Bitmap Graphics-Befehlssuite, siehe pbm (1).
tth ist im Standardmodus auf jeder vernünftigen Hardware extrem schnell. Umrechnung von gerade
große TeX-Dateien sollten eine Sache von ein oder zwei Sekunden sein. Dies ermöglicht die Verwendung tth
in einem CGI-Skript, um bei Bedarf HTML direkt aus der TeX-Quelle auszugeben; (Standardfehler evtl
müssen dann umgeleitet werden.)
tth behandelt TeX-Dinge wie:
Fast alle Mathematik, einschließlich Symbole, Brüche, Trennzeichen.
{} \begingroup\endgroup-Gruppierung.
\it \bf \sl usw. Stile.
\beginsection.
\mittellinie{}.
\item{...} \itemitem{...} {\obeylines ...}.
Fast alle lateinischen Zeichen mit Akzent werden wie \"o oder \"{e} geschrieben.
\hang \hangindent \narrower für ganze Absätze
(\hangafter ignoriert).
\headline wird zu einem Titel.
% Kommentare. Einfach entfernt.
\halign-Tabellen, prüft die Vorlage auf das Vorhandensein von \vrule,
um zu entscheiden, ob die Tabelle im Rahmenstil sein soll.
\settabs \+ Stiltabellen.
\input: Aber natürlich nicht aus dem impliziten texinputs-Pfad.
\newcount, \number, \advance und Zählereinstellung.
\def, \edef, \xdef, aber keine Argumente mit Trennzeichen.
Alle Definitionen sind global.
\matrix, \pmatrix, aber nicht \bordermatrix. \Fälle.
Die LaTeX-Unterstützung umfasst im Wesentlichen die gesamte Mathematik sowie die folgenden Umgebungen:
em, wörtlich, Mitte, bündig rechts [nur ein Absatz], Vers, Zitat, Zitat,
Aufschlüsseln, Aufzählen, Beschreibung, Liste [als Beschreibung behandelt], Abbildung, Tabelle,
tabular[*,x], equation, displaymath, eqnarray [nur eine Gleichungsnummer], math, array,
thebibliography, [raw]html, index [als Beschreibung].
und LaTeX-Befehle:
[re]newcommand, newenvironment [optionales Argument nicht erlaubt], Kapitel, Abschnitt,
Unterabschnitt, Unterunterabschnitt, Bildunterschrift, Label, Ref, Pageref [keine Nummer], Emph, Textit,
texttt, textbf, Zentrierung, raggedleft, includegraphics, [e]psfig, Titel, Autor, Datum
[nicht automatisch], lefteqn, frac, Inhaltsverzeichnis, Eingabe, include [als Eingabe], Textfarbe,
Farbe [8 Standardfarben], Fußnote [ohne Berücksichtigung optionaler Argumente], zitieren, bibitem,
Bibliographie, winzig ... normalsize ... Riesig, neuer Zähler [kein ``innerhalb''-Support],
setcounter, addtocounter, value [innerhalb von set oder addto counter], arabisch, die,
stepcounter, newline, verb[*], bfseries, itshape, ttfamily, textsc, sicheremath,
listoftables, listoffigures, newtheorem [keine optionalen Argumente erlaubt], heute,
printindex, boldmath, unboldmath, newfont, danke, makeindex, index.
Hypertext-Querverweise innerhalb des Dokuments werden automatisch von (zB) ref,
und Inhaltsverzeichnis.
Wann tth stößt auf TeX-Konstrukte, die es ebenfalls nicht verarbeiten kann, weil kein HTML vorhanden ist
Äquivalent, oder weil es nicht schlau genug ist, versucht es, das Chaos zu beseitigen, das sie machen würden
Andernfalls wird im HTML-Code eine andere Ursache angegeben. Ist dies nicht der Fall, wird im Allgemeinen eine Warnung vor der Aktion angezeigt
sicher, was es tut. Unübersetzbare TeX-Mathematik-Token werden wörtlich eingefügt.
Unabhängigkeit of [Latex Installation und -L wechseln
Ein wesentlicher Unterschied zwischen tth und latex2html ist, dass tth ruft das nicht an Latex or tex
Programme standardmäßig überhaupt nicht und ist nicht speziell von diesen oder gar irgendwelchen abhängig
andere (zB perl), Programme, die auf dem übersetzenden System installiert werden. Seine Portabilität ist
daher praktisch universell.
Vorwärtsreferenzen in LaTeX werden von mehreren Durchläufen verarbeitet, die Hilfsdateien schreiben. tth
führt nur einen einzigen Durchgang durch die Quelle durch. Falls Sie es wollen tth um LaTeX-Konstrukte zu verwenden (zB
Inhaltsverzeichnis, bibliografische Befehle usw.), die von Hilfsdateien abhängen, dann tun Sie
müssen LaTeX auf dem Code ausführen, damit diese Dateien generiert werden. Alternativ kann die tth
Schalter -a verursacht tth automatisch zu versuchen zu laufen Latex in der Datei, wenn keine Hilfsfunktion
Datei .aux existiert.
Bei der Ausführung mit Angabe eines Dateinamens in der Befehlszeile als Nicht-Switch-Argument wird x tth
konstruiert wie gewohnt den Namen der erwarteten LaTeX-Hilfsdateien und sucht nach
sie im selben Verzeichnis wie die Datei. Wenn Sie verwenden tth als Filter muss man sagen
tth , mit dem Schalter -Lfilename, der Basisdateiname dieser Hilfsdateien (das ist
der Name der Originaldatei ohne Erweiterung). Wenn tth kann das entsprechende nicht finden
Auxiliary-Datei, weil Sie LaTeX nicht ausgeführt und die Dateien nicht generiert oder die Dateien nicht eingefügt haben
switch, dann wird das Konstrukt ausgelassen und Sie warnen. Weiterleiten von Verweisen über ref wird nicht
funktionieren, wenn die .aux-Datei nicht verfügbar ist, aber Rückwärtsreferenzen werden. Der -L-Schalter ohne
Dateiname kann verwendet werden, um zu sagen tth dass das zu übersetzende Dokument interpretiert werden soll
als LaTeX-Datei, obwohl die üblichen LaTeX-Header-Befehle fehlen. Das kann nützlich sein
zum Übersetzen einzelner Gleichungen, die (unklugerweise) den Befehl \frac verwenden.
BibTeX Bibliographien
tth unterstützt Bibliographien, die mit \begin{thebibliography} usw. von Hand erstellt wurden.
Solche Bibliographien erfordern nichts über die .aux-Datei hinaus. tth unterstützt auch
Bibliographien, die mit BibTeX aus einer Bibliographie-Datenbank erstellt wurden. Die Datei filename.bbl ist
an der richtigen Stelle im Dokument eingeben. Dieser Dateiname.bbl wird jedoch nicht erstellt
automatisch von Latex. Neben dem Laufen Latex auf der Quelldatei, um die zu erstellen
Auxiliary-Datei müssen Sie auch bibtex filename im selben Verzeichnis ausführen, um die
filename.bbl-Datei und dann ausführen Latex noch einmal, um die Referenzen richtig zu machen. (Dies ist von
natürlich nicht mehr als das Standardverfahren für die Verwendung Bibtex mit Latex aber es muss sein
fertig wenn du willst tth um Ihre Bibliographie richtig zu machen). Wenn Sie die nicht erstellen
.bbl-Datei, oder wenn Sie sie woanders erstellen, dass tth sucht nicht, dann natürlich
tth werde es nicht finden. Da der BibTeX-Prozess relativ umständlich ist, tth bietet eine
Alternative. Verwenden des Schalters -a mit tth wird dazu führen, dass es versucht, die
erforderliche .bbl-Datei automatisch mit Bibtex und Latex.
Es gibt viele verschiedene Stile für Bibliographien und eine große Anzahl verschiedener LaTeX
Erweiterungspakete ist aufgewachsen, um sie zu implementieren, was tth unterstützt nicht. Mehr
vor kurzem wurde durch das Paket eine deutliche Rationalisierung der Situation erreicht
natbib. tth hat eine rudimentäre Unterstützung für seine Befehle \citep und citet im
Standardformular Autor-Datum ohne ein zweites optionales Argument. Eine Stildatei für natbib ist
verteilt mit TTHgold, was es ermöglicht, die meisten seiner nützlicheren Funktionen unterzubringen
Stile und Befehle und wechseln Sie einfach vom Autor-Datum-Zitat zu numerischen Zitaten.
Indizierung
tth kann einen äußerst nützlichen Hyperlink-Index mit LaTeX-Einträgen zur automatischen Indexierung erstellen.
Die Indizierung eines HTML-Dokuments unterscheidet sich jedoch von der Indizierung eines gedruckten Dokuments, weil a
Der gedruckte Index bezieht sich auf Seitenzahlen, die in HTML keine Bedeutung haben, weil es keine gibt
Seitenumbrüche. TTH indiziert LaTeX-Dokumente nach Abschnittsnummer und nicht nach Seite; vorausgesetzt,
natürlich, dass sie mit Indexeinträgen in der Standard-LaTeX-Manier aufbereitet wurden.
tth erstellt einen Index basierend auf den Standard-LaTeX-Befehlen "\makeindex" und
"\index{...}" und automatisch verarbeiten und einlesen, wenn "\printindex" . ist
angetroffen. Die Befehlszeile zum Aufrufen des makeindex-Programms (nicht Teil davon
Verteilung) kann mit der geändert werden -x Schalter. Für eine Datei ohne "\makeindex"
Befehl, tth wird keine Indexdateien schreiben, sondern nur eine vorhandene „file.ind“ einlesen, falls vorhanden
besteht.
Grafiken Aufnahme: epsfbox/includegraphics
Die Standardmethode zum Einbinden einer Grafik in Plain TeX ist die Verwendung der epsf-Makros. Die Arbeit ist
erledigt von \epsfbox{file.ps} was tth parsen kann. Standardmäßig tth erzeugt einen einfachen Link zu
eine solche Postscript-Datei oder eine beliebige Formatdatei.
Optional kann TTH ein geeigneteres Grafikformat verwenden, indem es verwendet ps2gif or ps2png zu
Konvertieren Sie die Postscript-Datei in eine PNG- oder GIF-Datei, "file.png" loading="lazy" oder file.gif" Wenn der Wechsel
-e1 oder -e2 wird angegeben, wenn ``file.png'', ``file.gif'' oder ``file.jpg'' bereits existiert in
das gleiche Verzeichnis wie durch den Verweis auf ``file.ps'' impliziert, dann wird keine Konvertierung durchgeführt
und stattdessen wird die gefundene Datei verwendet. Diese Grafikdatei wird dann automatisch entweder
verknüpft (-e1) oder inline (-e2) im Dokument. Wenn keine solche Datei gefunden wird, versucht TTH, sie zu finden
Erstellen Sie eine Postscript-Datei mit der Erweiterung „.ps“ oder „.eps“ und konvertieren Sie sie zunächst
Verwenden Sie ps2png und dann, falls erfolglos, ps2gif. Auf vielfachen Wunsch eine dritte Grafikoption
-e3 zum Generieren von Symbolen ist jetzt verfügbar.
Der LaTeX-Befehl \includegraphics{...} und das ältere \[e]psfig{file=...} werden als
wie \epsfbox. Ihre optionalen Argumente werden ignoriert.
Bild Environments
Die Bildumgebung kann nicht in HTML übersetzt werden. Bilder mit dem integrierten LaTeX
Befehle müssen in eine Grafikdatei wie gif oder png umgewandelt und dann eingebunden werden
mit \includegraphics. Der Schalter -a, bewirkt tth um eine automatische Bildkonvertierung zu versuchen
Verwendung von latex2gif.
OPTIONAL
-a Versuchen Sie die automatische Konvertierung von Bildumgebungen. Standard weglassen.
-c Präfix-Header „Inhaltstyp: Text/HTML“ (für direktes Web-Serving).
-d Deaktiviere Definitionen mit begrenzten Argumenten. Standard aktivieren.
-e? epsfbox-Handhabung: -e1 Konvertieren Sie die Figur mit dem vom Benutzer bereitgestellten ps2png/ps2gif in png/gif.
-e2 konvertieren und inline einbinden. -e3 wie e2 jedoch mit Symbol. -e0 (Standard) nein
Umbau, nur ref.
-f? legt die Gruppierungstiefe fest, bis zu der Brüche aufgebaut werden f5 (Default)
ermöglicht den Aufbau von fünf Ebenen, f0 keiner, f9 viele.
-g Erraten Sie kein HTML-Äquivalent für Schriftartdefinitionen, sondern entfernen Sie es einfach.
-h Drucken Sie etwas Hilfe. -? Drucknutzung
-i Verwenden Sie kursive Schriftarten für Gleichungen (wie TeX). Standard-Roman.
-J? Verwenden Sie die Indexseitenlänge ?. Standard 20 Zeilen. -j einzelne Spalte.
-LDatei erzählt tth die Basisdatei (keine Erweiterung) für die LaTeX-Hilfseingabe.
-N? Steuerung des HTML-Titelformats. 0 roh. 1 Makros erweitern. 2 Gleichungen erweitern.
-pPfad Geben Sie zusätzliche Verzeichnisse (Pfad) an, um nach Eingabedateien zu suchen.
-r Ausgabe von Roh-HTML (keine Präambel oder Nachspiel) zur Einbindung in anderes HTML.
-t erlauben aufgebaute Elemente in Textstilgleichungen. Nur standardmäßige Inline-Artikel.
-u Unicode-Zeichenkodierung. (Standard-ISO-8859-1).
-v einen ausführlichen Kommentar abgeben.
-V noch ausführlicher (zum Debuggen).
-w? HTML-Schreibstil. Standardmäßig keine Head/Body-Tags. -w -w0 kein Titel. -w1 Einzeltitel
nur Head/Body-Tags. -w2 XHTML.
-xmakindxcmd
Geben Sie eine nicht standardmäßige makeindex-Befehlszeile an.
-y? Gleichungsstil: Bit 1 vertikal komprimieren; Bit 2 Inline-Überakzente.
Nutzen Sie es online über die Dienste von onworks.net