valid xhtml 1.0 strict
bookmark this site at del.icio.us bookmark this site at mister-wong.de bookmark this site at furl.net bookmark this site at ho.tli.st bookmark this site at blogmarks.net bookmark this site at stumbleupon.com bookmark this site at scuttle.org
 

zuletzt geändert : 24.01.10

Sprachdateien

Für jede unterstützte Sprache gibt es eine entsprechende Sprachdatei im "lang"-Verzeichnis; z.B. efileman_german.cgi beinhaltet alle notwendigen Werte für deutschsprachige Benutzer. Diese Werte können geändert oder auch eine neue Sprachdatei erzeugt werden wie nachfolgend beschrieben.

Man kopiert eine existierende Sprachdatei und benennt sie um von z.B. efileman_english.cgi zu efileman_chinese.cgi.

Zuerst ändert man den Wert der $charset-Variablen entsprechend, für chinesisch $charset = "gb2312". Siehe die Dokumentation auf www.w3.org für andere charset-Werte.

Die Variable $TEXT darf nicht umbenannt werden und es müssen Grossbuchstaben verwendet werden z.B. $TEXT{'filespace'}.
$text{'filespace'} wird nicht verarbeitet.

Ebenso dürfen die Werte innerhalb der $TEXT-Variablen nicht umbenannt werden. Möglich ist allerdings das Hinzufügen neuer Werte z.B. $TEXT{'mytext'} und deren Verwendung in den skins-Dateien als ##TEXT'mytext'##. Siehe unter Skins für mehr Informationen.

Es dürfen HTML-Tags in allen $TEXT-Variablen verwendet werden, die Meldungen an die Benutzer enthalten, z.B. $TEXT{'comment'} oder $TEXT{'sendmailsuc'}.

Beispiel:

  • $TEXT{'sendmailsuc'} = "Die Email wurde <b>erfolgreich</b> versendet !"
    um die folgende Meldung auszugeben :
    "Die Email wurde erfolgreich versendet !"

Das Format von Datum und Zeitangaben kann durch Änderung der Werte für $TEXT{'month'}, $TEXT{'weekday'}, $TEXT{'date'} and $TEXT{'time'} angepasst werden z.B. durch Verwendung von Abkürzungen für Wochentags- und Monatsangaben. Ebenso kann die Reihenfolge oder das Trennzeichen geändert oder entfernt werden wie in den folgenden Beispielen gezeigt wird:

  • $TEXT{'time'} = "hh:mm:ss";
  • $TEXT{'time'} = "hh.mm";
  • $TEXT{'time'} = "hh Hour mm Minutes and ss Seconds";
  • $TEXT{'date'} = "dd.mm.yy";
  • $TEXT{'date'} = "dd-mm-yyyy";
  • $TEXT{'date'} = "mm/dd/yy";
  • $TEXT{'date'} = "mm yyyy";

Die Variablen $TEXT{'date'} und $TEXT{'time'} werden für die Anzeige des Zeitstempels von Dateien und Verzeichnissen benutzt und in diesem Zshg. durch ##dfdate## bzw. ##dftime## repräsentiert. Die $TEXT{'datetime'} Variable erlaubt die Anpassung der vollständigen Anzeige von aktueller Server(!)-zeit und Datum entsprechend der jeweiligen Sprache, z.B.

  • $TEXT{'datetime'} = "weekday, month dd, yyyy (time)"; (englisch, den definierten Wert von $TEXT{'time'} nutzend)
  • $TEXT{'datetime'} = "weekday dd de month de yyyy (hh:mm)"; (spanisch)
  • $TEXT{'datetime'} = "Heute ist weekday der dd.month yyyy (hh:mm Uhr)";
  • $TEXT{'datetime'} = "month weekday date time"; (bei Nutzung der definierten Werte von $TEXT{'date'} und $TEXT{'time'})

Grundsätzlich werden alle Sprachdateivariablen in den Skin-Dateien nach folgendem Muster eingesetzt: $TEXT{'upload'} durch ##TEXT'upload'##,
mit Ausnahme von $TEXT{'month'}, $TEXT{'weekday'}, $TEXT{'date'}, $TEXT{'time'} und $TEXT{'datetime'}.
Weil diese Werte vorher durch das Skript verarbeitet werden, werden diese repräsentiert durch ##month##, ##day##, ##date## (##dfdate##), ##time## (##dftime##) und ##datetime##.
Das Gleiche gilt für ##copyright## dessen Wert im Script definiert ist.

Die Sprachdatei ist Perl Code !
Die Syntax von $TEXT{'date'} = "mm yyyy"; definiert den Schlüssel "date" für den Hash TEXT mit dem entsprechenden Wert "mm yyyy" und dem notwendigen Semikolon als Anweisungsende-Kennung. Der Wert ist in Anführungstrichen eingeschlossen.
Diese Syntax muss bei Änderung der Sprachdatei beachtet werden. Anderenfalls wird das Skript nicht funktionieren
Füge keinen Wert wie $TEXT{'mykey'} hinzu, der bereits existiert, denn dieser neue Wert wird den Inhalt des ersten überschreiben.
Soll HTML Code, der selbst Anführungsstriche enthält wie z.B. <p style="color:#efefef;">..., aus einem HTML Editor in die Sprachdatei eingefügt werden, dann kann qq{your text} zum Umschließen des Hash-Wertes anstelle der Anführungsstriche verwendet werden, also $TEXT{'mykey'} = qq{<p style="color:#efefef;">...</p>};