Texto.de – Mein WordPress Magazin

WordPress Theme lokalisieren- Sprachdatei erstellen-Schritt für Schritt Anleitung

Ein WordPress Theme oder ein Wordpress Plugin für viele verschiedene Sprachen anzubieten ist extrem leicht, weil WordPress “gettext” in sich beheimatet. Für technik Freaks, dies ist eine Library, die Übersetzungen einfach machen sollte.

If you would like to read this tutorial in english, please visit Weblogtoolscollection.

Für nicht Technik Freaks, dieses gettext ermöglicht, dass Übersetzungen nicht im HTML Quelltext gemacht werden müssen.

Also die Sprachdatei wird ausgelagert-ist extra. Ein einziges Mal muss man die Templates von WordPress-also alle Dateien, die ein WordPress Theme hat bearbeiten.

In diesem Artikel erkläre ich wie man die Templates, die einzelnen Dateien eines WordPress Themes vorbereitet, anschließend wie man den Editor PoEdit dann verwendet. PoEdit gibt es für viele Betriebssysteme, sein System bleibt aber gleich.

Meine Erklärungen sind einfachst, denn wer PHP kann, der weiß ja auch so wie es geht.

WordPress Theme Templates für die Sprachdatei vorbereiten.

Einach eine Datei eines WP Themes mit einem Texteditor öffnen und nach “Worten” suchen oder ganzen Sätzen.

Beispiel aus meinem my-photo-blog.

Zuerst stand da wo:”Something about you.”

 <?php _e('Something about you.','mtsphoto') ;?>

Dies bedeutet:

<?php

PHP Du bekommst Arbeit.

_e('Something about you.','mtsphoto')

Findet PoEdit nachher wo einen Unterstrich mit einem “e”, dann weiß es:Jetzt muss ich übersetzen. Die Klammer und die Hochkoma mag PHP.

Something about you soll übersetzt werden, dann ein Koma, dann der Name des Projektes.

Eine Übersetzung ist ein Projekt und braucht daher einen Namen.

“mtsphoto” ist ein frei gewählter Name. Ich empfehle einen aussagekräftigen Namen und kurz. Keine Sonderzeichen, keine Ziffern, Groß und Kleinschreibung ist wichtig, daher am besten immer kleine Buchstaben,sonst vertippt man sich zuoft.

Der Freiraum zwischen den Hochkoma ist dann für die Übersetzung wichtig. Es macht also Unterschied, ob man

 <?php _e('Something about you.     ','mtsphoto') ;?>

oder

 <?php _e('Something about you.','mtsphoto') ;?>

getippt hat. Sorgsames Arbeiten erleichtert einiges.

 ;?>

PHP Dein Job ist aus.

Wie geht das, wenn da schon wo PHP beim Arbeiten ist.

Aus

<?php comments_number('Leave a reply', '1 Comment', '% Comments' );?> <?php the_title(); ?>

wird dann:

<?php comments_number(__('Leave a reply','mtsphoto'), __('1 Comment','mtsphoto'), __('% Comments','mtsphoto') );?>

So bereitet man alle zu übersetzenden Worte, Phrasen, Sätze vor.

WordPress Theme und Sprachdatei bekannt machen.

Im header.php Template oder zumindest in einem Template, das garantiert immer gebraucht wird, macht man die zukünftige Sprachdatei mit dem WordPress Theme bekannt.

Sonst weiß das WordPress Theme nicht, dass es da wo eine Datei gibt, die übersetzt.

Dies geht so:

<?php load_theme_textdomain('mtsphoto');?>

einfach erklärt: PHP lade Theme Text’hoheit’ “mtsphoto”.

PoEdit erzeugt jetzt die Sprachdatei,die man dann übersetzen kann.

Den Editor PoEdit kann man tatsächlich einfachst installieren.

PoEdit herunterladen. Die Ausführungsdatei anklicken, den Anweisungen während der Installationsroutine folgen. Kennt man ein englisches Wort nicht, hilft wie immer dict.leo.org.

PoEdit Einstellungen

PoEdit Datei==>Einstellungen

PoEdit das erste Mal öffnen und unter Datei==>Einstellungen den Namen und eine Emailadresse angeben. Mehr habe ich da nicht gemacht.

Eine Sprachdatei ist für PoEdit ein Katalog.

PoEdit neuen Katalog erstellen

Unter Projektinfo gibt man der Reihe nach an: Projektname – am besten den kurzen Namen, der auch in den Templates steht,also: “mtsphoto”.

Übersetzungsteam: Namen des Übersetzers.

Eine Emailadresse.

Sprache und dann Land kann man aus einer langen Liste auswählen.

Zeichensatz und Zeichensatz des Quellcodes ist zu 99,99% UTF 8.

PoEdit Pfad zum Katalog

PoEdit Pfad zum Katalog

Wenn die Sprachdatei einfach im Ordner des WordPress Themes liegt, dann gehört da zweimal einfach ein Punkt hin. PoEdit stellt sich da öfters an. Ich musste den Punkt dreimal angeben bis PoEdit sich diesen merkte. Also wenn was nicht geht diesen Pfad kontrollieren.

PoEdit Schlüsselwörter des Katalogs

PoEdit Schlüsselwörter des Katalogs

Die Schlüsselwörter sind einerseis der Unterstrich und das kleine e und ein doppelter Unterstrich. Auch hier musste ich zweimal auf das kleine gepunktete Kästchen klicken bis mir PoEdit erlaubte da die Schlüsselwörter einzutragen. Hat man sich vertippt kann man das Schlüsselwort mit Klick auf das “a|e” Kästchen bearbeiten.

PoEdit speichern unter de_DE

PoEdit speichern unter de_DE

Jetzt alles speichern. Datei==>Speichern unter==>WordPress Theme Ordner suchen und den Dateinamen de_DE vergeben. de_DE ist das Sprachländerkürzel für unsere schöne deutsche Sprache. Es ist sinnvoll dies so zu tun, denn 1. irgendwann gibt es zig solcher Sprachdateien in einem WP Theme, mit de_DE sieht man gleich welche Datei welche Sprache beinhaltet. 2. funktionierts sonst nicht wirklich gut.

PoEdit erstellt nach dem Speichern ganz automatisch zwei Dateien. Eine mit der Endung .mo eine mit der Dateiendung .po. Ich betrachte diese Dateien als Zwillinge, also nicht trennen.

PoEdit endlich übersetzen

Umlaute, Sonderzeichen

Mit einem Klick auf die Weltkugel müßte PoEdit jetzt alle zu übersetzenden Worte, Sätze etc. finden und in einer Liste anzeigen. Anklicken und im Feld unterhalb die Übersetzung hineintippen.

Aufpassen: Abstände sind wichtig. Umlaute sind wichtig. Diese müssen als Entities getippt werden.

PoEdit zeigt Fehler auf

Fehleranzeige

PoEdit zeigt in einer Statusleiste an, ob eine Übersetzung für den Editor verständlich ist.

Fehler finden

Wenn man nicht weiß wieso PoEdit mit der Übersetzung nicht zufrieden ist. Kann man unter Bearbeiten==>Verweis finden sich die Stelle im Quelltext anzeigen lassen.

Dort findet man oft einen Abstand oder wie meist bei den XYZ Kommentaren einen Fehler. Ausprobieren bis PoEdit in der Statusleiste überall zufrieden ist. Daran denken: Wortabstände sind ebenfalls wichtig.

Datei==>Speichern.

WordPress Theme mit Sprachdatei Kontrolle und mögliche Fehler

Das WordPress Theme hochladen und aktivieren.

Bleibt die Seite dann Weiß, so richtig schön jungfräulich Weiß hat man irgendwo in einem Template bei den Übersetzungsangaben einen PHP Fehler. Eine vergessene Klammer, ein Hochkoma nicht gemacht oder eines zuviel. Den Strichpunkt nicht angegeben. Das Fragezeichen verloren oder eine spitze Klammer.

Bleiben die Worte English, obwohl PoEdit keinen Fehler gemeldet hat, dann hat man vergessen in der header.php die Sprachdatei mit dem WordPress Theme bekannt zu machen. Erklärung wie das geht viel weiter oben.

Ich wünsche viel Freud mit dem lokalisierten WordPress Theme, auf dass es von China bis Afrika und sonst wo auf der Welt oft genutzt wird.

Andere Toturials zum Thema:

• Zyblog
• 49suns

War dies hilfreich so ist weitersagen ausdrücklichst erlaubt

ebenfalls interessante Artikel

• 9 Quick Tipps zur Sicherheit - oder Hilfe mein Blog wurde gehackt
• 8 Quick Tipps zu den WordPress Kommentaren und Pings und Trackbacks
• How To - Design Your Own WordPress Theme
• WordPress Theme Vorlage

• WordPress CMS Plugin Sidebar Modules Reloaded
• neue Info über WordPress 2.5

08.02.08 Tipps und Tricks, WordPress Quick Tipps · Gelesen: 11789 · heute: 23