Russische/kyrillische Inhalte in TYPO3  

Bei größeren internationalen Webseiten ist nicht immer der Standard gesetzt, dass die Schriftzeichen den europäischen entsprechen. Will man russische Inhalte einpflegen, gilt es einige Vorbereitungen zu treffen. Dieser Artikel widmet sich einem groben Überblick über russische Schriftzeichen, Zeichencodierungen und ASCII-Code.

Werden bei standardmäßiger Konfiguration von TYPO3 russische/kyrillische Zeichen eingegeben, wandelt TYPO3 diese in entsprechende ASCII-Codes um. Das hängt mit der Zeichencodierung zusammen, die standardmäßig auf ISO steht.

Aus:

Услуги и решения

wird dann bspw:

&a1806;&a1806;&a1806;&a1806;&a1806;&a1806;&a180 6;

(Hinweis: Ich verstehe kein russisch, weiß also nicht, was ich geschrieben habe. )

Nun also zur Konfiguration.

Vorbereitungen der TYPO3-Konfiguration für russische Schriftzeichen

Standardmäßig ist in TYPO3 ISO-Codierung eingestellt. Um kyrillische (z.B. russische) Schriftzeichen darzustellen, muss die Zeichencodierung auf UTF-8 umgestellt werden. Dies geschieht folgendermaßen, auf zwei Wegen.

1. Install Tool
   In der Option forceCharset muss der Wert utf-8 eingetragen werden.
2. localconf.php
   In der localconf.php (/typo3/typo3conf/localconf.php) muss Folgendes hinzugefügt werden:

   1	$TYPO3_CONF_VARS['BE']['forceCharset'] = "utf-8";

Nun muss noch folgender Code im Haupttemplate-Setup eingefügt werden:

1
2

page.config.metaCharset = utf-8
page.config.additionalHeaders = Content-Type:text/html;charset=utf-8

Hinweis: Haben Sie bereits deutsche Texte eingefügt, werden aufgrund dieser Änderungen alle vorhandenen Umlaute als Fragezeichen/Kästchen angezeigt. Dies rührt daher, dass die Sonderzeichen (noch) nicht für UTF-8 erstellt werden. Um diesem Umstand Abhilfe zu schaffen, greifen wir auf eine Erweiterung zurück, um nicht alle Umlaute nachträglich manuell umwandeln zu müssen.

Die Anzeige russischer Schriftzeichen

Die Erweiterung heißt convert2utf8 und kann über das Extension Repository heruntergeladen werden.

Hinweis: Erstellen Sie ein Backup der Datenbank, bevor Sie die Extension ausführen! Mit SSH-Zugang folgendermaßen, um den Dump in das aktuelle Verzeichnis abzulegen:

1

mysqldump --opt -Q -h servername -u dbusername -p databasename > backupname.sql

Nach Eingabe des Datenbank-Passwortes wird der Dump direkt auf den Server geschrieben.

Zurück zur Erweiterung: Ist sie installiert, lässt sie sich über das Kontext(-popup-)menü der root-Seite der Webseite aufrufen über “Convert to UTF8″. Hat man im ersten Schritt alle zu konvertierenden Seiten ausgefwählt, stellt man im zweiten Schritt einfach “ISO-8859-1 (Western Europe)” ein, denn das ist die Standardcodierung von TYPO3. Im finalen Schritt beginnt die Extension die Umwandlung.

Ist diese abgeschlossen, empfiehlt es sich den Seitenbaum neu zu laden und den FE-Cache zu löschen.

Die erfolgreiche Umstellung auf UTF-8

Im FE werden nun die vormals als Fragezeichen/Kästchen dargestellten Umlaute wieder korrekt angezeigt. Im BE werden eingegebene russische Zeichen auch als solche gespeichert und angezeigt. Mission erfolgreich.

Werden externe Templatedateien verwendet, die einfach inkludiert werden (z.B. von Extensions), müssen diese ebenfalls in UTF-8 konvertiert werden. Dazu müssen die Dateien einfach in einem Editor unter UTF-8 gespeichert werden.

Sonderfall tt_news

Da die Datenbank-Tabellen der tt_news-Erweiterung nicht zum System gehören, werden diese leider nicht mit durch die Erweiterung convert2utf8 in UTF-8 umgewandelt. Daher muss man diese Tabelle manuell umwandeln. Allerdings gestaltet sich das mit den entsprechenden Mitteln auch recht problemlos.

Zunächst sollte man die tt_news-Tabelle exportieren. Das geht per Kommandozeile oder einfach mit phpMyAdmin. Hat man den Dump in einer .sql-Datei auf dem Server, lässt sich diese mit dem Kommandozeilen-Befehl recode in UTF-8 umwandeln:

1

recode latin..utf8 sql-dump-datei.sql

Diese Datei kann dann wieder mit Zeichencodierung UTF-8 in die TYPO3-Datenbank importiert werden.

Weiterführende Links

Folgende Links verfolgen jeweils andere Wege, um das selbe wie hier Beschriebene zu erreichen. Hilfreich, falls dieser Artikel nicht zu einer Lösung beitragen kann.

• Konvertieren einer TYPO3-Installation zu UTF-8
• Migration TYPO3 auf UTF-8
• Von ISO-8859-1 zu UTF-8 in PHP und MySQL