hypertocp – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

hypertoc – generiert ein Inhaltsverzeichnis für HTML-Dokumente

VERSION

Version 3.20

ZUSAMMENFASSUNG

hypertoc --help | --manpage | --man_help | --Mann

hypertoc [--bak Schnur ] [ --debug ] [ --entrysep Schnur ] [ --Fusszeile Datei ] [ --Header
Datei ] [ --ignore_only_one ] [ --ignore_sole_first ] [ --inline ] [ --make_anchors ] [
--make_toc ] [ --notoc_match Schnur ] [ --ol | --nool ] [ --ol_num_levels ] [ --outfile
Datei ] [ --overwrite ] [ --quiet ] [ --textonly ] [ --title Schnur ] { --toc_after
tag=Suffix } { --toc_before tag=Präfix } { --toc_end tag=endtag } { --toc_entry tag=level
} [ --toc_label Schnur ] [ --toc_only | --notoc_only ] [ --toc_tag Schnur ] [
--toc_tag_replace ] [ --use_id ] [ --useorg ] Datei ...

BESCHREIBUNG

Mit Hypertoc können Sie „signifikante Elemente“ angeben, auf die in einem Hyperlink verwiesen wird
„Inhaltsverzeichnis“ (ToC) für einen bestimmten Satz von HTML-Dokumenten.

Im Grunde handelt es sich bei dem generierten ToC um eine mehrstufige Liste mit Links zu
wesentliche Elemente. hypertoc fügt die Links zu wichtigen Elementen unter a in das ToC ein
vom Benutzer angegebenen Niveau.

Beispiel:

Wenn H1s als Level 1 angegeben sind, erscheinen sie in der ersten Level-Liste des ToC. Wenn
H2s werden als Stufe 2 angegeben und erscheinen dann in einer Liste der zweiten Stufe im Inhaltsverzeichnis.

Es gibt zwei Aspekte bei der ToC-Generierung: (1) das Einfügen geeigneter Anker in den HTML-Code
Dokumente (--make_anchors) und (2) Generieren des Inhaltsverzeichnisses aus HTML-Dokumenten, die Folgendes haben
darin Anker, auf die das Inhaltsverzeichnis verweisen kann (--make_toc). Man kann wählen, ob man eines oder beides tun möchte
diese.

hypertoc unterstützt auch die Möglichkeit, das ToC in das HTML-Dokument selbst zu integrieren
über die Option --inline.

Damit Hypertoc die Verknüpfung mit wichtigen Elementen unterstützt, fügt Hypertoc Anker ein
in die wesentlichen Elemente. Man kann Hypertoc als Filter verwenden und das Ergebnis ausgeben
eine andere Datei, oder man kann die Originaldatei überschreiben, wobei das Original mit einer gesichert wird
Suffix (Standard: „org“) wird an den Dateinamen angehängt.

Man kann Optionen auch in einer Konfigurationsdatei sowie in der Befehlszeile definieren.

OPTIONAL

Optionen können mit „--“ oder „-“ beginnen; Boolesche Optionen können negiert werden, indem ihnen ein vorangestellt wird
"NEIN"; Optionen mit Hash- oder Array-Werten können hinzugefügt werden, indem die Option erneut angegeben wird
jeder Wert.

Weitere Informationen finden Sie unter Getopt::Long.

--argfile Dateinamen
Der Name einer Datei, aus der weitere Optionen gelesen werden sollen. Dies kann mehr als einmal verwendet werden. Für
Beispiel:

--argfile deine.args --argfile meine.args

Weitere Informationen finden Sie unter „Optionsdateien“.

--bak
--bak Schnur

Wenn die Eingabedatei(en) überschrieben wird/werden (--overwrite ist aktiviert), kopieren Sie die
Originaldatei nach „Dateinamen.Schnur". Wenn der Wert leer ist, gibt es keine Sicherungsdatei
geschrieben. (Standard:org)

--debuggen
Aktivieren Sie die ausführliche Debugging-Ausgabe. Wird zum Debuggen dieses Moduls verwendet. mit anderen Worten,
Mach dir keine Sorgen. (Standard: aus)

--entrysep
--entrysep Schnur

Trennzeichenfolge für Nicht- Artikeleinträge (Standard: ", ")

--Fusszeile
--Fusszeile Datei

Datei mit Fußzeilentext für das Inhaltsverzeichnis.

--Header
--Header Datei

Datei mit Kopfzeilentext für das Inhaltsverzeichnis.

--help
Drucken Sie eine kurze Hilfenachricht und beenden Sie das Programm.

--ignore_only_one
Wenn das ToC nur ein Element enthält, erstellen Sie kein ToC.

--ignore_sole_first
Wenn das erste Element im Inhaltsverzeichnis von der höchsten Ebene ist UND es das einzige davon ist
Ebene, ignoriere es. Dies ist nützlich bei Webseiten, die nur einen H1-Header haben
Ob es nur einen geben wird, weiß man vorher nicht.

--im Einklang
Fügen Sie die ToC an einer bestimmten Stelle in das Dokument ein. Weitere Informationen finden Sie unter „Inlining des ToC“.

--make_anchors | --gen_anchors
Erstellen Sie Anker für das Inhaltsverzeichnis, auf die verlinkt werden soll.

--make_toc | --gen_toc
Erstellen Sie ein Inhaltsverzeichnis, das auf verankerte wichtige Elemente verweist.

--man_help | --manpage | --Mann
Drucken Sie die gesamte Dokumentation aus und beenden Sie den Vorgang.

--notoc_match
--notoc_match Schnur

Wenn es bestimmte einzelne Tags gibt, die Sie nicht in die Tabelle aufnehmen möchten
Inhalte, auch wenn sie mit den „signifikanten Elementen“ übereinstimmen, dann liegt dieses Muster vor
mit Inhalten innerhalb des Tags übereinstimmt (nicht mit dem Text), dann wird dieses Tag nicht eingefügt.
weder bei der Generierung von Ankern noch bei der Generierung des ToC. (Standard: class="notoc")

--ol | --nein
Verwenden Sie eine geordnete Liste für Inhaltsverzeichniseinträge (bis zu einer bestimmten Tiefe). Wenn --ol ist
false (dh --nool ist gesetzt) ​​dann nicht Verwenden Sie eine geordnete Liste für ToC-Einträge.

(Standard:false)

(Siehe --ol_num_levels, um zu bestimmen, wie tief die Auflistung der geordneten Liste geht)

--ol_num_levels
Die Anzahl der Ebenen, in die die OL-Liste geht, wenn --ol wahr ist. Wenn auf Null gesetzt,
wird eine geordnete Liste für alle Ebenen verwenden. (Standard:1)

--outfile
--outfile Datei

Datei, in die die Ausgabe geschrieben werden soll. Hier werden die geänderte HTML-Ausgabe und das Table-of-
Inhalt geht an. Wenn Sie „-“ als Dateinamen angeben, erfolgt die Ausgabe an STDOUT.
(Standard: STDOUT)

--überschreiben
Überschreiben Sie die Eingabedatei mit der Ausgabe. Wenn dies wirksam ist, wird --outfile ignoriert.
Benutzt in generieren_anker zum Erstellen der Anker „an Ort und Stelle“ und in generieren_toc if
Die Option --inline ist wirksam. (Standard: aus)

--ruhig
Unterdrücken Sie informative Nachrichten. (Standard: aus)

--nur Text
Verwenden Sie in wesentlichen Elementen nur Textinhalte.

--Titel
--Titel Schnur

Titel für die ToC-Seite (wenn nicht --header oder --inline oder --toc_only verwendet wird) (Standard: „Table
des Inhalts")

--toc_after
--toc_after Etikett=Suffix

--toc_after "H2= "

Zum Definieren des Layouts wichtiger Elemente im ToC. Der Etikett ist das HTML-Tag which
markiert den Anfang des Elements. Der Suffix ist das, was angehängt werden muss
Für dieses Tag generierter Inhaltsverzeichniseintrag. Dies ist ein kumulatives Hash-Argument.
(Standard: undefiniert)

--toc_before
--toc_before Etikett=Präfix

--toc_before "H2= "

Zum Definieren des Layouts wichtiger Elemente im ToC. Der Etikett ist das HTML-Tag
was den Anfang des Elements markiert. Der Präfix ist das, was vorangestellt werden muss
zum Inhaltsverzeichniseintrag, der für dieses Tag generiert wurde. Dies ist ein kumulativer Hash
Streit. (Standard: undefiniert)

--toc_end
--toc_end Etikett=Endtag

--toc_end "H1=/H1"

Zur Definition wesentlicher Elemente. Der Etikett ist das HTML-Tag, das den Anfang von markiert
das Element. Der Endtag das HTML-Tag, das das Ende des Elements markiert. Wenn
Bei Übereinstimmung in der Eingabedatei wird die Groß-/Kleinschreibung ignoriert (stellen Sie jedoch sicher, dass alle Ihre Etikett Optionen
sich auf dasselbe Tag beziehen, sind genau gleich!). Dies ist ein kumulatives Hash-Argument.
(Standard: H1=/H1 H2=/H2)

--toc_entry
--toc_entry Etikett=Grad des

--toc_entry "TITLE=1" --toc_entry "H1=2"

Zur Definition wesentlicher Elemente. Der Etikett ist das HTML-Tag, das den Anfang von markiert
das Element. Der Grad des ist die Ebene, auf der das Tag liegt. Der Wert von Grad des
muss numerisch und ungleich Null sein. Wenn der Wert negativ ist, aufeinanderfolgende Einträge
Das durch das signifikante_Element dargestellte Element wird durch den durch gesetzten Wert getrennt
--entrysep-Option. Dies ist ein kumulatives Hash-Argument. (Standard: H1=1 H2=2)

--toc_label | --toclabel
--toc_label Schnur

HTML-Text, der das Inhaltsverzeichnis beschriftet. Immer benutzt. (Standard: " Inhaltsverzeichnis ")

--toc_only | --notoc_only
Geben Sie nur das Inhaltsverzeichnis aus, also das Inhaltsverzeichnis plus toc_label.
Wenn ein --header oder ein --footer vorhanden ist, werden diese ebenfalls ausgegeben.

Wenn --toc_only falsch ist (dh --notoc_only ist gesetzt), dann, wenn kein --header vorhanden ist, und
--inline ist nicht wahr, dann wird ein passender HTML-Seitenheader ausgegeben, und wenn ja, wird ein passender HTML-Seitenheader ausgegeben
Nein --footer und --inline ist nicht wahr, dann wird ein HTML-Seitenfuß ausgegeben.
(Standard:--notoc_only)

--toc_tag
--toc_tag Schnur

Wenn ein Inhaltsverzeichnis inline eingebunden werden soll, ist dies das Muster, das zum Abgleich des Tags verwendet wird
wo das ToC abgelegt werden soll. Dies kann ein Start-Tag, ein End-Tag oder ein Kommentar sein, aber
das < sollte weggelassen werden; Das heißt, wenn Sie möchten, dass das ToC nach dem BODY platziert wird
Tag, dann gib „BODY“ an. Wenn Sie ein spezielles Kommentar-Tag an der Stelle des Inhaltsverzeichnisses einfügen möchten
go, fügen Sie dann die Kommentarzeichen ein, zum Beispiel: „!--toc--“ (Standard: BODY)

--toc_tag_replace
In Verbindung mit --toc_tag ist dies ein Flag, das angibt, ob das angegebene Tag vorhanden sein soll
ersetzt werden soll oder ob das ToC nach dem Tag stehen soll. Dies kann nützlich sein, wenn Sie
toc_tag ist ein Kommentar und Sie benötigen ihn nicht mehr, nachdem Sie das ToC erstellt haben.
(Standard:false)

--use_id
Verwenden Sie id="Name" für Anker stattName"> Anker. Allerdings wenn ein Anker
für ein signifikantes Element bereits vorhanden ist, wird dadurch keine ID für dieses bestimmte Element erstellt
Element.

--useorg
Verwenden Sie bereits vorhandene Sicherungsdateien als Eingabequelle. das heißt, Dateien des Formulars
Dateinamen.bak (siehe --bak).

FILE FORMATEN

Optionen Mappen
Optionen können sowohl in Dateien als auch in der Befehlszeile mithilfe von --argfile angegeben werden
Dateinamen Option in der Befehlszeile. Auch die Dateien ~/.hypertocrc und ./.hypertocrc sind
auf Optionen geprüft.

Das Format ist wie folgt: Zeilen, die mit # beginnen, sind Kommentare. In PoD eingeschlossene Zeilen
Markierungen sind auch Kommentare. Leerzeilen werden ignoriert. Die Optionen selbst sollten sein
gegeben, wie sie sich in der Befehlszeile befinden würden, d. h. der Optionsname (einschließlich
--), gefolgt von seinem Wert (falls vorhanden).

Beispielsweise:

# Stellen Sie das Inhaltsverzeichnis auf drei Ebenen ein
--toc_entry H1=1
--toc_entry H2=2
--toc_entry H3=3

--toc_end H1=/H1
--toc_end H2=/H2
--toc_end H3=/H3

Optionsdateien können verschachtelt werden, indem ein --argfile angegeben wird Dateinamen Argument innerhalb der Option
Datei, es wird auch die verwiesene Datei abrufen.

Weitere Informationen finden Sie unter Getopt::ArgvFile.

DETAILS

Signifikant verschiedenste Komponenten
Hier finden Sie einige Beispiele für die Definition der wesentlichen Elemente für Ihr Inhaltsverzeichnis.

Beispiel of Standard

Das Folgende spiegelt die Standardeinstellung wider, wenn nichts explizit angegeben wird:

--toc_entry "H1=1" --toc_end "H1=/H1" --toc_entry "H2=2" --toc_end "H2=/H2"

Oder, wenn es in einer der möglichen „Optionsdateien“ definiert wurde:

# Standardeinstellungen
--toc_entry H1=1
--toc_end H1=/H1
--toc_entry H2=2
--toc_end H2=/H2

Beispiel of vorher Nachher

Die folgenden Optionen nutzen die Vorher/Nachher-Optionen:

# Eine Optionsdatei, die einige Formatierungen hinzufügt
# ToC-Einträge der Ebene 1 erstellen
--toc_entry H1=1
--toc_end H1=/H1
--toc_before H1=
--toc_after H1=

# ToC-Einträge der Stufe 2 erstellen
--toc_entry H2=2
--toc_end H2=/H2
--toc_before H2=
--toc_after H2=

# Nehmen Sie Einträge der Ebene 3 unverändert vor
--toc_entry H3=3
--toc_end H3=/H3

Beispiel of Original Ende

Die folgenden Optionen versuchen, Definitionsbegriffe zu indizieren:

# Eine Optionsdatei, die für Dokumente vom Typ Glossar verwendet werden kann
--toc_entry H1=1
--toc_end H1=/H1
--toc_entry H2=2
--toc_end H2=/H2

# Geht davon aus, dass das Dokument für jedes DT ein DD hat, andernfalls ToC
# erhält Einträge mit viel Text.
--toc_entry DT=3
--toc_end DT=DD
--toc_before DT=
--toc_after DT=

Formatierung: Inhaltsverzeichnis
Die Optionen --toc_entry usw. geben Ihnen die Kontrolle darüber, wie die ToC-Einträge aussehen könnten, aber da
Es gibt weitere Optionen, die das endgültige Erscheinungsbild der erstellten ToC-Datei beeinflussen.

Mit der Option --header wird der Inhalt der angegebenen Datei vorangestellt
generiertes ToC. Auf diese Weise können Sie einen Einführungstext oder einen anderen Text vor dem einfügen
Inhaltsverzeichnis.

Hinweis:
Wenn Sie die Option --header verwenden, stellen Sie sicher, dass die angegebene Datei den öffnenden HTML-Code enthält
Tag, das HEAD-Element (das das TITLE-Element enthält) und das öffnende BODY-Tag.
Diese Tags/Elemente sollten jedoch nicht in der Header-Datei enthalten sein, wenn die Optionen --inline verwendet werden
wird eingesetzt. Informationen darüber, was die Header-Datei enthalten sollte, finden Sie unter „Inlining des Inhaltsverzeichnisses“.
zum Inlining des ToC.

Mit der Option --toc_label wird der Inhalt der angegebenen Zeichenfolge vorangestellt
generiertes Inhaltsverzeichnis (aber nach jedem Text, der aus einer --header-Datei entnommen wurde).

Mit der Option --footer wird der Inhalt der Datei nach der Generierung angehängt
Inhaltsverzeichnis.

Hinweis:
Wenn Sie die Fußzeile verwenden, stellen Sie sicher, dass sie die schließenden BODY- und HTML-Tags enthält (es sei denn,
natürlich verwenden Sie die Option --inline).

Wenn die Option --header nicht angegeben ist, wird das entsprechende Start-HTML-Markup verwendet
hinzugefügt, es sei denn, die Option --toc_only ist angegeben. Wenn die Option --footer nicht vorhanden ist
angegeben, wird das entsprechende abschließende HTML-Markup hinzugefügt, es sei denn, die Option --toc_only ist angegeben
angegeben.

Wenn Sie sich nicht mit Kopf- und Fußzeilendateien befassen möchten/müssen, können Sie dies tun
Geben Sie den Titel (Option --title) der ToC-Datei an. und es ermöglicht Ihnen, a anzugeben
Überschrift oder Beschriftung, die vor die Liste der ToC-Einträge gestellt werden soll, die Option --toc_label. Beide Optionen
Standardwerte haben. Weitere Informationen zu den einzelnen Optionen finden Sie unter „OPTIONS“.

Wenn Sie nicht möchten, dass HTML-Seiten-Tags bereitgestellt werden, sondern nur das Inhaltsverzeichnis selbst, dann
Geben Sie die Option --toc_only an. Wenn keine --header- oder --footer-Dateien vorhanden sind, wird dies der Fall sein
Geben Sie einfach den Inhalt von --toc_label und das ToC selbst aus.

Einfügen Inhaltsverzeichnis
Die Möglichkeit, das ToC direkt in ein HTML-Dokument einzubinden, wird über das unterstützt
--inline-Option.

Das Inlining erfolgt nur für die erste Datei in der Liste der verarbeiteten Dateien
Wird durchgeführt, wenn diese Datei ein öffnendes Tag enthält, das dem Wert --toc_tag entspricht.

Wenn --overwrite wahr ist, wird die erste Datei in der Liste mit überschrieben
Das generierte Inhaltsverzeichnis wird an der entsprechenden Stelle eingefügt. Ansonsten eine modifizierte Version des ersten
Die Datei wird entweder an STDOUT oder an die durch die Option --outfile definierte Ausgabedatei ausgegeben.

Die Optionen --toc_tag und --toc_tag_replace werden verwendet, um zu bestimmen, wo und wie sich das ToC befindet
in die Ausgabe eingefügt.

Beispiel 1

# Dies ist die Standardeinstellung
--toc_tag BODY --notoc_tag_replace

Dadurch wird das generierte ToC nach dem BODY-Tag der ersten Datei eingefügt. Wenn der --header
Wenn die Option angegeben ist, wird der Inhalt der angegebenen Datei nach dem BODY eingefügt
Schild. Wenn die Option --toc_label nicht leer ist, dann der durch --toc_label angegebene Text
Option wird eingefügt. Dann wird das ToC eingefügt und schließlich, wenn die Option --footer vorhanden ist
angegeben, wird die Fußzeile eingefügt. Dann folgt der Rest der Eingabedatei wie er war
vor.

Beispiel 2

--toc_tag '!--toc--' --toc_tag_replace

Dadurch wird das generierte ToC nach dem ersten Kommentar des Formulars eingefügt , und das
Der Kommentar wird durch das ToC (in der Bestellung) ersetzt
--Header
--toc_label
Inhaltsverzeichnis
--footer), gefolgt vom Rest der Eingabedatei.

Hinweis:
Die Header-Datei sollte nicht das Anfangs-HTML-Tag und das HEAD-Element enthalten, da die
Die verarbeitete HTML-Datei sollte diese Tags/Elemente bereits enthalten.

Beispiele:

Erstellen an Inline- Inhaltsverzeichnis für dank One Datei
hypertoc --inline --make_anchors --overwrite --make_toc index.html

Dadurch werden Anker in „index.html“ erstellt und ein Inhaltsverzeichnis mit der Überschrift „Tabelle von“ erstellt
Contents“ und platzieren Sie es nach dem BODY-Tag von „index.html“. Die Datei index.html.org wird
enthalten die Originaldatei index.html, ohne Inhaltsverzeichnis oder Anker.

Erstellen a Inhaltsverzeichnis Datei für mehrere Dateien
Erstellen Sie zunächst die Anker.

hypertoc --make_anchors --overwrite index.html fred.html george.html

Dann erstellen Sie das ToC

hypertoc --make_toc --outfile table.html index.html fred.html george.html

Erstellen an Inline- Inhaltsverzeichnis nachdem zuerst Üerschrift of zuerst Datei
hypertoc --make_anchors --inline --overwrite --make_toc --toc_tag /H1 \
--notoc_tag_replace --toc_label "" index.html fred.html george.html

Dadurch werden Anker in den Dateien „index.html“, „fred.html“ und „george.html“ erstellt
Erstellen Sie ein Inhaltsverzeichnis ohne Header und platzieren Sie es nach dem ersten H1-Header in „index.html“ und sichern Sie es
die Originaldateien nach „index.html.org“, „fred.html.org“ und „george.html.org“

Erstellen an Inline- Inhaltsverzeichnis mit Original Elemente
hypertoc --quiet --make_anchors --bak "" --overwrite \
--make_toc --inline --toc_label "" --toc_tag '!--toc--' \
--toc_tag_replace \
--toc_entry H2=1 --toc_entry H3=2 \
--toc_end H2=/H2 --toc_end H3=/H3 meineDatei.html

Dadurch wird ein Inline-Inhaltsverzeichnis erstellt, das die Originaldatei überschreibt und eine ersetzt
Kommentar, und der H2-Header als Level 1 und H3-Header als Level 2 akzeptiert. Dies kann sein
nützlich, wenn die .html-Datei von einem anderen Prozess generiert wird und Sie sie dann erstellen können
das ToC als letzten Schritt.

Erstellen a Inhaltsverzeichnis mit Original Elemente
hypertoc --quiet --make_anchors --bak "" --overwrite \
--toc_entry TITLE=1 --toc_end TITLE=/TITLE
--toc_entry H2=2 --toc_entry H3=3 \
--toc_end H2=/H2 --toc_end H3=/H3 \
--make_toc --outfile index.html \
mary.html fred.html george.html

Dadurch werden Anker an den H2- und H3-Elementen erstellt und eine ToC-Datei namens index.html erstellt.
Indizierung auf dem TITLE und den H2- und H3-Elementen.

Erstellen a Inhaltsverzeichnis mit Original Elemente und Optionen Datei
Gegeben sei eine Optionsdatei mit dem Namen „custom.opt“ wie folgt:

# Titel, H2 und H3
--toc_entry TITEL=1
--toc_end TITLE=/TITLE
--toc_entry H2=2
--toc_end H2=/H2
--toc_entry H3=3
--toc_end H3=/H3

dann kann das vorherige Beispiel kürzere Befehlszeilen wie folgt haben:

hypertoc --quiet --make_anchors --bak "" --overwrite \
--argfile custom.opt --make_toc --outfile index.html mary.html fred.html george.html

ANMERKUNG

· Hypertoc ist intelligent genug, um Anker innerhalb wichtiger Elemente zu erkennen. Wenn der Anker
definiert das NAME-Attribut, hypertoc verwendet den Wert. Andernfalls fügt es seinen eigenen NAMEN hinzu
Attribut zum Anker. Wenn --use_id wahr ist, wird ebenfalls geprüft und verwendet
Ausweise.

· Das TITLE-Element wird besonders behandelt, wenn es als signifikantes Element angegeben wird. Es ist
Das Einfügen von Ankern (A) in TITLE-Elemente ist illegal. Daher wird Hypertoc tatsächlich
Link zum Dateinamen selbst anstelle des TITLE-Elements des Dokuments.

· Hypertoc ignoriert ein signifikantes Element, wenn es keine Nicht-Leerzeichen enthält
Figuren. Wenn eine solche Bedingung vorliegt, wird eine Warnmeldung generiert.

· Wenn Sie eine Abfolge signifikanter Elemente haben, die sich leicht ungeordnet ändern
Mode, wie H1 -> H3 -> H2 oder sogar H2 -> H1, obwohl Hypertoc damit umgeht
Erstellen Sie eine Liste, die immer noch gutes HTML ist, wenn Sie dazu eine geordnete Liste verwenden
Tiefe, dann erhalten Sie eine seltsame Nummerierung, da es sich um ein zusätzliches Listenelement handelt
eingefügt, um die Elemente auf der richtigen Ebene zu verschachteln.

Zum Beispiel (H2 -> H1 mit --ol_num_levels=1):

1.
* Mein H2-Header
2. Mein H1-Header

Zum Beispiel (H1 -> H3 -> H2, wobei --ol_num_levels=0 und H3 ebenfalls von Bedeutung sind):

1. Mein H1-Header
1.
1. Mein H3-Header
2. Mein H2-Header
2. Mein zweiter H1-Header

In solchen Fällen ist es möglicherweise besser, die Option --ol nicht zu verwenden.

· Wenn beim Generieren von Ankern nicht --overwrite verwendet wird, muss der Befehl verwendet werden
erfolgt in zwei Durchgängen, um die richtigen Dateinamen zu erhalten (die mit den tatsächlichen
Anker in ihnen) zum ToC-Generierungsteil hinzufügen. Andernfalls verfügt das Inhaltsverzeichnis über Anker
Verweisen auf Dateien, die sie nicht haben.

· Bei der Verwendung von --inline muss beim Überschreiben vorsichtig vorgegangen werden, wenn das ToC auf gesetzt wird
nach einem bestimmten Tag (z. B. dem Standard-BODY) eingefügt werden, wenn der Befehl ausgeführt wird
wiederholt konnte man mehrere Inhaltsverzeichnisse nacheinander in derselben Datei erhalten.

VORSICHTEN

· Version 3.10 (und höher) generiert ausführlichere (SEO-freundliche) Anker als früher
Versionen. Daher stimmen Anker, die mit früheren Versionen generiert wurden, nicht mit Version 3.10 überein
Anker.

· Version 3.00 (und höher) von Hypertoc verhält sich etwas anders als Version 2.x von
hypertoc. Es ist jetzt darauf ausgelegt, alles in einem Durchgang zu erledigen, und ist bei der Sicherheit gesunken
Optionen: Die Option --infile wird nicht mehr verwendet (alle Dateinamen werden am Ende von eingefügt
der Befehl); die Option --toc_file existiert nicht mehr; Verwenden Sie die Option --outfile
stattdessen; Die Option --tocmap wird nicht mehr unterstützt.

Es generiert jetzt Tags in Kleinbuchstaben statt in Großbuchstaben.

· Hypertoc ist nicht sehr effizient (Speicher und Geschwindigkeit) und kann bei großen Anwendungen langsam sein
Unterlagen.

· Jetzt, da die Generierung der Anker und des ToC in einem Durchgang erfolgt, noch mehr Speicher
verwendet wird als bisher. Dies ist bei der Verarbeitung mehrerer Daten deutlicher zu erkennen
Dateien, da alle Dateien vor der Verarbeitung in den Speicher eingelesen werden.

· Es wird ein ungültiges Markup generiert, wenn ein signifikantes Element in einem enthalten ist
Anker. Zum Beispiel:

Der FOO-Befehl

wird konvertiert in (wenn h1 ein signifikantes Element ist),

Der FOO-Befehl

was illegal ist, da Anker nicht verschachtelt werden können.

Es ist sinnvoller, Ankeranweisungen innerhalb des zu verankernden Elements zu platzieren. Für
Folgendes wird beispielsweise bevorzugt:

Der FOO-Befehl

Hypertoc erkennt den Namen „foo“ und verwendet ihn.

Noch besser ist es, IDs zu verwenden:

Der FOO-Befehl

· NAME-Attribute ohne Anführungszeichen werden nicht erkannt.

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