intro wiki download guestbook contact

=WebTek::Message=

====Beschreibung
Lädt und verwaltet Messages. Messages sind kurze Strings, welche mit einem s.g. message-key angesprochen werden können. Messages werden z.B. zur Übersetztung von Templates verwendet.

====Filename
Der Filename von einem Messagefile muß das folgende Format haben:
de.wiki.properties
* am Anfang steht der zwei zeichen lange Language- Code (z.b. de, en),
* danach kommt ein beliebiger Name, der z.b. die Zugehörigkeit der Messages kurz beschreibt
* und die Endung muß properties sein, da das Fileformat im Java- Properties Format ist.

====Encoding
Alle Messagefiles müssen in Utf-8 encoded sein. Wenn ein anderes Encoding gewünscht ist, dann geht das über die Funktion message welche weiter unten beschrieben ist.

====Fileformat
Das Format ist im wesentlichen gleich wie das Java- http://java.sun.com/j2se/1.4.2/docs/api/java/util/Properties.html|Properties Format. Gültige Messages sehen z.B. so aus:
key = value
key=value
key:value
key1.key2 = value
key1.key3 = value beginnt hier \
und value geht hier weiter

====Methoden
* message(%params) versucht eine Message für die übergeben Parameter zu finden. wenn keine Message gefunden werden konnte, wird der übergebene Key zurückgegeben. Folgende Paramter können verwendet werden:
** language definiert die Sprache der Message. z.b. en, de
** key definiert den Key der Message
** de wenn ein Paramter für eine Sprache übergeben wird, wird dieser anstatt dem Wert aus dem Messagefile übergeben.
** encoding ändert Encoding der Message auf das definierte Format.
* load($file) lädt alle Messages aus dem File $file.