"get-text" "1" "" "" "Starbuntu"

NAME

get-text - liest zu Übersetzungszwecken eine für Menschen lesbare Übersetzungsdatei aus, z. B. Starbuntu.po (bereitgestellt von Starbuntu)

SYNTAX

[textdomaindir=<Pfad des Ordners oberhalb ./locale/> textdomain=<Name der Übersetzungsdatei *.po ohne Erweiterung>] get-text [--<Sprachkürzel>] <englische Wendung> [<Variablenwerte>]

BESCHREIBUNG

Das Starbuntu-Programm get-text übersetzt einen englischen Eintrag einer Übersetzungsdatei '*,po'. Dabei müssen dem Programm die Umgebungsvariablen textdomaindir=<Pfad der Übersetzungsdatei> (ohne '/locale/$LANGUAGE/LC_MESSAGES') sowie textdomain=<Name der Übersetzungsdatei> (ohne ".po") übergeben werden, es sei denn, sie haben die im unteren Beispiel genannten Werte. Optional kann noch der Parameter --$LANGUAGE gesetzt werden, falls $LANGUAGE nicht die vorgegebene Benutzersprache ist. Falls der zu übersetzende Eintrag Variablen enthält, müssen auch deren Werte als Parameter übergeben werden. Dieses Programm funktioniert zumindest für Starbuntu, aber in vielen Fällen auch für andere Pakete, wenn das Alternativprogramm gettext versagt, weil z. B. der Boot-Vorgang noch nicht abgeschlossen ist.

Beim Aufruf von get-text ist zu beachten, dass im englischen Vorlagetext dem Dollarzeichen und den eckigen Klammern ein umgekehrter Schrägstrich (Backslash) vorangestellt werden muss.

OPTIONEN

--<Sprachkürzel>
z. B. --es für spanisch

DATEIEN

/usr/local/bin/get-text
/usr/bin/gettext
/usr/local/share/locale/$LANGUAGE/LC_MESSAGES/*.po

UMGEBUNGSVARIABLEN

textdomaindir
  <Pfad des Ordners oberhalb ./locale/> (z. B. /usr/local/share)
textdomain
  <Name der Übersetzungsdatei *.po ohne Erweiterung> (z. B. Starbuntu)

BEISPIEL

textdomaindir="/usr/local/share" textdomain=Starbuntu get-text --es "Starbuntu upgradable to \\$newest!" 24.04.2.14

Zum Vergleich:

newest=24.04.2.14
msgid="Starbuntu upgradable to \\$newest!"
TEXTDOMAINDIR=/usr/share/locale TEXTDOMAIN=Starbuntu LANGUAGE=es gettext "$msgid" | (export PATH `envsubst --variables "$msgid"`; envsubst "$msgid")

AUTOR

Peter Starfinger <info@die-starfingers.de>

SIEHE AUCH

GNU-Programm
  gettext