Dies ist der Befehl „gather_stx_titles“, 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
Gather_stx_titles – Titeldeklarationen aus Stx-Dokumenten sammeln
ZUSAMMENFASSUNG
Gather_stx_titles [ -f Von-Suffix ] [ -T to-suffix ] [ m4 Optionen ] Datei [ Datei ... ]
BESCHREIBUNG
Gather_stx_titles gräbt STX-Metadatendeklarationen aus der Liste aus Dateien, und wirft das ab
Titel- und Dokument-ID-Informationen als m4-Definitionen in die Standardausgabe. Das
Informationen können später von w_crosslink verwendet werden, um die Dokumente anhand ihrer Metadaten zu verknüpfen.
Warum ist das nützlich? Stellen Sie sich vor, Sie hätten eine große Website mit vielen Querverlinkungen.
Der Name eines Dokuments erscheint an vielen Stellen: im Link-Menü (falls vorhanden) und in
der Hauptteil verschiedener Seiten, von denen aus verlinkt wird. Mit „gather_stx_titles“ können Sie Folgendes ablegen
alle Informationen an einem Ort und dort, wo sie hingehören, nämlich in der Datei selbst. Du wirst sein
Ich freue mich, wenn Sie das getan haben, wenn es an der Zeit ist, Dokumenttitel zu ändern oder die Dokumente zu verschieben
um; Dies gilt insbesondere dann, wenn Ihre Website über mehrsprachige Magie verfügt.
OPTIONAL
gather_stx_titles verwendet m4 intern und akzeptiert jede Option, die m4 akzeptiert. Zusätzlich
Dazu sind folgende Optionen erforderlich:
-f Von-Suffix
Ersetzen Sie in den Dateinamendaten das Suffix Von-Suffix. Tatsächlich,
from_suffix kann ein regulärer Ausdruck sein; dumm, aber wahr, in GNU m4 ist es ein
„traditioneller“ regulärer Ausdruck, während es sich in BSD m4 um einen „erweiterten“ regulären Ausdruck handelt. Standardmäßig auf
kein Suffix (nichts zum Mitnehmen).
-t to-suffix
Ersetzen Sie in den Dateinamendaten das entfernte Suffix durch Von-Suffix mit nach-
Suffix. Wenn Von-Suffix ist Null (Standard), anhängen to-suffix auf alle Dateinamen.
-p Präfix
Entfernen Sie das durch (regulären Ausdruck) angegebene Präfix. Präfix aus Dateinamen. Der
Das Äquivalent von -t existiert hierfür nicht, da Sie ein Verzeichnis angeben können
Präfix zu w_crosslink von w_base.
--version, -V
Zeigen Sie einfach die Versionsinformationen an und beenden Sie den Vorgang.
--helfen, -?
Zeigen Sie einfach eine kurze Hilfemeldung an und beenden Sie den Vorgang.
Beispiele:
Ich vermute, dass Sie die Verwendung von „gather_stx_titles“ in den meisten Fällen automatisieren möchten
Beispiel mit einem Makefile wie diesem:
QUELLEN = $(Platzhalter *.stx)
TARGETS = $(SOURCES:.stx=.html)
alle: $(TARGETS)
titles.m4: $(SOURCES)
Gather_stx_titles -f stx -t html $^ > $@
%.html: %.stx titles.m4
stx2any -T html titles.m4 $< > $@
Wenn Sie nicht ganz so korrekt sein möchten, löschen Sie die .html-Abhängigkeit von titles.m4 oder
titles.m4 Abhängigkeit von SOURCES. Die Verwendung temporärer Dateien ist nicht erforderlich: Dies sollte auch der Fall sein
Arbeit:
$ Gather_stx_titles *.stx | stx2any – mydoc.stx
Verwenden Sie „gather_stx_titles“ online über die Dienste von onworks.net
