t2html – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

t2html – Einfacher Text-zu-HTML-Konverter. Verlässt sich auf Texteinrückungsregeln.

ZUSAMMENFASSUNG

t2html [Optionen] file.txt > file.html

BESCHREIBUNG

Konvertieren Sie reine Textdateien in gut aussehende, möglicherweise gerahmte HTML-Seiten. Ein Beispiel für
Umwandlung:

1. Nur-Text-Quellcode
http://pm-doc.git.sourceforge.net/git/gitweb.cgi?p=pm-doc/pm-doc;a=blob_plain;f=doc/index.txt;hb=HEAD

2. Ergebnis der Konvertierung mit der benutzerdefinierten Option --css-file:
http://pm-doc.sourceforge.net/pm-tips.html
http://pm-doc.sourceforge.net/pm-tips.css

3. Ein Emacs-Modus tinytf.el zum Schreiben der Textdateien (optional)
https://savannah.nongnu.org/projects/emacs-tiny-tools

Voraussetzungen: für Varianten des Eingangssignals: ASCII Dateien

Die Datei muss im technischen Format verfasst sein, dessen Layout hier beschrieben wird
Handbuch. Im Grunde ist die Idee einfach und es gibt nur zwei Überschriftenebenen: eine in Spalte 0
und der andere in Spalte 4 (auf halbem Weg zwischen der Tabulatorbreite). Standardtext beginnt in der Spalte
8 (die Position nach gedrückter Tabulatortaste).

Die Idee des technischen Formats besteht darin, dass jede Spalte ein anderes Rendering-Layout darstellt
das generierte HTML. Da in der Textdatei kein spezielles Markup erforderlich ist, können Sie die verwenden
Textversion als Masterkopie einer FAQ usw. Aufzählungszeichen, nummerierte Listen, Worthervorhebung usw
Zitate usw. können auf natürliche Weise ausgedrückt werden.

HTML Beschreibung

Der generierte HTML-Code enthält eingebettetes Cascading Style Sheet 2 (CSS2) und einen kleinen Teil davon
Java-Code. Das CSS2 wird verwendet, um das Seitenlayout einzufärben und den geeigneten Druck zu definieren
Schriftgrößen. Das generierte HTML verfolgt auch einen Ansatz zur Unterstützung von XHTML. Siehe Seite
http://www.w3.org/TR/xhtml1/#guidelines wo die Abwärtskompatibilitätsempfehlungen sind
sind skizziert:

Legales HTML erfordert XHTML
..



XHTML unterstützt keine Fragment-IDs #foo mit dem „name“-Element, sondern verwendet „id“
stattdessen. Aus Gründen der Abwärtskompatibilität sind beide Elemente definiert:

< ..name="tag"> Ist jetzt <.. name="tag" id="tag">

HINWEIS: Dieses Programm wurde nie für die Verwendung für XHTML und die strenge XHTML-Gültigkeit entwickelt
ist nicht zu erwarten.

Motivation

Das einfachste Format zum Schreiben großer Dokumente wie FAQs ist Text. Eine Textdatei bietet
WysiWyg-Bearbeitung und einfache Umwandlung in das HTML-Format. Textdateien sind einfach
gepflegt und es sind keine speziellen Texteditoren erforderlich. Jeder Texteditor wie
Notepad, vi, Emacs können zur Pflege der Dokumente verwendet werden.

Textdateien sind auch das einzig sinnvolle Format, wenn Dokumente unter Versionskontrolle gehalten werden
wie RCS, CVS, SVN, Arch, Perforce, ClearCase. Sie können leicht mit diff und verglichen werden
Patches können problemlos empfangen und an sie gesendet werden.

Um die Verwaltung großer Dokumente zu erleichtern, gibt es auch eine Emacs Nebenmodus, Paket
namens tinytf.el, das Textschriftart mit Farben, Einrückungskontrolle und Aufzählungszeichen bietet
Ausfüllen, Neunummerierung von Überschriften, Wortauszeichnung, Syntaxhervorhebung usw. Siehe Projekt
http://freshmeat.net/projects/emacs-tiny-tools

OPTIONAL

HTML: Kopfzeile und Fußzeile Optionen
--wie es ist
Jede zusätzliche HTML-Formatierung oder Textmanipulation wird unterdrückt. Der Text bleibt unverändert erhalten
erscheint in der Datei. Verwenden Sie diese Option, wenn Sie planen, den Text wie angezeigt zu übermitteln oder auszudrucken.

o Wenn die Datei „Inhaltsverzeichnis“ enthält, wird sie nicht entfernt
o Der Inhaltsverzeichnisblock wird nicht erstellt (was normalerweise der Fall wäre).

--Autor -a STR
Autor des Dokuments, z. B --Autor "John Damhirschkuh"

--disclaimer-file FILE
Der in der Fußzeile angezeigte Text wird aus dieser Datei gelesen. Wenn nicht die Standardeinstellung angegeben ist
Copyright-Text wird hinzugefügt. Die Optionen „--quiet“ und „--simple“ unterdrücken Haftungsausschlüsse.

--dokumentieren FILE
Name des Dokuments oder Dateinamens. Sie könnten alle alternativen URLs zum Dokument auflisten
mit dieser Option.

--Email -e EMAIL
Die Kontaktadresse des Autors des Dokuments. Muss eine reine E-Mail-Adresse mit Nr. sein
„<“- und „>“-Zeichen enthalten. Z.B. --Email [E-Mail geschützt]

--Email "[E-Mail geschützt] >" FALSCH
--Email "[E-Mail geschützt] " Rechts

--einfach -s
Drucken Sie nur die Mindestfußzeile aus: Kontakt, E-Mail und Datum. Verwenden Sie „--quiet“, um vollständig zu sein
Fußzeile verwerfen.

--t2html-tags
Verarbeitung von eingebettetem #T2HTML zulassen- Anweisungen innerhalb der Datei. Siehe vollständige Erklärung
durch Lesen des Themas „EINGEBETTETE RICHTLINIEN IM TEXT“. Standardmäßig ist dies nicht erforderlich
Geben Sie diese Option an – sie ist standardmäßig aktiviert.

Um eingebettete Anweisungen in einer Textdatei zu ignorieren, geben Sie die Option „Nein“ an: --not2html-tags.

--Titel STR -t STR
Der Titeltext, der im oberen Rahmen des Browsers angezeigt wird.

- URL URL

Speicherort der HTML-Datei. Wann --dokumentieren gab den Namen, dies gibt den Ort an. Das
Informationen werden in der Fußzeile gedruckt.

HTML: Menü urls
--Base URL
URL-Speicherort der HTML-Datei im Reiseziel am Standort wo es zur Verfügung gestellt wird.
Diese Option ist nur erforderlich, wenn das Dokument auf einem FTP-Server gehostet wird (selten, aber
möglich). Ein auf einem FTP-Server basierendes Dokument kann keine Links zum Inhaltsverzeichnis (Fragment) verwenden
#Etikett Bezeichner), es sei denn, das HTML-Tag BASE ist ebenfalls definiert.

Das Argument kann eine vollständige URL zum Dokument sein:

--Base ftp://ftp.example.com/file.html
--Base ftp://ftp.example.com/

--button-heading-top
Zusätzliche hinzufügen [toc] Klicken Sie auf die Navigationsschaltfläche am Ende jeder Überschrift. Dies kann nützlich sein
in langen, nicht gerahmten HTML-Dateien.

--button-top URL
Die Schaltflächen werden oben im Dokument in der folgenden Reihenfolge platziert: [vorheriges][oben][nächstes] und
--Taste-* Optionen definieren die URLs.

Wenn die URL eine Zeichenfolge ist keine dann wird kein Button eingefügt. Dies kann praktisch sein, wenn die Tasten vorhanden sind
durch ein separates Programm definiert. Und Beispiel mit Perl:

#!/ Usr / bin / perl

mein $top = "index.html"; # Standardeinstellungen festlegen
mein $prev = "none";
mein $next = "none";

# ... irgendwo kann $prev oder $next gesetzt werden, oder auch nicht

qx(t2html --button-top "$top" --button-prev "$prev" --button-next "$next" ...);

# Ende des Beispielprogramms

--button-prev URL
URL, um zum vorherigen Dokument oder zur vorherigen Zeichenfolge zu gelangen keine.

--button-next URL
URL, um zum nächsten Dokument oder zur nächsten Zeichenfolge zu gelangen keine.

--Hinweis tag=wert
Sie können beliebige benutzerdefinierte Referenzen (Tags) in den Text einfügen und diese auf einen beliebigen Wert erweitern lassen.
Diese Option kann mehrmals angegeben werden und jedes Vorkommen von TAG wird durch ersetzt
WERT. ZB wenn folgende Optionen gegeben sind:

--reference "#HOME-URL=http://www.example.com/dir"
--reference "#ARCHIVE-URL=http://www.example.com/dir/dir2"

Wenn im Text darauf verwiesen wird, enthält der generierte HTML-Code erweiterte erweiterte Werte. Ein
Beispieltext:

Die Homepage ist #HOME-URL/page.html und die Mirrot-Seite ist sie
#ARCHIVE-URL/page.html, wo Sie die neueste Version finden.

-R, --reference-separator STRING
Siehe oben. Zeichenfolge, die zum Teilen von TAG und VALUE verwendet wird. Der Standardwert ist das Gleichheitszeichen „=".

-T, --toc-url-print
Angezeigte URLs (aus Überschriften erstellt), die das Inhaltsverzeichnis (NAME) bilden
AHREF-Tags) in einem Dokument. Die Liste wird an stderr ausgegeben, damit sie angezeigt werden kann
getrennt:

% t2html --toc-url-print tmp.txt > file.html 2> toc-list.txt

Wo würden Sie das brauchen? Wenn Sie wissen möchten, welches Fragment für Ihre Datei identifiziert wird,
Sie benötigen die Namensliste.

http://www.example.com/myfile.html#fragment-identifier

HTML: Regelung CSS Generation (HTML Tabellen)
--css-code-bg
Diese Option beeinflusst, wie der Codeabschnitt (Spalte 12) gerendert wird. Normalerweise der Abschnitt
ist umgeben von a .. Codes, aber mit diesen Optionen noch etwas mehr
schicker wird verwendet. Der Code ist in a eingeschlossen ... und der Hintergrund
Die Farbe ist auf einen Grauton eingestellt.

--css-code-note „REGEXP“
Option --css-code-bg ist erforderlich, um diese Option zu aktivieren. Ein spezielles Wort, definiert mit
regexp (Standard ist „Hinweis:“) markiert Codeabschnitte speziell. Das „erste Wort“ ist
abgeglichen mit dem bereitgestellten Perl-Regexp.

Der bereitgestellte reguläre Ausdruck darf, ich wiederhole, keine übereinstimmenden Gruppenoperatoren enthalten.
Dies bedeutet einfach, dass gruppierende Klammern wie „(eins|zwei|drei)“ nicht zulässig sind.
Sie müssen die nicht gruppierenden Perl-Elemente wie „(?:eins|zwei|drei)“ verwenden. Bitte beziehen Sie sich auf Perl
Handbuchseite [perlre], wenn diese kurze Einführung nicht genug Aufschluss geben würde.

Mit diesen Optionen wird der Text in Spalte 12 nicht mit gerendert .. , der Text
erscheint wie normaler Text, jedoch mit einer Besonderheit. Die Hintergrundfarbe des Textes hat
wurde in ein dunkleres Grau geändert, um sich optisch vom Text abzuheben.

Ein Beispiel soll es verdeutlichen. Angenommen, Sie haben Optionen übergeben --css-code-bg und
--css-code-note='(?:Notice|Note):', der anwies, die ersten Absätze zu behandeln
Spalte 12 anders. So was:

Dies ist der reguläre Text, der irgendwo in Spalte 8 erscheint.
Dieser Absatz kann mehrere Textzeilen enthalten.

Hinweis: Hier ist der Sonderabschnitt, Spalte 12,
und das erste Wort in diesem Absatz ist „Hinweis:“.
Nur das macht diesen Absatz in Spalte 12 zu etwas Besonderem.

Jetzt müssen wir dem Benutzer etwas Code zeigen:

für ( i = 0; i++; i < 10 )
{
// Etwas in dieser Schleife tun
}

Eine Notiz, ein Text, der mit einem Sonderwort am Anfang geschrieben wurde, wie etwa „Hinweis:“, muss vollständig in eins passen
Vollständiger Absatz. Alle weiteren Absätze, die folgen, werden als Codeabschnitte gerendert. Wie
hier:

Dies ist der normale Text, der irgendwo erscheint
Dieser Absatz kann mehrere Textzeilen enthalten

Hinweis: Hier ist der Sonderabschnitt, Spalte 12,
und das erste Wort in diesem Absatz ist „Hinweis:“
was es besonders macht

Allerdings wird dieser Absatz NICHT speziell wiedergegeben
mehr. Nur der erste Absatz oben.

für ( i = 0; i++; i < 10 )
{
// Etwas in dieser Schleife tun
}

Als ob dies nicht genug wäre, gibt es einige spezielle Tabellensteuerungsdirektiven, die dies ermöglichen
Du kontrollierst das .. die um den Codeabschnitt in Spalte 12 herum platziert wird.
Hier einige Beispiele:

Hier ist Beispiel 1

#t2html::td:bgcolor=#F7F7DE

für ( i = 0; i++; i < 10 )
{
// Etwas in dieser Schleife tun
}

Hier ist Beispiel 2

#t2html::td:bgcolor=#F7F7DE:tableborder:1

für ( i = 0; i++; i < 10 )
{
// Etwas in dieser Schleife tun
}

Hier ist Beispiel 3

#t2html::td:bgcolor="#FFFFFF":tableclass:dashed

für ( i = 0; i++; i < 10 )
{
// Etwas in dieser Schleife tun
}

Hier ist Beispiel 4

#t2html::td:bgcolor="#FFFFFF":table:border=1_width=94%_border=0_cellpadding="10"_cellspacing="0"

für ( i = 0; i++; i < 10 )
{
// Etwas in dieser Schleife tun
}

Sieht kryptisch aus? Ich kann nicht anders und damit Sie vollständig verstehen, was
Damit diese Anweisungen funktionieren, müssen Sie verstehen, welche Elemente hinzugefügt werden können
Und Token. Die verfügbaren Attribute finden Sie in der HTML-Spezifikation. Hier ist
Einweisung, was Sie tun können:

Der Startbefehl lautet:

#t2html::
|
Danach folgen Attributpaare in der Form Schlüssel:Wert
und mehrere als key1:value1:key2:value2 ...

Die „Schlüssel:Wert“-Paare können sein:

td:ATTRIBUTE
|
Dies wird umgewandelt in

Tabelle:ATTRIBUTE
|
Dies wird umgewandelt in

In den ATTRIBUTEN dürfen keine Leerzeichen enthalten sein, da das „Erste Wort“ eins sein muss
zusammenhängendes Wort. Anstelle eines Leerzeichens kann auch ein Unterstrich verwendet werden:

Tabelle:border=1_width=94%
|
Interpretiert als

Es ist auch möglich, den Standard-CLASS-Stil mit dem Wort „tableclass“ zu ändern. In Ordnung
Damit die KLASSE nützlich ist, müssen ihre CSS-Definitionen entweder in der Standardeinstellung enthalten sein
Konfiguration oder aus einer externen Datei bereitgestellt werden. Siehe Option --Skriptdatei.

Tabellenklasse:Name
|
Interpretiert als

Es gibt beispielsweise einige Standardstile, die verwendet werden können:

1) Hier ist ein Beispiel für eine „gestrichelte“ Klasse

#t2html::tableclass:dashed

für ( i = 0; i++; i < 10 )
{
// Etwas in dieser Schleife tun
}

2) Hier ist ein Beispiel für die Klasse „solid“:

#t2html::tableclass:solid

für ( i = 0; i++; i < 10 )
{
// Etwas in dieser Schleife tun
}

Sie können jeden einzelnen Wert der Standardtabellendefinition ändern:



Um z. B. nur das Auffüllen von Wertzellen zu ändern, würden Sie sagen:

#t2html::table:tablecellpadding:2

Wenn Sie sich nicht sicher sind, worum es dabei ging, führen Sie einfach das Programm mit aus --test-page
und schauen Sie sich die Quelle und die generierten HTML-Dateien an. Das sollte mehr Seil bieten
experimentieren mit.

--css-Datei FILE
Enthalten Dies bezieht sich auf eine externe CSS-Stildefinitionsquelle. Diese Option
wird ignoriert, wenn --Skriptdatei Die Option wurde angegeben, da diese Option das Ganze importiert
Inhalt im HEAD-Tag. Diese Option kann mehrfach und im externen CSS erscheinen
Dateien werden in aufgelisteter Reihenfolge hinzugefügt.

--css-font-type CSS-DEFINITION
Legen Sie die Schriftartdefinition des BODY-Elements auf CSS-DEFINITION fest. Der verwendete Standardwert ist
normaler Satz, der in Zeitungen und Büchern verwendet wird:

--css-font-type='Schriftfamilie: „Times New Roman“, Serife;‘

--css-font-size CSS-DEFINITION
Stellen Sie die Schriftgröße des Body-Elements auf CSS-DEFINITION ein. Die Standardschriftgröße wird ausgedrückt
in Punkten:

--css-font-size="Schriftgröße: 12pt;"

HTML: Regelung Körper of Dokument
--löschen REGEXP
Löschen Sie Zeilen, die mit Perl REGEXP übereinstimmen. Dies ist nützlich, wenn Sie ein Dokumenttool verwenden
Verwendet Navigations-Tags in der Textdatei, die nicht in der generierten Datei angezeigt werden sollen
HTML.

--delete-email-headers
Löschen Sie E-Mail-Header am Anfang der Datei, bis zur ersten leeren Zeile, die beginnt
Körper. Wenn Sie Ihr Dokument für die Veröffentlichung von Usenet-Nachrichten bereithalten, kann es Folgendes enthalten:
Kopfzeilen und Text:

Aus: ...
Newsgruppen: ...
X-Sender-Info:
Zusammenfassung:

Textkörper

--nodelete-default
Verwenden Sie diese Option, um das standardmäßige Löschen von Text zu unterdrücken (das aktiviert ist).

Das Emacs-Paket „folding.el“ und vi können mit jedem Text oder jeder Programmiersprache verwendet werden
Platzieren Sie Textabschnitte zwischen Tags {{{ und †. Sie können solche Falten öffnen oder schließen.
Dadurch können große Dokumente ganz einfach geordnet und verwaltet werden. Für Emacs
Unterstützung, siehe. ftp://ftp.csd.uu.se/pub/users/andersl/beta/

Der Standardwert löscht diese Markierungen und die speziellen Kommentare „#_comment“, die dazu führen
Es ist möglich, eigene Notizen hinzuzufügen, die nicht in der generierten Ausgabe enthalten sind.

{{{ Abschnitt „Sicherheit“.

#_comment Stellen Sie sicher, dass Sie diesen Abschnitt überarbeiten
#_Kommentieren Sie die nächste Veröffentlichung

Die Sicherheit ist ein wichtiges Thema im Verwaltungsalltag...
Mehr Text ...

†

--html-body STR
Zusätzliche Attribute zum Hinzufügen zum HTML-Tag . Sie könnten beispielsweise die Sprache des definieren
Text mit --html-body LANG=en was einen HTML-Tag erzeugen würde Sehen
Abschnitt „SIEHE AUCH“ für ISO 639.

--html-column-beg="SPEC HTML-SPEC"
Die Standardinterpretation der Spalten 1,2,3 5,6,7,8,9,10,11,12 kann mit geändert werden
betteln und Ende Schalter. Die Spalten 0,4 und XNUMX können nicht geändert werden, da sie für reserviert sind
Überschriften. Hier einige Beispiele:

--html-column-beg="7quote "
--html-column-end="7quote "

--html-column-beg="10 class='column10'"
--html-column-end="10 "

--html-column-beg="quote "
--html-column-end="quote "

Hinweis: Sie können nur Angaben bis zur Spalte 12 machen. Wenn sich der Text hinter der Spalte befindet
12 wird es sozusagen in Spalte 12 interpretiert.

Zusätzlich zur Spaltennummer wird die SPEC kann auch eine der folgenden Zeichenfolgen sein

Geben Sie ein äquivalentes Wort-Markup an
------------------------------
Zitat „“
deutlich _
emp *
klein +
groß =
ref [] like: [Michael] verwies auf [rfc822]

Weitere verfügbare Spezifikationen
------------------------------
7quote Wenn Spalte 7 mit doppelten Anführungszeichen beginnt.

Die Stylesheet-Werte für jede Farbe finden Sie unter Klasse Attribut und Verwendung --Skriptdatei
Option zum Importieren von Definitionen. Normalerweise listet /usr/lib/X11/rgb.txt mögliche Farbwerte auf
und der HTML-Standard unter http://www.w3.org/ definiert folgende standardmäßig benannte Farben:

Schwarz #000000 Kastanienbraun #800000
Grün #008000 Marine #000080
Silber #C0C0C0 Rot #FF0000
Limette #00FF00 Blau #0000FF
Grau #808080 Lila #800080
Oliv #808000 Blaugrün #008080
Weiß #FFFFFF Fuchsia #FF00FF
Gelb #FFFF00 Aqua #00FFFF

--html-column-end="COL HTML-SPEC"
Weitere Informationen finden Sie auch in den --html-column-beg

--html-font GRÖßE
Definieren Sie die SCHRIFTGRÖSSE. Für Präsentationen kann es sinnvoll sein, eine größere Schriftgröße einzustellen.

-F, --html-frame [FRAME-PARAMS]
Wenn angegeben, werden drei separate HTML-Dateien generiert. Der linke Rahmen enthält
Das Inhaltsverzeichnis und der rechte Rahmen enthalten den restlichen Text. Der FRAME-PARAMETER kann beliebig sein
Parameter für das HTML-Tag FRAMESET. Der Standardwert ist „cols="25%,75%"“.

Dies zu verwenden impliziert --aus Option automatisch, da drei Dateien nicht gedruckt werden können
zu stdout.

Datei.html

--> file.html Die Frame-Datei, hier auf den Browser zeigen
file-toc.html Linker Frame (Navigation)
file-body.html Rechter Frame (Inhalt)

--Sprache ID
Verwenden Sie während der Sprach-ID eine zweistellige ISO-Kennung wie „en“ für Englisch
Generierung von HTML. Dies betrifft nur den Text, der dem Endbenutzer angezeigt wird, z. B. Text
"Inhaltsverzeichnis". Die Standardeinstellung ist „en“. Siehe Abschnitt „SIEHE AUCH“ für Standards
ISO 639 und ISO 3166 für ordnungsgemäße Codes.

Die ausgewählte Sprache ändert die internen Arrays des Programms auf zwei Arten: 1) Anstelle von
Standardmäßig wird als Überschrift „Inhaltsverzeichnis“ das entsprechende Äquivalent in der Landessprache verwendet 2)
Der Text „Bild“ unten eingebetteter fortlaufend nummerierter Bilder verwendet Natinal
gleichwertig.

Wenn Ihre Sprache nicht unterstützt wird, senden Sie bitte den Ausdruck für „Inhaltsverzeichnis“ und
Geben Sie das Wort „Bild“ in Ihrer Sprache an den Betreuer weiter.

--Skriptdatei FILE
Fügen Sie Java-Code ein, der vollständig sein muss aus Datei. Der Code ist
reintun jedes HTML.

Die --Skriptdatei ist eine allgemeine Möglichkeit, alles in das HEAD-Element zu importieren. Z.B. Wenn
Wenn Sie für alle separate Stildefinitionen beibehalten möchten, können Sie nur einen Zeiger importieren
zu einem Stylesheet. Sehen 14.3.2 Angeben extern Stil Blätter im HTML 4.0-Standard.

--Meta-Keywords STR
Meta-Keywords. Wird von Suchmaschinen verwendet. Trennen Sie Kwywords wie „AA, BB, CC“ durch
Kommas. Weitere Informationen finden Sie in der HTML 4.01-Spezifikation und im Thema „7.4.4 Metadaten“.
http://www.htmlhelp.com/reference/wilbur/ und

--meta-keywords „AA,BB,CC“

--meta-description STR
Meta-Beschreibung. Fügen Sie eine Beschreibungszeichenfolge ein, maximal 1000 Zeichen. Dies wird von verwendet
Suchmaschinen. Weitere Informationen finden Sie in der HTML 4.01-Spezifikation und im Thema „7.4.4 Metadaten“.

--name-uniq
Die ersten 1–4 Wörter aus der Überschrift werden für den HTML-Code verwendet Name Stichworte. Wie auch immer es ist
Es ist möglich, dass zwei gleiche Überschriften mit genau denselben 1–4 Wörtern beginnen. In diesen Fällen
Sie müssen diese Option aktivieren. Es werden die Zähler 00 - 999 anstelle der Wörter von verwendet
Überschriften zum Erstellen von HTML Name Verweise.

Bitte nutzen Sie diese Option nur in Notfällen, da es sich um eine Sprungsperre handelt Name

httpI://example.com/doc.html#header_name

ist praktischer als die Verwendung obskurer Referenzen

httpI://example.com/doc.html#11

Darüber hinaus ändert sich jedes Mal, wenn Sie eine neue Überschrift hinzufügen, die Nummer, während die symbolische
Der aus der Überschrift ausgewählte Name bleibt bestehen, solange Sie die Überschrift nicht ändern. Nachdenken über
Wohlergehen Ihrer Internetnutzer, die Ihre Seiten mit Lesezeichen versehen. Versuchen Sie, Überschriften zu erstellen, die nicht vorhanden sind
dieselben Themen und Sie benötigen diese Option nicht.

Dokument Wartung und Portion Job Befehle
-EIN, --automatische Erkennung
Datei nur konvertieren, wenn das Tag „#T2HTML-“ in der Datei gefunden wird. Diese Option ist praktisch, wenn Sie
Führen Sie einen Batch-Befehl aus, um alle Dateien in HTML zu konvertieren, aber nur, wenn sie wie HTML-Basis aussehen
Dateien:

finden . -name "*.txt" -type f \
-exec t2html --auto-detect --verbose --out {} \;

Der Befehl durchsucht alle *.txt-Dateien im aktuellen Verzeichnis und leitet sie weiter
Konvertierungsprogramm. Der --automatische Erkennung Konvertiert nur Dateien, die „#T2HTML-“ enthalten
Richtlinien. Andere Textdateien werden nicht konvertiert.

--link-check -l
Überprüfen Sie alle http- und FTP-Links. Dieses zu erhalten is vermutet zu be Lauf standalone Option
--ruhig hat eine besondere Bedeutung, wenn es mit der Linkprüfung verwendet wird.

Mit dieser Option können Sie Ihr Dokument regelmäßig validieren und tote Links entfernen bzw
Verschobene Links aktualisieren. Problematische Links werden ausgegeben stderr. Dieser Link-Check
Die Funktion ist nur verfügbar, wenn Sie die LWP-Webbibliothek installiert haben. Programm wird
Überprüfen Sie, ob Sie es zur Laufzeit haben.

Links, die groß sind, z. B. die übereinstimmen tar.gz .zip ... oder die Programme ausführen (Links mit
? Zeichen) werden ignoriert, da die bei der Überprüfung verwendete GET-Anfrage das Ganze zurückgeben würde
Inhalt des Links und es würde. zu teuer sein.

Ein Vorschlag: Wenn Sie binäre Links zu Ihren Dokumenten einfügen, fügen Sie diese mit Leerzeichen ein:

http://example.com/dir/dir/ Dateiname.tar.gz

Dann das Programm die Überprüfen Sie die http-Adressen. Benutzer können die Datei möglicherweise nicht abrufen
Mit einem Klick kann der Checker zumindest das Verzeichnis validieren. Wenn Sie nicht der Eigentümer von sind
Über den Link ist es auch möglich, dass die Datei einen neuen Versionsnamen hat
erschienen.

-L, --link-check-single
Drucken Sie die komprimierte Ausgabe in grep -n ähnliche Art und Weise DATEI:ZEILE:NACHRICHT

Diese Option verkettet den URL-Antworttext zu einer einzelnen Zeile, sodass Sie ihn anzeigen können
die Nachrichten in einer Zeile. Sie können dafür Programmiertools (wie Emacs Mx Compile) verwenden
kann die Standard-GREP-Syntax analysieren, um zu Stellen in Ihrem Dokument zu springen und das Problem zu beheben
Links später.

-Ö, --aus
Schreiben Sie generiertes HTML in eine Datei, die vom Eingabedateinamen abgeleitet ist.

--out --print /dir/file --> /dir/file.html
--out --print /dir/file.txt --> /dir/file.html
--out --print /dir/file.this.txt --> /dir/file.this.html

--link-cache CACHE_FILE
Wenn Links regelmäßig überprüft werden, wäre es ziemlich streng, jeden Link zu überprüfen
Jedes Mal ist das schon gelungen. Um Zeit bei der Linkprüfung zu sparen, wird das „OK“
Links können in einer separaten Datei zwischengespeichert werden. Wenn Sie das nächste Mal die Links überprüfen, ist der Cache vorhanden
geöffnet und es werden nur gefundene Links überprüft, die nicht im Cache waren. Das sollte
Verbessern Sie lange Suchen erheblich. Betrachten Sie dieses Beispiel, in dem sich jede Textdatei befindet
rekursiv überprüft.

$ t2html --link-check-single \
--quiet --link-cache ~tmp/link.cache \
`finden. -name "*.txt" -type f`

-Ö, --out-dir DIR
Like --aus, aber zerhacken Sie den Verzeichnisteil und schreiben Sie Ausgabedateien in DIR. Die folgende
würde die HTML-Datei im aktuellen Verzeichnis generieren:

--out-dir .

Wenn Sie über ein automatisiertes Tool zum Ausfüllen des Verzeichnisses verfügen, können Sie Word verwenden keine zu
Ignorieren Sie diese Option. Das Folgende ist ein No-Op, es wird keine Ausgabe in das Verzeichnis generiert
"keiner":

--out-dir keine

-P, --drucken
Dateinamen nach der HTML-Verarbeitung auf stdout ausgeben. Normalerweise gibt das Programm keine Dateinamen aus,
nur das generierte HTML.

% t2html --out --print page.txt

-> page.html

-P, --print-url
Dateinamen im URL-Format drucken. Dies ist nützlich, wenn Sie das Layout überprüfen möchten
sofort mit Ihrem Browser.

% t2html --out --print-url page.txt | xargs Luchs

-> Datei: /users/foo/txt/page.html

--Teilt REGEXP
Teilen Sie das Dokument in kleinere Teile auf, wenn REGEXP übereinstimmt. Split Befehle sind standalone,
Das bedeutet, dass es startet und endet. Für die Datei ist keine HTML-Konvertierung aktiviert.

Wenn REGEXP aus der Linie gefunden wird, ist es ein Startpunkt einer Teilung. ZB teilen
Entsprechend den Überschriften der obersten Ebene, die keine Nummerierung haben, würden Sie Folgendes verwenden:

--split '^[AZ]'

Den generierten Teilzahlen werden fortlaufende, dreistellige Zahlen hinzugefügt:

Dateiname.txt-NNN

Die Split-Funktion ist praktisch, wenn Sie aus jeder Überschrift Folien erstellen möchten: Zuerst
Teilen Sie das Dokument auf, konvertieren Sie dann jeden Teil in HTML und drucken Sie schließlich jeden Teil (Seite) aus.
separat an den Drucker weiterleiten.

-S1, --split1
Das ist eine Kurzform von --Teilt Befehl. Definieren Sie den regulären Ausdruck, um die Überschrift der obersten Ebene aufzuteilen.

-S2, --split2
Das ist eine Kurzform von --Teilt Befehl. Definieren Sie den regulären Ausdruck, um die Überschrift der zweiten Ebene aufzuteilen.

-SN, --split-named-files
Zusätzliche Direktive für Split-Befehle. Wenn Sie z. B. nach Überschriften aufteilen, verwenden Sie --split1,
Es wäre informativer, Dateinamen anhand der ersten paar Wörter zu generieren
der Überschriftenname. Angenommen, die Überschriftennamen, bei denen eine Aufteilung erfolgt, wären:

Programmrichtlinien
Schlussfolgerung

Dann wären die generierten Teildateinamen wie folgt.

DATEINAME-Programmrichtlinien
FILENAME-Schlussfolgerung

-X, --xhtml
Rendern Sie mit striktem XHTML. Das bedeutet nutzen , und Absätze verwenden .. .

„Hinweis: Diese Option ist experimentell. Siehe FEHLER.“

Weitere Anwendungsbereiche Optionen
--debuggen LEVEL
Aktivieren Sie das Debuggen mit positiver LEVEL-Nummer. Null bedeutet kein Debuggen.

--help -h
Hilfebildschirm drucken. Beendet das Programm.

--help-css
Verwendetes Standard-CSS drucken. Beendet das Programm. Sie können diese Ausgabe kopieren und ändern
weisen Sie an, Ihre eigenen mit zu verwenden --css-file=DATEI. Sie können die Option auch in Dateien einbetten
mit der Direktive „#T2HTML-OPTION“.

--help-html
Drucken Sie die Hilfe im HTML-Format. Beendet das Programm.

--Hilfe-Mann
Drucken Sie die Hilfeseite im Unix-Manpage-Format. Sie möchten diese Ausgabe als Feed verwenden Nroff -Mann
um es zu lesen. Beendet das Programm.

--test-page
Drucken Sie die Testseite aus: HTML und Beispieltextdatei, die die Funktionen demonstriert.

--Zeit
Die für die Bearbeitung der Datei aufgewendete Zeit in Standardausgabe drucken.

-in, - ausführlich [NIVEAU]
Drucken Sie ausführliche Nachrichten.

-Q, --ruhig
Es wird überhaupt keine Fußzeile gedruckt. Diese Option hat eine andere Bedeutung, wenn --link-check Option ist
aktiviert: Nur fehlerhafte Links drucken.

V, --Version
Informationen zur Programmversion drucken.

FORMAT BESCHREIBUNG

Das Programm konvertiert Textdateien in HTML. Die Grundidee besteht darin, sich auf die Einrückungsebene zu verlassen
Das verwendete Layout heißt „Technisches Format“ (TF), wobei nur minimale Konventionen verwendet werden
um kursiven, fetten usw. Text zu markieren. Die Grundprinzipien können im Folgenden demonstriert werden. Beachten
Das Säulen-Poisiton-Lineal oben:

--//-- Beschreibungsanfang

123456789 123456789 123456789 123456789 123456789 Spaltennummern

Überschrift 1 beginnt mit einem großen Buchstaben in Spalte 1 ganz links

Die Spaltenpositionen 1,2,3 sind derzeit undefiniert und möglicherweise nicht definiert
richtig formatieren. Platzieren Sie keinen Text in den Spalten 1,2, 3 oder XNUMX.

Überschriftsebene 2 beginnt bei Halbtabulatorspalte 4 mit einem großen Buchstaben

Normaler, aber farbiger Text in Spalte 5

Normaler, aber farbiger Text in Spalte 6

Überschrift 3 kann an Position TAB minus 1, Spalte 7 berücksichtigt werden.

„Spezieller Text in Spalte 7 beginnt mit doppelten Anführungszeichen“

Standardtext beginnt in Spalte 8, Sie können den Text *hervorheben* oder
Machen Sie es _stark_ und schreiben Sie =SmallText= oder +BigText+ show
Variablenname „ThisIsAlsoVariable“. Sie können „das“ `_*verschachteln*_'
Markup. mehr txt in diesem Absatz txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt txt
txt txt

Starker Text in Spalte 9

Spalte 10 ist für Zitate reserviert
Spalte 10 ist für Zitate reserviert
Spalte 10 ist für Zitate reserviert
Spalte 10 ist für Zitate reserviert

Starker Text in Spalte 11

Spalte 12 und weitere sind für Codebeispiele reserviert
Spalte 12 und weitere sind für Codebeispiele reserviert
Alle Texte hier sind von umgeben HTML-Codes
Diese CODE-Spalte ist von den Optionen --css-code* betroffen.

Nochmals Überschrift 2 in Spalte 4

Wenn Sie so etwas wie Überschriftenebene 3 wünschen, verwenden Sie Spalte 7 (fett).

Spalte 8. Standard-Tab-Position. txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt
[1998-09-10 Herr Foo sagte]:

zitierter Text zitierter Text zitierter Text zitierter Text zitierter Text
zitierter Text zitierter Text zitierter Text zitierter Text zitierter Text
zitierter Text zitierter Text zitierter Text zitierter Text zitierter Text
Text zitierter Text

* Aufzählungszeichen in Spalte 8. Beachten Sie die drei Leerzeichen nach (*), also
Der Text beginnt mit einem halben Tabulator vorwärts in Spalte 12.
* Kugel. txt txt txt txt txt txt txt txt txt txt txt txt
* Kugel. txt txt txt txt txt txt txt txt txt txt txt txt
,txt txt txt txt

Beachten Sie, dass der vorherige Absatz mit einem P-Komma endet
Code weist diesen Absatz an, mit ihm fortzufahren
Bullet-Modus, ansonsten dieser Text in Spalte 12
würde als umgebender Codeabschnitt interpretiert werden
von HTML-Codes.

. Dies ist eine geordnete Liste.
. Dies ist eine geordnete Liste.
. Dies ist eine geordnete Liste.

.Diese Zeile beginnt mit einem Punkt und wird einzeln in einer Zeile angezeigt.
.Diese Zeile beginnt mit einem Punkt und wird einzeln in einer Zeile angezeigt.

!! Dies fügt eine hinzu HTML-Code, Text in der Zeile ist mit markiert
!!

Machen Sie diese E-Mail-Adresse anklickbar[E-Mail geschützt] > Nicht
Machen Sie diese E-Mail-Adresse anklickbar [E-Mail geschützt] , weil es
ist nur ein Beispiel und keine echte Adresse. Beachten Sie, dass die
Das letzte war nicht von <> umgeben. Gängige Anmeldenamen wie
foo, bar, quux oder Internetseite „example“ werden ignoriert
automatisch.

Auch nicht machen [E-Mail geschützt] > weil es mehr gibt
Leerraum. Dies ist möglicherweise eine bequemere Möglichkeit, E-Mails zu deaktivieren
Adressen vorübergehend.

Überschrift1 wieder in Spalte 0

Zwischenüberschrift in Spalte 4

Und normaler Text, Spalte 8 txt txt txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt

--//-- Ende der Beschreibung

Das ist alles, da ist das gesamte Layout beschrieben. Formeller sind die Textregeln
Die Formatierung ist unten beschrieben.

BENUTZT Überschriften
· Es sind nur XNUMX Überschriftenebenen in diesem Stil. Überschriftenspalten sind 0 und 4 und die
Die Überschrift muss mit einem großen Buchstaben oder einer Zahl beginnen

· Wenn der Text in Spalte 4 mit einem Kleinbuchstaben beginnt, wird diese Zeile als interpretiert


· Ein HTML Die Markierung wird direkt vor dem Drucken der Überschrift auf Ebene 1 hinzugefügt.

· Die Überschriften werden gesammelt, das Inhaltsverzeichnis erstellt und am Anfang des HTML eingefügt
Seite. Der HTML Im Inhaltsverzeichnis verwendete Referenzen sind die ersten 4 aufeinanderfolgenden Wörter aus dem
Überschriften. Stellen Sie sicher, dass Ihre Überschriften eindeutig benannt sind, da sonst dieselben vorhanden sind
NAME-Referenzen im generierten HTML. Leerzeichen werden in Unterstriche umgewandelt, wenn
die Worte verbinden. Wenn Sie keine eindeutigen Überschriften mit vier Wörtern schreiben können, müssen Sie dies tun
- --name-uniq wechseln

TEXT INVESTMENT REGELN

Allgemein
Die Grundregeln für die Positionierung von Text in bestimmten Spalten:

· Text in Spalte 0 ist undefiniert, wenn er nicht mit einem großen Buchstaben oder einer Zahl beginnt
Geben Sie die Überschriftenebene 1 an.

· Text zwischen den Spalten 1-3 ist mit gekennzeichnet

· Spalte 4 ist für die Überschriftenebene 2 reserviert

· Text zwischen den Spalten 5-7 ist mit gekennzeichnet

· Text in Spalte 7 ist , wenn das erste Zeichen ein doppeltes Anführungszeichen ist.

· Spalte 10 ist für Text reserviert. Wenn Sie jemanden zitieren oder eine Referenz hinzufügen möchten
Text, platzieren Sie den Text in dieser Spalte.

· Texte in den Spalten 9,11 und XNUMX sind mit gekennzeichnet

Spalte 8 für Text und Sondercodes

· Spalte 8 ist für normalen Text reserviert

· Am Anfang des Textes, in Spalte 8, kann ein DOT-Code oder ein COMMA-Code stehen.

Spalte 12 ist etwas Besonderes

· Spalte 12 wird speziell behandelt: Block wird mit gestartet und Zeilen sind mit markiert
. Wenn der letzte Text bei Überblick 12 gefunden wird, wird der Block mit geschlossen
Beachten Sie folgendes Beispiel

txt txt txt ;gleichmäßig platzierter Block, gut, mach es so
txt txt

txt txt txt txt ;Kann /pre nicht beenden, da zuletzt
txt txt txt txt ;Spalte ist nicht bei 12
txt txt txt txt

txt txt txt txt
txt txt txt txt
txt txt txt txt
;; Kommentar abschließen, jetzt ist der Text gleichmäßig platziert

Zusätzliche Token für - at Überblick 8
· Wenn am Anfang einer Zeile ein „.“(Punkt) und unmittelbar kein Leerzeichen steht, dann
Code wird am Ende der Zeile hinzugefügt.

.Diese Zeile wird ein haben HTML-Tag am Ende.
Während diese beiden Linien miteinander verbunden sind
vom Browser abhängig von der Rahmenbreite.

· Wenn es ein ","(Komma) gibt, dann das Code wird nicht eingefügt, wenn die vorherige Zeile vorhanden ist
leer. Wenn Sie sowohl „.“(Punkt) als auch „","(Komma) verwenden, müssen sie in der Reihenfolge Punkt-Komma angegeben werden. Der
","(Komma) funktioniert anders, wenn es in Aufzählungszeichen verwendet wird

A wird immer hinzugefügt, wenn Absätze getrennt sind, aber wenn Sie einen schreiben
Aufzählungszeichen gibt es ein Problem, da Aufzählungszeichen nur so lange existieren, wie der Text erhalten bleibt
gemeinsam

* Dies ist ein Aufzählungszeichen, bei dem der gesamte Text zusammengehalten wird
auch wenn sich im Aufzählungspunkt eine weitere Zeile befindet.

Aber um Aufzählungszeichen zu schreiben, die sich über mehrere Absätze verteilen, müssen Sie anweisen, dass dies der Fall ist
zusammenzuhalten und der Text im nächsten Absatz nicht während es platziert ist
Spalte 12

* Dies ist ein Aufzählungszeichen, bei dem der gesamte Text zusammengehalten wird
,auch wenn sich im Aufzählungspunkt eine weitere Zeile befindet.

Dies ist ein neuer Absatz zum vorherigen Aufzählungspunkt und das ist
kein Textbeispiel. Siehe Fortsetzung des COMMA-Codes oben.

* Dies ist eine neue Kugel

// und das ist ein Codebeispiel nach dem Aufzählungszeichen
if ( $flag ) { ..etwas tun.. }

Spezial Text Zeichnung
kursiv, fett, Code, kleine, große Token
_this_ wird als this interpretiert
*this* wird als this interpretiert
„dies“ wird interpretiert als Das `

Zusätzliche Modifikatoren, die mit den oben genannten gemischt werden können. Wenn Sie normalerweise eine größere Schriftart wünschen,
Schreiben Sie die Wörter groß.

=this= wird als this interpretiert
+this+ wird als this interpretiert
[dies] wird als dies interpretiert

hochstellend
Wort[dies] wird als hochgestellt interpretiert. Sie können „Gefällt mir“ verwenden
this[1], multiple[(2)] und fast alle[(ab)] und
vorstellbar[IV superscritps] so lang wie links
Dem Wort wird eine Klammer angehängt.

abonnieren
12[[10]] ist die Darstellung des Wertes 12 zur Basis 10.
Dies wird als Index interpretiert. Sie können „Gefällt mir“ verwenden
this[[1]], multiple[[(2)]] und fast alle[[(ab)]] und
vorstellbar[[IV superscritps]] solange noch *zwei* übrig sind
Klammern werden an das Wort angehängt.

Einbettung von Standard-HTML-Tokens
Standardmäßige spezielle HTML-Entitäten können auf normale Weise in den Text eingefügt werden, entweder mit
sybolische Namen oder der Hash-Code. Hier sind Beispiele:

× < > ≤ ≥ ≠ √ −
α β γ ÷
« » ‹ › - – —
≈ ≡ ∑ ƒ ∞
° ±
™ © ®
€ £ ¥

Einbetten von REINEM HTML in Text
Dieses -Funktion is hoch experimentell. Es ist möglich, reines HTML in Text einzubetten
Gelegenheiten, bei denen beispielsweise eine spezielle Formatierung erforderlich ist. Die Idee ist einfach: Sie schreiben
HTML wie gewohnt, aber alle „<“- und „>“-Zeichen verdoppeln, wie zum Beispiel:

< >

Die andere Regel ist, dass alles PURE HTML zusammengehalten werden muss. Es darf keine Linie sein
Pausen zwischen reinen HTML-Zeilen. Das ist falsch:

<

< >eins
< >zwei

< >

Das reine HTML muss ohne zusätzliche Zeilenumbrüche geschrieben werden:

<
< >eins
< >zwei
< >

Diese „Verdoppelung“ wirkt sich auch auf normale Textschreibregeln aus. Wenn Sie Dokumente schreiben,
Wenn Sie HERE-Dokumente im Unix-Stil beschreiben, DÜRFEN Sie die Token NICHT daneben platzieren
gegenseitig:

bash$ cat<
dank One
EOF

Sie müssen das obige Codebeispiel mit Leerzeichen schreiben, um zu verhindern, dass „<<“ interpretiert wird
als REINES HTML:

bash$ cat << EOF # RECHTS, Leerzeichen hinzufügen
dank One
EOF

Zeichnen eines kurzen Trennzeichens
A !! (zwei Ausrufezeichen) in der Textspalte (Position 8) führt zum sofortigen Hinzufügen
Code. irgendein Text danach!! in der gleichen Zeile wird mit geschrieben und eingefügt
direkt im Anschluss Code, daher haben die Wortformatierungsbefehle hier keine Auswirkung
Linie.

Http und E-Mail Markierung Smartgeräte App
· Alle http- und FTP-Referenzen sowie[E-Mail geschützt] > E-Mail-Adressen sind markiert
anklickbar. Um erkannt zu werden, muss die E-Mail umgebende <>-Zeichen enthalten.

· Wenn der URL ein Bindestrich vorangestellt ist, ist sie nicht anklickbar. Wenn eine Zeichenfolge foo, bar, quux,
Test, Website wird über die URL gefunden, dann wird sie nicht als anklickbar gezählt.

<[E-Mail geschützt] > anklickbar
http://example.com klickbar

< [E-Mail geschützt] > nicht anklickbar; enthält Leerzeichen
<5dko56$[E-Mail geschützt] > Nachrichten-ID, nicht anklickbar

-http://example.com Bindestrich, nicht anklickbar
http://$EXAMPLE variable. not clickable

Listen und Kugeln
· Die Bulletin-Tabelle wird erstellt, wenn in Spalte 8 ein „o“ oder ein „*“ und drei Leerzeichen dahinter stehen
es, sodass der Text in Spalte 12 beginnt. Es wird empfohlen, Zeilen mit Aufzählungszeichen zusammenzuhalten;
Keine Leerzeichen zwischen Aufzählungsblöcken.

· Die geordnete Liste beginnt mit „.“, einem Punkt, und wird wie ein Aufzählungszeichen an der Stelle geschrieben, an der der Text beginnt
in Spalte 12.

Line geht kaputt
· Alle Zeilenumbrüche sind in Ihrem Dokument sichtbar. Verwenden Sie nicht mehr als einen Zeilenumbruch
separate Absätze.

· Sehr wichtig ist, dass es nur gibt dank One Zeilenumbruch nach Überschriften.

EMBEDDED Richtlinien INSIDE TEXT

Befehlszeilenoptionen
Sie können die Befolgung aller eingebetteten Anweisungen abbrechen, indem Sie die Option angeben --not2html-tags.

Sie können diese Zeilen an einer beliebigen Stelle im Dokument einfügen und ihr Inhalt wird eingefügt
HTML-Ausgabe. Jede Direktivenzeile muss in eine Zeile passen und darf nicht umgebrochen werden
separate Zeilen.

#T2HTML-TITEL
#T2HTML-EMAIL
#T2HTML-AUTHOR
#T2HTML-DOC
#T2HTML-METAKEYWORDS
#T2HTML-METADESCRIPTION

Sie können in der Datei eingebettete Befehlszeilenoptionen übergeben. Als ob Sie den CODE wollten
Wenn Sie den Abschnitt (Spalte 12) mit einem Grauton einfärben möchten, können Sie Folgendes hinzufügen:

#T2HTML-OPTION --css-code-bg

Oder Sie können die Aktivierung bestimmter Optionen anfordern. Beachten Sie, dass jede Zeile genau ist
da Sie das Argument in der Befehlszeile übergeben haben. Stellen Sie sich vor, Sie umgeben doppelte Anführungszeichen
um Zeilen herum, die Argumente für die zugehörigen Optionen sind.

#T2HTML-OPTION – wie es ist
#T2HTML-OPTION --quiet
#T2HTML-OPTION --Sprache
#T2HTML-OPTION de
#T2HTML-OPTION --css-font-type
#T2HTML-OPTION Trebuchet MS
#T2HTML-OPTION --css-code-bg
#T2HTML-OPTION --css-code-note
#T2HTML-OPTION (?:Hinweis|Hinweis|Warnung):

Sie können auch eigene Kommentare in den Text einbetten. Diese werden entfernt:

#T2HTML-COMMENT Sie kommentieren hier
#T2HTML-COMMENT Hier ein weiterer Kommentar

Einbetten von Dateien
#INCLUDE-Befehl

Dies wird verwendet, um den Inhalt in die aktuelle Position einzubinden. Die URL kann eine sein
Dateinamenreferenz, wobei jedes $VAR durch die Umgebungsvariablen ersetzt wird. Der
Tilde(~)-Erweiterung wird nicht unterstützt. Der enthaltene Dateiname ist Betriebssystem
unterstützter Pfadstandort.

Ein Präfix „raw:“ deaktiviert jegliche normale Formatierung. Der Dateiinhalt ist unverändert enthalten.

Die URL kann auch ein HTTP-Verweis auf einen Remote-Standort sein, dessen Inhalt enthalten ist
am Punkt. Im Falle von Remote-Inhalten oder wenn der Dateiname mit der Erweiterung „.html“ endet oder
„.html“ wird der Inhalt entfernt, um die Einbindung des Inhalts zu ermöglichen
möglich. Im Bild unten sind nur die mit !! markierten Linien innerhalb des KÖRPERS zu sehen
inbegriffen:



...


Dieser Text !!
und mehr davon!!



Beispiele:

#INCLUDE-$HOME/lib/html/picture1.html
#ENTHALTEN-http://www.example.com/code.html
#INCLUDE-raw:example/code.html

Bilder einbetten
Der Befehl #PIC wird verwendet, um Bilder in den Text einzufügen

#PIC picture.png#Beschriftungstext#Bild-HTML-Attribute#align#
(1) (2) (3) (4)

1. Der NAME oder die URL-Adresse des Bildes. Like image/this.png

2. Der Text, der unter dem Bild erscheint

3. Zusätzliche Attribute, die im Inneren angehängt sind Etikett.
Für , würde die Linie
lesen:

#PIC some.png#Beschriftungstext#width=200 length=200##

4. Die Position des Bildes: „links“ (Standard), „Mitte“, „rechts“

Hinweis: Der „Beschriftungstext“ wird auch zum ALT-Text des Bildes, in dem verwendet wird
falls der Browser keine Bilder anzeigen kann. Sie können den ALT-Text unterdrücken
mit Option --no-picture-alt.

Fragmentbezeichner für benannte Tags
Der Befehl #REF wird zum Verweisen auf HTML verwendet Tag im aktuellen Dokument. Der
Der gesamte Befehl muss in einer einzigen Zeile stehen und kann nicht in mehrere aufgeteilt werden
Linien. Ein Beispiel:

#REF #how_to_profile;(Hinweis: Profilerstellung);
(1) (2)

1. Die NAME-HTML-Tag-Referenz im aktuellen Dokument, ein einzelnes Wort.
Dies kann auch ein vollständiger URL-Link sein.
Sie können die NAME-Liste abrufen, indem Sie die Option --toc-url-print aktivieren.

2. Der anklickbare Text wird durch ; begrenzt. Figuren.

Verweis auf externe Dokumente.
Mit dem Tag „#URL“ können URLs inline eingebettet werden, sodass der vollständige Link nicht sichtbar ist.
Für den Sprung zur URL wird nur der angezeigte Text verwendet. Diese Richtlinie kann nicht gebrochen werden
separate Zeilen,

#URL
| |
| Leerzeichen sind hier zulässig
Muss zusammengehalten werden

Als ob geschrieben wäre:

Siehe Suchmaschinen-#URLhttp://www.google.com>

TABELLE OF INHALT TARIF

Wenn es eine Überschrift 1 gibt, die genau „Inhaltsverzeichnis“ heißt, dann der gesamte Text bis
Die nächste Überschrift wird aus der generierten HTML-Datei verworfen. Dies geschieht aufgrund des Programms
generiert sein eigenes Inhaltsverzeichnis. Es wird davon ausgegangen, dass Sie dazu ein Textformatierungsprogramm verwenden
Generieren Sie das Inhaltsverzeichnis für Sie in einer TXT-Datei und pflegen Sie es nicht manuell. Zum Beispiel
Emacs-Paket tinytf.el kann verwendet werden.

FEHLERBEHEBUNG

HTML Dokument war nicht aussehen was I beabsichtigt
Der häufigste Fehler besteht darin, dass das Dokument zusätzliche Zeilenumbrüche enthält. Bleib dran dank One leer
Linie zwischen Überschriften und Text beibehalten dank One Leerzeile zwischen Absätzen, behalten dank One leer
Linie zwischen Fließtext und Aufzählungszeichen. Machen Sie es zu Ihrem Mantra: dank One dank One dank One ...

Als nächstes haben Sie möglicherweise Text an der falschen Spaltenposition platziert. Denken Sie daran, dass der reguläre Text at ist
Spalte 8.

Wenn generiertes HTML plötzlich nur noch eine Schriftart verwendet, z , dann hast du es vergessen
Schließen Sie den Block. Machen Sie es gleichmäßig, etwa so:

Codeblock
Codeblock
Codeblock
;; Fügen Sie hier einen leeren Kommentar hinzu, um das Codebeispiel in Spalte 12 zu „schließen“.

Überschriften beginnen mit einem großen Buchstaben oder einer großen Zahl, etwa „Überschrift“ und nicht „Überschrift“. Überprüfen
die Schreibweise.

Beispiele:

So drucken Sie die Testseite aus und zeigen alle Möglichkeiten:

t2html --test-page

So erstellen Sie eine einfache HTML-Seite ohne Metainformationen:

t2html --title "HTML-Seitentitel" --author "Mr. Foo" \
--simple --out --print file.txt

Wenn Sie regelmäßig Post im E-Mail-Format haben, verwenden Sie --delete-email-headers um den Header zu ignorieren
Text:

t2html --out --print --delete-email-headers page.txt

Um die Seite schnell zu machen

t2html --html-frame --out --print page.txt

Zum Konvertieren einer Seite aus einem Textdokument, einschließlich Meta-Tags, Schaltflächen, Farben und Rahmen. Zahlen
Aufmerksamkeit zu wechseln --html-body welches die Dokumentsprache definiert.

t2html \
--drucken \
--aus \
--author „Mr. foo“ \
--Email "[E-Mail geschützt] "\
--title „Dies ist die Handbuchseite der Seite BAR“ \
--html-body LANG=en \
--button-prev previous.html \
--button-top index.html \
--buttion-next next.html \
--dokumentieren http://example.com/dir/this-page.html \
--url Handbuch.html \
--css-code-bg \
--css-code-note '(?:Hinweis|Hinweis|Warnung):' \
--html-frame \
--disclaimer-file $HOME/txt/my-html-footer.txt \
--meta-keywords "Sprache-de,Handbuch,Programm" \
--meta-description „Barprogramm, um dies, das und noch mehr davon zu tun“ \
manual.txt

Um Links zu überprüfen und den Status aller Links entsprechend der HTTP-Fehlermeldung auszudrucken (die meisten
ausführlich):

t2html --link-check file.txt | tee link-error.log

Um nur problematische Links zu drucken:

t2html --link-check --quiet file.txt | tee link-error.log

So drucken Sie eine knappe Ausgabe in der Art von egep -n aus: Zeilennummer, Link und Fehlercode:

t2html --link-check-single --quiet file.txt | tee link-error.log

Um Links von mehreren Seiten zu überprüfen und gute Links in einer separaten Datei zwischenzuspeichern, verwenden Sie --link-cache
Möglichkeit. Die nächste Linkprüfung wird viel schneller ausgeführt, da gültige Links nicht zwischengespeichert werden
wieder geholt. Löschen Sie in regelmäßigen Abständen die Link-Cache-Datei, um eine vollständige Überprüfung zu erzwingen.

t2html --link-check-single \
--link-cache $HOME/tmp/link.cache \
--quiet file.txt

So teilen Sie ein großes Dokument in Teile auf und konvertieren jeden Teil in HTML:

t2html --split1 --split-name file.txt | t2html --simple --out

EMAIL
Wenn Umgebungsvariable EMAIL definiert ist, wird es in der Fußzeile für die Kontaktadresse verwendet.
Option --Email überschreibt die Umgebungseinstellung.

SPRACHE
Die Standard-Spracheinstellung für den Schalter „--Language“ stellen Sie sicher, dass die ersten beiden
Zeichen enthält die Sprachdefinition, wie in: LANG=en.iso88591

Nutzen Sie t2html online über die Dienste von onworks.net