Übersicht

shortids.pl --help | --version

shortids.pl [ --verbose ... | --no_verbose ] [ --in IN ] [ --ptn PTN ] [ --out OUT ]

Optionen

--help

Gibt eine kurze Hilfe mit den aktuellen Einstellungen aus

--version

Gibt kurze Hinweise zum Programm und die Version aus.

--verbose

Erhöht den Umfang der Meldungen nach STDERR.

--no_verbose

Unterdrückt die Ausgabe von Meldungen. Die Optionen --verbose und --no_verbose werden der Reihe nach ausgewertet.

--in IN

Pfad der Eingabedatei oder - für STDIN. Die Eingabe enthält jeden langen Schlüssel in einer Zeile. Leerzeichen am Ende einer Eingabezeile werden entfernt.

--ptn PTN

Vorlage für kurze Schlüssel mit Zähler-Platzhaltern der Form ${#XX}. Einzelheiten zu Platzhaltern s. Herbaer::Placeholders, Datei Placeholders.pm (Quelltext).

--out OUT

Pfad der Ausgabedatei oder - für STDOUT. Die Ausgabe ist ein XML-Dokument, das den langen Schlüsseln kurze Schlüssel zuordnet (s. hash.rng).

Beschreibung

Die Quelltexte der XSLT-Dokumente nutzen lange, „sprechende” Schlüssel für (sprachabhängige) Texte. Die Dokumente, die der Server liefert, und die Lokalisierungsdateien verwenden kurze Schlüssel. Dieses Skript liest lange Schlüssel aus einer Textdatei IN Jeder Schlüssel steht in einer einzelnen Zeile. Leerzeichen am Ender einer Eingabezeile werden entfernt.

Jedem langen Schlüssel wird ein kurzer Schlüssel zugeordnet. Die kurzen Schlüssel werden gebildet, indem Platzhalter in PTN ersetzt werden.

Die Ausgabe OUT ist ein XML-Dokument. Es nutzt den Namensraum http://herbaer.de/xmlns/20121015/hash (s. hash.rng)

Software-Voraussetzungen

Das Programm ist mit Perl Version 5.10.1 entwickelt. Es benutzt die folgenden Module:

Herbaer::Readargs

Die Funktion read_args aus diesem Modul verarbeitet die Befehlszeilenargumente, die Funktion print_message_with_values gibt die Hilfe mit den aktuellen Einstellungen aus.

Herbaer::Placeholders

Die Funktion subst_placeholders aus diesem Modul ersetzt Platzhalter in PTN durch fortlaufende (neue) Werte.

Herbaer::XMLDataWriter

dient zur XML-Ausgabe.