für die Liste aller Seiten

PmWiki unterstützt die Internationalisierung von Netzseiten, erlaubt etwa Buchstaben mit Akzenten oder Umlauten in Seitennamen und bietet fast vollständige Anpassungsmöglichkeiten für PmWiki-Meldungen. Die meisten Anpassungen werden von PmWiki mittels der Funktion XLPage() zu Verfügung gestellt, die einen Satz von Übersetzungsvariablen aus einer Wikiseite lädt, üblicherweise XLPage genannt, die Seite kann aber beliebig umbenannt werden.

Der Rest dieser Seite widmet sich der Installation, Konfiguration und dem Gebrauch der Unterstützung anderer Sprachen. Wenn Sie nach Werkzeugen und Hilfe suchen, um PmWiki in Ihrer Sprache zu lokalisieren oder wie Sie die vorhandene Übersetzung verbessern können, beginnen Sie mit der Seite Lokalisierung – dem Übersetzungsportal, auf englisch.

Laden von Übersetzungs-Seiten

Seiten in vielen anderen Sprachen, darunter Französisch, Deutsch, Holländisch und Spanisch, werden in der pmwiki.com-Website bereits bereitgestellt und gepflegt. Sie können ein Archiv dieser Übersetzungen von http://www.pmwiki.org/pub/pmwiki/i18n/ herunterladen. Entpacken Sie einfach das(die) Archiv(e) in das Verzeichnis, das Ihre pmwiki.php-Installation enthält. Jedes Archiv enthält eine Reihe von Dateien, die im wikilib.d/-Verzeichnis gespeichert werden, sowie einige spezielle Skripten für Übersetzungen, die andere Zeichensätze als iso-8859-1 (standardmäßig von PmWiki verwendet) benutzen. Sie können auch den Zeichensatz UTF-8 benutzen.

Für eine deutsche Installation reicht es, die Dateien PmwikiDe.* in das Verzeichnis wikilib.d zu entpacken und hochzuladen.

Nach dem Installieren der Übersetzungs-Seiten aktivieren Sie eine bestimmte Sprache, indem Sie einen Aufruf von XLPage() in Ihre config.php einfügen. Beispielsweise erfolgt das Auswählen der deutschsprachigen Meldungen mittels

include_once("scripts/xlpage-utf-8.php"); # optional
XLPage('de','PmWikiDe.XLPage');

Diese Anweisung lädt die deutschen Übersetzungen ('de') von der Seite PmWikiDe.XLPage. Die "include once"-Zeile wird empfohlen, wenn Sie ein neues Wiki aufsetzen und sie sollte vor der XLPage-Zeile stehen. Für Sprachen mit anderen Alphabeten als dem lateinischen ist die "include once"-Zeile zwingend nötig. Diese Zeilen sollten nahe dem Beginn der config.php-Datei stehen, aber nach jeglicher Setzung von $WikiDir und $WikiLibDirs (wenn Sie eine solche Setzung haben) .

Es ist problemlos möglich, mehrere Übersetzungsseiten zu laden. Wenn Sie also eigene Übersetzungen nutzen wollen, ohne die aus dem i18n-Archiv zu verändern, erzeugen Sie einfach eine neue Seite (siehe unten) und laden sie. Ihre eigenen Übersetzungen müssen zuerst geladen werden, um Vorrang zu haben:

XLPage('de','PmWikiDe.XLPageLokal');  # meine eigenen Übersetzungen
XLPage('de','PmWikiDe.XLPage');       # aus i18n.tgz

Wenn Sie beabsichtigen, in Ihrem Wiki mehrere Sprachversionen anzubieten und Wikigruppen zur Auswahl der Sprache verwenden wollen, benötigen Sie etwas Kode in der Anpassungsdatei der Gruppe (siehe Individuelle Einstellungen pro Gruppe). Wenn Ihr Wiki z. B. deutsche und englische Bereiche enthält und die deutschen Seiten in der Gruppe De sind, können Sie eine Datei De.php im Verzeichnis local/ mit folgendem Inhalt erstellen:

<?php if (!defined('PmWiki')) exit();
# wechsle zu deutschen Meldungen
XLPage('de','PmWikiDe.XLPage');

Es bietet sich in diesem Fall an, auch eine Datei PmWikiDe.php gleichen Inhalts zu erstellen, um auch beim Zugriff auf die deutsche Dokumentation von PmWiki die deutsche Oberfläche von PmWiki zu bekommen. En.php ist in diesem Fall – für den englischen Teil – nicht nötig, da Englisch die Standardsprache ist.

Als Alternative zur Anpassungsdatei "pro Gruppe" ist auch folgender Kode in der config.php möglich, der testet, ob eine XLPage in der Gruppe der angeforderten Seite ist und sie dann lädt (gilt für jede Sprache):

$xlpage = FmtPageName('$Group.XLPage', $pagename);
if (PageExists($xlpage)) XLPage($xlpage, $xlpage);

Danach müssen Sie alle relevanten XLPage-Seiten in jede Gruppe kopieren, die die entsprechende Sprachunterstützung haben soll.

Ein anderer (fortschrittlicher) Weg wäre, das folgende Skript in config.php einzufügen. Es fragt vom Webserver die Header ab, die vom Browser des Benutzers gesendet wurden, und wählt eine Sprache aus.

    
$lang = substr($_SERVER['HTTP_ACCEPT_LANGUAGE'], 0, 2);
switch ($lang){
   case "es":
      XLPage('es','PmWikiEs.XLPage');
      break;
   case "en":
      XLPage('en','PmWikiEn.XLPage');
      break;
   default:
      XLPage('en','PmWikiEn.XLPage');
      break;
}

Siehe auch (englisch)

• Cookbook:MultiLanguage →
• Cookbook:MultiLanguageViews →

Neue Übersetzungen erstellen

Wenn für die von Ihnen gewünschte Sprache keine Übersetzungsseiten existieren, ist es einfach, selbst welche zu erstellen! Eine XLPage-Übersetzungsdatei ist eine Datei, die einfach Zeilen der folgenden Form enthält:

   'Ausdruck' => 'übersetzter Ausdruck',

Dabei ist "Ausdruck" eine internationalisierte Phrase (durch $[phrase] gekennzeichnet) in PmWiki's $...Fmt-Variablen und "übersetzter Ausdruck" ist das, was in Ihrer speziellen Sprache auf den Bildschirm kommt. Beispielsweise wandelt die Zeile (in PmWikiDe.XLPage)

"$[Search]" bei der Ausgabe in "Suchen" um. Die Datei Lokalisation:XLPageVorlage ist ein guter Ausgangspunkt, um eine neue XLPage-Datei zu erstellen und hat die meisten der PmWiki-Phrasen bereits aufgelistet. Beachten Sie, dass der Übersetzungsmechanismus nur Phrasen übersetzt, die in den $...Fmt-Ausdrücken (der verschiedenen .php-Skripten) als übersetzbar gekennzeichnet sind – es werden keine Wörter übersetzt, die in den Wiki-Formatierungsanweisungen auftauchen.

Wenn Sie neue Versionen von PmWiki-Seiten in anderen Sprachen erstellen, erwägen Sie bitte, sie zu der originalen PmWiki-Site hinzuzufügen, so dass sie mittels der i18n-Archive auch anderen zugänglich gemacht werden! Sie sollten auf jeden Fall das Lokalisationsportal aufsuchen, um weitere Informationen für eine effektive Internationalisierung von PmWiki zu erhalten.

Sonderzeichen in WikiLinks ermöglichen

Um Sonderzeichen wie zum Beispiel deutsche Umlaute in WikiLinks zu ermöglichen, muss die "locale"-Einstellung des Servers richtig eingestellt werden, damit PmWiki die passende Zeichensatzdefinition verwendet.

Falls das wegen beschränktem Zugriff auf die Serverkonfiguration (Hosting) nicht möglich ist, kann PmWiki so eingestellt werden, dass eine bestimmte "locale"-Einstellung aus den XLPage Optionen verwendet wird (siehe XLPageTemplate).

Für deutsche Umlaute ist zum Beispiel erforderlich:

• 'Locale' => 'deu', <- für Windows-Server, siehe MSDN List of locale identifiers
• 'Locale' => 'de_DE', <- für Linux-Server; für die UTF-8-Dekodierung müssen Sie eventuell bei einigen Installationen 'de_DE.utf8' oder 'de_DE.UTF-8' setzen.

Hinweis: Die erforderliche "locale" Einstellung kann vom Betriebssystem und der spezifischen Installation abhängen.

FAQ

    XLPage('es','PmWikiEs.XLPage');
    XLPage('fr','PmWikiFr.XLPage');
    XLPage('ru','PmWikiRu.XLPage');
    $XLLangs = array('en');

    XLPage('fr', 'PmWikiFr.XLPage');
    XLPage('fr-ca', 'PmWikiFrCa.XLPage');

    $XLLangs = array('fr', 'en');

    XLSDV('nl', array('my English expression'=>'mijn Nederlandse uitdrukking'));

    $local_string = XL("my English expression");

   'my English expression' => 'bla bla',

für die Liste aller Seiten