4. Die Kommandozeile
Die Kommandozeile kann Hilfsfunktionen direkt ausführen, z.B. Seiten vorab in statisches HTML übersetzen.
4.1 Installation
Die Installation erfolgt via npm:
1 $ npm install *Pug* --global
4.2 Benutzung und Optionen
Die Benutzung der Kommandozeile sieht folgendermaßen aus:
1 $ *Pug* [options] [dir|file ...]
| Optionen | |
|---|---|
-h, --help |
Hilfe zur Benutzung |
-V, --version |
Version der Bibliothek |
-O, --obj <path|str> |
JavaScript-Optionen oder JSON-Datei mit einem passenden Objekt darin |
-o, --out <dir> |
Ausgabeverzeichnis für das HTML |
-p, --path <path> |
Dateipfad zum Auflösen von includes
|
-P, --pretty |
HTML Ausgabe wird lesbar gestaltet |
-c, --client |
Übersetzungsfunktion für die clientseitige runtime.js |
-n, --name <str> |
Der Name des übersetzten Templates (erfordert –client) |
-D, --no-debug |
Ohne Debugger übersetzen (kleinere Funktionen) |
-w, --watch |
Überwacht Dateien auf Änderungen und rendert neu |
-E, --extension <ext> |
Gibt die Dateierweiterung für die Ausgabe an |
--name-after-file |
Name des Templates nach dem letzten Segment des Dateipfades beim Lesen der Vorlage |
|
(erfordert –client, überschrieben durch –name) |
--doctype <str> |
Bestimmt den Doctype auf der Kommandzeile (sinnvoll, wenn das Template nichts enthält) |
Anwendungsbeispiele für die Kommandozeile
Übersetzen Sie Vorlagen lokal wie folgt:
1 $ *Pug* templates
Erzeugen Sie zwei HTML-Dateien , “foo.html” und “bar.html”:
1 $ *Pug* {foo,bar}.*Pug*
Pug-Ergebnisse können über stdio ausgegeben werden:
1 $ *Pug* <my.*Pug*> my.html
Eine Umleitung auf Pug erfolgt durch das Pipe-Symbol:
1 $ echo "h1 *Pug*!" | *Pug*
Rendern Sie die Verzeichnisse “foo” und “bar” nach /tmp:
1 $ *Pug* foo bar --out /tmp