wml – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

WML – Website-META-Sprache

VERSION

2.0.12 (16. April 2008)

ZUSAMMENFASSUNG

wml [-I PATH] [-i PATH] [-D NAME/FUNKTION=STR] [-D NAME/FUNKTION~PATH] [-n] [-r] [-O Grad des ] [-o
[SLICETERM::]PATH[@CHMODOPT]] [-P PATH] [-E PATH] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [Eingabedatei]

wml [-V [NUM]] [-h]

BESCHREIBUNG

Dies ist das Steuerprogramm des Webseite META Sprache (WML), eine kostenlose HTML-Generierung
Toolkit für Unix, intern bestehend aus 9 unabhängigen Sprachen.

Die Hauptidee von WML ist ein sequentielles Filterschema, bei dem jede Sprache eines davon bereitstellt
9 Bearbeitungsdurchgänge. So wml liest Eingabedatei (oder von Standard if Eingabedatei ist ein Bindestrich oder
fehlt vollständig), wendet die Durchgänge 1-9 an (oder nur die Durchgänge, die durch angegeben sind). -p) und schlussendlich
produziert einen oder mehrere Ausgabedateis.

Weitere Einzelheiten zu diesem Verarbeitungsschema finden Sie im WML Einleitung für wml_intro(7)
und dem WML Dein Thema für wml_tutorial(7).

OPTIONAL

-I, --include=PATH
Fügt ein Verzeichnis zur Liste der Benutzer-Include-Pfade hinzufügen. Mit dieser Option legen Sie die Laufzeit fest
Umgebung für Durchgang 1. Siehe wml_p1_ipp(3) für weitere Details.

-i, --includefile=PATH
Lädt ein bestimmtes Include vor Datei, also quasi ein hinzufügen

#include „PFAD“

oben Eingabedatei. Verwenden Sie diese Option, um standardmäßige Benutzer-Include-Dateien automatisch einzuschließen.
Wenn Sie eine System-Include-Datei einbinden möchten, müssen Sie diese umgeben PATH mit Winkel
Klammern, zum Beispiel „-i“ „'' um die Datei einzuschließen foo/bar.wml
aus dem System-Include-Bereich. Alternativ können Sie die spezielle Syntax verwenden
„wml::foo::bar“ wie bei der „#use“-Direktive.

-D, --define=NAME/FUNKTION=STR
Definiert eine Variable, die in Durchgang 1 (IPP) über „$(NAME)“ in Durchgang 2 interpoliert werden kann
(mp4h) über <"get-var NAME">, in Durchgang 3 (ePerl) über "<:=$NAME:>" und in Durchgang 4 (GNU m4)
über „m4_NAME“. Eine besondere Variante --define=NAME/FUNKTION=UNDEF macht das Gegenteil, es löscht
vorherige Definitionen (die sich von der Aufhebung der Definition dieser Variablen unterscheiden können, z. B
mit systemdefinierten Variablen).

-D, --define=NAME/FUNKTION~PATH
Ähnlich wie oben, definiert jedoch eine Variable, die einen Pfadnamen enthält, der automatisch angepasst wird
(siehe unten). Es kann auf die gleiche Weise wie die Variante „NAME=STR“ interpoliert werden
zu teilen.

-n, --noshebang
Dies zwingt WML dazu, eine möglicherweise darin enthaltene Shebang-Zeile zu ignorieren Eingabedatei. Dies ist
Wird normalerweise von WMk verwendet, da WMk diese Zeile bereits analysiert und die Optionen bereitgestellt hat
WML.

-r, --norcfile
Dies zwingt WML dazu, alles zu ignorieren .wmlrc Dateien.

-c, --nocd
Wenn WML eine Eingabedatei aus einem anderen Verzeichnis verarbeitet, springt es in dieses Verzeichnis
vor dem Parsen .wmlrc Dateien und springen Sie anschließend zurück zum aktuellen Verzeichnis. Wenn diese Option
gesetzt ist, erfolgt kein Verzeichniswechsel und .wmlrc Dateien werden relativ zum aktuellen gelesen
Arbeitsverzeichnis.

-O, --optimieren=NUM
Dies ist die Optimierungsoption, die direkt an Durchgang 8 übergeben wird (htmlfix). Es
steuert den Umfang der Optimierung/Entfernung, die auf den generierten HTML-Code angewendet wird
Markup-Code.

-o, --outputfile=SLICETERM:Ausgabedatei[@CHMODOPT]
Dadurch wird die Ausgabe in eine Datei umgeleitet. Normalerweise wird die gesamte Datei an gesendet stdout
(dasselbe wie „ALL:-“). Sie können diese Option mehr als einmal verwenden, um die Ausgabe an mehrere zu senden
Datei während der Verwendung der SLICETERM als mengentheoretischer Term von Scheiben, um zu bestimmen, welche
Der Inhalt wird in jede einzelne Ausgabedatei eingefügt. Die Wahl CHMODOPT is
dient der Festlegung von Optionen für eine endgültige Anwendung chmod Befehl. Zum Beispiel verwenden
„u+x“ zum Erstellen einer Datei mit gesetztem Ausführungsbit (XBitHack-Funktion von Apache).
See Scheibe(1) für weitere Details.

-P, --prolog=PATH
Führt einen Prologfilter über die Eingabedatei aus. Dieses Programm empfängt die Daten, auf die es reagieren soll
als STDIN und muss die gefilterten Daten auf STDOUT erzeugen.

-E, --epilog=PATH
Führt ein Epilogprogramm über die letztendlich resultierenden Ausgabedateien aus. Derzeit ist die
Folgende WML-spezifische Programme sind bekannt: htmlinfo, Linklint, ordentlich und weblint. Aber
Sie können jedes Programm angeben, das in Ihrem „PFAD“ verfügbar ist. Dieses Programm empfängt
die Datei, auf die als erstes Befehlszeilenargument reagiert werden soll. Beachten Sie, dass die Ausgabe nicht erfolgt
zu dieser Datei umgeleitet, daher müssen Sie einen Wrapper oder programmspezifische Flags verwenden, wenn Sie möchten
Sie möchten Ausgabedateien ändern.

-t, --Zeit einstellen
Dadurch wird die Änderungszeit aller Ausgabedateien auf die Änderungszeit von gesetzt
Eingabedatei plus 1 Sekunde. Dies ist nützlich, da Webserver generieren
„Last-Modified“-Header und dort ist die Bearbeitungszeit wichtiger als die
Generationszeit. Der 1-Sekunden-Offset gilt für die Abhängigkeiten von Makefiles.

-M, --abhängen[=OPTIONAL]
Geben Sie eine für „make“ geeignete Regel aus, die die Abhängigkeiten jeder Ausgabedatei beschreibt, z
„gcc“ tut es. Es macht nur Sinn, wenn die -o Option verwendet wird. Es findet keine Verarbeitung statt
bis auf den ersten Durchgang.

Das D Die Flag-Option schreibt die Regel in eine Abhängigkeitsdatei. Der Name dieser Datei ist
erhalten, indem das Suffix der Ausgabedatei durch „.d“ ersetzt wird.

Das M Die Flag-Option löscht die Systemdateien aus der Liste der Abhängigkeiten.

-p, --pass=STR
Gibt an, welche der oben beschriebenen Durchläufe tatsächlich zur Laufzeit angewendet werden. Der
Argument STR ist eine durch Kommas getrennte Liste von Passnummern mit einem Sonderfall: Sie können
Schreiben Sie „XY“ für alle Durchgänge „X...Y“. Wenn Pass 9 nicht Teil von ist STR das Ergebnis
Die Ausgabe wird beschrieben STDOUT. Standard ist die Zeichenfolge „1-9“.

-W, --passoption=NUM,STR
Option einstellen STR für den Pass NUM.

-s, --sicher
Dadurch werden einige Perl-Hacks in WML deaktiviert, die die Verarbeitung durch Reduzierung beschleunigen
Gabelung über Kopf beim Laufen der verschiedenen Pässe.

Ohne diese Option kompiliert WML die Durchgänge 1,5,6,7,8 vor (die in Perl geschrieben sind!)
in einen anderen Namensraum des aktuell laufenden Perl-Interpreters statt
sie extern über „system()“ ausführen. Der Effekt besteht darin, dass diese Programme ausgeführt werden
innerhalb desselben Perl-Interpreters, wodurch fünf CPU- und zeitintensive „fork()“ eingespart werden.
Der tatsächliche Gewinn liegt zwischen 2 und 4 Sekunden Verarbeitungszeit. Obwohl Erfahrung
hat gezeigt, dass es großartig funktioniert, das theoretische Problem besteht immer noch darin, dass dieser Ansatz funktioniert
etwas riskant aufgrund interner Perl-Variablenkonflikte.

Verwenden Sie diese Option, um diese Beschleunigungen zu deaktivieren, indem Sie WML zwingen, das sichere „fork()“ zu verwenden.
Ansatz.

-v, - ausführlich[=NUM]
Dadurch wird der ausführliche Modus (von 1 bis 9) eingestellt, in dem einige Verarbeitungsinformationen angegeben werden
auf der Konsole. Nützlich zum Debuggen. Diese Option wird auch an einige weitergegeben
Filterprogramme. Standard ist keine Ausführlichkeit und gerecht -v Mittel -v1.

-q, --ruhig
Dadurch wird der Ruhemodus eingestellt, in dem die Verarbeitungsstütze nicht mehr angezeigt wird. Benutze das
Option beim Laufen wml als Batch-Job. Diese Option wird automatisch erzwungen, wenn
Eingabedatei wird vermisst. Dann liest WML automatisch aus Standard im Ruhemodus.

-V, --Version[=NUM]
Gibt die Versionsidentifikationszeichenfolge und den Haftungsausschluss (Nr NUM or NUM >= 1), die WML
Build-Informationen (NUM >= 2) und die Perl-Build-Informationen (NUM >= 3). Benutze das
Option, um eine kurze Beschreibung Ihres installierten WML-Systems zu erhalten, insbesondere wann
Fehler an den Autor melden.

-h, --help
Druckt die Seite mit der Nutzungszusammenfassung.

DEFINIERTE VARIABLEN
Die folgenden Variablen werden immer durch definiert wml zur Laufzeit und sind in der Regel
interpoliert über <"get-var NAME"> in Pass 2 und über $NAME in Pass 3.

WML_SRC_DIRNAME
Das aktuelle Arbeitsverzeichnis von wo wml wurde gestartet. Ein absolutes Unix-Dateisystem
Pfad.

WML_SRC_FILENAME
Der Name des Eingabedatei über die Befehlszeile. Nützlich beim Laufen wml auf einem Großteil von
Dateien und Includedateien müssen bestimmen, in welche Datei sie eingebunden werden.

WML_SRC_BASENAME
Der Basisname des Eingabedatei, also der „WML_SRC_FILENAME“, aber mit der Erweiterung
bereits ausgezogen.

WML_SRC_TIME
Die letzte Änderungszeit von Eingabedatei im Format „time()“. Nützliche Innenfußzeilen
wenn ein benutzerdefiniertes Datumsformat erforderlich ist.

WML_SRC_CTIME
Die letzte Änderungszeit von Eingabedatei im „ctime()“-Format. Nützliche Innenfußzeilen
Dateien einschließen.

WML_SRC_ISOTIME
Die letzte Änderungszeit von Eingabedatei im ISO-Format „JJJJ-MM-TT hh:mm:ss“. Nützlich
In den Fußzeilen sind Dateien enthalten.

WML_SRC_USERNAME
Der Unix-Benutzername des Benutzers, der Eigentümer ist Eingabedatei.

WML_SRC_REALNAME
Der echte Name des Benutzers, der Eigentümer ist Eingabedatei.

WML_GEN_TIME
Der aktuelle Zeitpunkt der Generierung im Format „time()“. Nützliche Innenfußzeilen, wenn
Es ist ein angepasstes Datumsformat erforderlich.

WML_GEN_CTIME
Der aktuelle Zeitpunkt der Generierung im Format „ctime()“. Zu den nützlichen Innenfußzeilen gehören:
Dateien.

WML_GEN_ISOTIME
Der aktuelle Zeitpunkt der Generierung im ISO-Format „JJJJ-MM-TT hh:mm:ss“. Nützlich im Inneren
Fußzeilen enthalten Dateien.

WML_GEN_USERNAME
Der Unix-Benutzername des Benutzers, der das ausführt wml verarbeiten.

WML_GEN_REALNAME
Der echte Name des Benutzers, der das ausführt wml verarbeiten.

WML_GEN_HOSTNAME
Der Name des Hosts, auf dem die wml Befehl wird ausgeführt.

WML_LOC_PREFIX
Das Standortpräfix, an dem WML zum Zeitpunkt der Erstellung installiert wurde.

WML_LOC_BINDIR
Das Verzeichnis, in dem die WML-Binärdateien zur Erstellungszeit installiert wurden.

WML_LOC_LIBDIR
Das Verzeichnis, in dem die WML-Bibliotheksdateien zum Zeitpunkt der Erstellung installiert wurden.

WML_LOC_DATADIR
Das Verzeichnis, in dem die Datendateien von WML zum Zeitpunkt der Erstellung installiert wurden.

WML_LOC_MANDIR
Das Verzeichnis, in dem die WML-Handbuchseiten zum Zeitpunkt der Erstellung installiert wurden.

WML_VERSION
Die Versionsidentifikationszeichenfolge von WML. Verwenden Sie dies beispielsweise in HTML-Kommentaren
Der innere Header enthält Informationen zur Identifizierung der Version des Generierungstools.

BENUTZT VARIABLEN
„WMLOPTS“
Diese Variable kann eine Zeichenfolge von Optionen enthalten. Normalerweise wird dies von Bourne-Shell verwendet
Benutzer mögen

$ WMLOPTS="-DNAME1=VALUE2 -DNAME2=VALUE2"
$ WMLOPTS exportieren

und von C-Shell-Benutzern wie

$ setenv WMLOPTS "-DNAME1=VALUE2 -DNAME2=VALUE2"

um sicherzustellen, dass einige Variablen für alle Läufe definiert sind wml.

"PAGER"
Diese Variable enthält den Pager, den WML verwenden soll. WML verwendet einen Pager, wenn es mit dem aufgerufen wird
--verbose=NUM or -vNUM Option bzw. und NUM ist 3 oder höher und daher
Anzeige der verarbeiteten Daten nach jedem Durchgang. Der Standardwert ist „mehr“.

„TMPDIR“
Diese Variable enthält das Verzeichnis, in dem WML seine temporären Dateien speichert. Der Standardwert ist
'/ Tmp'.

USER DATEIEN

$HOME/.wmlrc und (../)*.wmlrc
Diese Dateien können auch Optionszeichenfolgen enthalten, eine Option pro Zeile. Normalerweise die
Der Inhalt ist einer oder mehrere -D Optionen, insbesondere automatisch angepasste:

-DROOTREL~.
-DROOTABS=http://thishost/thisarea/
:
-DNAME1=WERT1
-DNAME2=WERT2
:

STANDARD eNTHALTEN DATEIEN

WML wird mit einem Standardsatz an Include-Dateien ausgeliefert. Sie können sie direkt über einbinden

#verwenden Sie wml::category::name

und lesen Sie ihre eigene Dokumentation über

$ man wml::category::name

See wml::alle(3) für eine Beschreibung aller verfügbaren Include-Dateien.

SPECIAL MERKMALE

Das WML-Steuerungs-Frontend bietet für sich genommen einige Besonderheiten:

Unterstützung der Shebang-Linie
WML erkennt a Shebang Zeile („#!wml“ Optionen'') in dem .wml Dateien und
fügt automatisch hinzu Optionen zu seiner Befehlszeile. Diese Zeile wird auch von WMk verwendet. Zwei
Im Gegensatz zu Shebang-Linien stehen für den Unix-Loader spezielle Funktionen zur Verfügung: WMLs
Die Shebang-Zeile kann über ein Backslash-Zeichen und die Konstrukte %DIR und fortgesetzt werden
% werden interpoliert (wobei %DIR der Pfad zum Verzeichnis der Quelle ist).
befindet sich und %BASE ist der Dateiname der Quelldatei ohne Erweiterung).

Beispiel:

#!wml -o (ALL-LANG_*)+LANG_EN:%BASE.en.html \
-o (ALL-LANG_*)+LANG_DE:%BASE.de.html

Datenschutz-Container-Tag
WML stellt ein eigenes internes Container-Tag mit dem Namen „ bereit.
[pass=SPEC]>"..." ", mit dem jede Art von Daten geschützt werden kann
von jedem WML-Pass verarbeitet werden. Wenn kein „pass“-Attribut angegeben ist SPEC Der Standardwert ist „1-9“.
Wenn Sie dann „pass“ verwenden SPEC kann entweder „#-“, „-#“, „#-#“ oder durch ein Komma getrennt sein
Liste der Durchgänge, während „#“ zwischen 1 und 9 liegen kann.

Beispiel:



...
Ausgabe = " " + help_string + " "
...



Warnung:

Seit WML 2.0.3 enthält Durchgang 1 zusätzliche Dinge, die dabei helfen, Informationen über die Leitung zu behalten
Zahlen relevant (a la cpp). Also beim Schreiben


#include 'foo'


Diese zusätzlichen Befehle werden in Durchgang 2 nicht interpretiert und bleiben auf der Ausgabe.
Um sie zu unterdrücken, kompilieren Sie entweder mit dem Flag „-W1,-N“ oder schreiben Sie


#include 'foo' IPP_NOSYNCLINES

AUTOREN

Ralf S. Engelschall
[E-Mail geschützt]
www.engelschall.com

Dennis Barbier
[E-Mail geschützt]

Verwenden Sie WML online über die Dienste von onworks.net