UTF-8

für die Liste aller Seiten

UTF-8 unterstützt alle Sprachen und Alphabete einschließlich asiatischer Sprachen und ihre Zeichenvielfalt. Es ist eine weit verbreitete und flexible Zeichenkodierung.

Es ist ziemlich einfach, UTF-8 auf ihren Wikiseiten zu ermöglichen. Aktuelle PmWiki-Versionen enthalten die UTF-8-Datei, die standardmäßig in der sample-config.php-Datei aktiviert ist.

UTF-8 in einem neuen Wiki aktivieren

Wenn Sie ein neues Wiki in irgend einer Sprache mit der neuesten PmWiki-Version aufsetzen, sollten Sie UTF-8 auf jeden Fall aktivieren. In der Zukunft wird PmWiki die UTF-8-Kodierung als Standard benutzen. Wenn Sie UTF-8 schon nutzen, müssen Sie später keine umfangreiche "Migration" auf UTF-8 vornehmen.

Um UTF-8 zu aktivieren, fügen Sie die folgende Zeile in der Nähe des Anfangs Ihrer config.php-Datei ein (die Datei docs/sample-config.php enthält dies Zeile bereits):

    include_once("scripts/xlpage-utf-8.php");

Diese Zeile sollte vor dem Aufruf der XLPage()-Funktion in internationalisierten Wikis stehen.

Speichern Sie Ihre config.php-Datei als UTF-8 (ohne BOM) kodiert. Das erlaubt Einträge mit UTF-8-kodierten Zeichen. Stellen Sie sicher, dass Ihr Editor das unterstützt und testen Sie das, indem Sie ein paar UTF-8-Zeichen von außerhalb des ASCII-Bereiches einfügen, die Sie dann in dem Editor sehen sollten ¹.

Wenn Sie UTF-8 so aktiviert haben, können Sie auch die Klassen 'rtl' und 'ltr' einsetzen, die anbieten, die Textrichtung auf von-rechts-nach-links oder von-links-nach-rechts einzustellen. Das ist nützlich für die Einschließung von von-rechts-nach-links-Skripten wie Arabisch, Farsi (Persisch), Hebräisch, Urdu und andere.

UTF-8 in existierenden Wikis aktivieren

Momentan ist dies nur möglich, wenn Ihre Gruppen- und Seiten-Namen sowie Ihre Upload-Namen keine internationalen Zeichen enthalten. Die Namen der Wikiseiten werden als Dateinamen benutzt und es gibt noch keinen einfachen Weg, diese Namen umzubenennen.

Wenn Ihr Wiki keine internationalen Seiten-/Gruppennamen enthält, führen Sie zuerst eine Aktualisierungen auf die jüngste Version durch. Um UTF-8 zu aktivieren, fügen Sie dann die folgenden Zeilen in der Nähe des Anfangs Ihrer config.php-Datei ein:

    include_once("scripts/xlpage-utf-8.php");
    $DefaultPageCharset = array(''=>'ISO-8859-1'); # siehe unten

Diese Zeilen sollten vor dem Aufruf der XLPage()-Funktion in internationalisierten Wikis stehen.

Die $DefaultPageCharset-Zeile soll helfen, einige Seiten zu berichtigen und korrekt zu behandeln, die fehlende oder falsche Attribute haben und in älteren PmWiki-Versionen erstellt wurden.

• Die meisten Wikis in europäischen Sprachen werden wahrscheinlich in der ISO-8859-1-Kodierung erstellt worden sein und sollten
  $DefaultPageCharset = array(''=>'ISO-8859-1');
  nutzen,
• Wikis in Tschechisch oder Ungarisch werden wahrscheinlich in der ISO-8859-2-Kodierung erstellt worden sein und sollten stattdessen die Zeile
  $DefaultPageCharset = array(''=>'ISO-8859-2', 'ISO-8859-1'=>'ISO-8859-2');
  nutzen,
• Wikis in Türkisch werden wahrscheinlich in der ISO-8859-9-Kodierung erstellt worden sein und sollten stattdessen die Zeile
  $DefaultPageCharset = array(''=>'ISO-8859-9', 'ISO-8859-1'=>'ISO-8859-9');
  nutzen.

Sie sollten auch die Datei wiki.d/.pageindex löschen. Diese Datei enthält einen Cache der Verweise und Wörter aus Ihren Seiten und wird für die Suche und für Seitenlisten benutzt. PmWiki baut diese Datei automatisch mit der neuen Kodierung wieder auf.

Unterstützung von Sprachen mit RTL-(von-rechts-nach-links)-Schreibweise

Sprachen wie Arabisch, Hebräisch, Farsi (Persisch), Urdu und andere werden von rechts nach links geschrieben. Die Klassen rtl und ltr können eingesetzt werden, um die Schreibrichtung unabhängig von der generellen Einstellung der Schreibrichtung der Seite einzustellen, zum Beispiel:

>>rtl<<
يتدفق هذا النص من اليمين إلى اليسار
>>ltr<<
Dieser Text fließt nach rechts.
>><<

Wenn Sie die Schreibrichtung für ein Wiki generell auf RTL einstellen wollen, können Sie zur config.php-Datei eine Zeile wie diese einfügen:

$HTMLStylesFmt['rtl'] = " body { direction:rtl; }"

Doch der Skin, den Sie benutzen, verlangt eventuell weitere Anpassungen, zum Beispiel um das Suchfeld und die Seitenaktionen auf die andere Seite zu bringen etc.

Einige Skins wie Amber haben volle RTL-Unterstützung.

Anmerkungen

• Sie müssen Ihre config.php-Datei in der UTF-8-Kodierung speichern, und zwar ohne die "Byte Order Mark (BOM)".
  Siehe Zeichensatz der config.php-Datei (deutsch).
• Diese Seite bezieht sich auf die jüngste Version von PmWiki. Siehe auch Cookbook:UTF-8 für weitere Tipps zu älteren Versionen (,englisch).
• Falls Ihre PmWiki-Installation die falsche Kodierung anzeigt oder eine UTF-8-Seite unerklärlicherweise in einer anderen Kodierung speichert, könnten Sie Ihre .htaccess-Einstellungen in dem Wurzelverzeichnis Ihrer gespeicherten Seiten kontrollieren.

für die Liste aller Seiten