Mastodon
Zuletzt aktualisiert am

Publii Hacks {} Nummer 2: Themes übersetzen

Die Standardsprache der Publii-Themes ist englisch, so heißt es etwa Featured und Last updated on. Doch glücklicherweise lassen sich Themes einfach übersetzen.

Featured, Follow us, Authors, Tags etc. Wer all diese Strings eindeutschen möchte, braucht dazu nur einen Texteditor und diese kurze Anleitung. Nötig sind nur drei einfache Schritte, hier am Beispiel des Themes Cortado:

  1. Datei kopieren: Dokumente > Publii > themes > themeName > themeName.lang.json
    Also Dokumente > Publii > themes > Cortado > Cortado.lang.json

  2. Datei einfügen in: Dokumente > Publii > sites > siteName > input > languages
    Hier: Dokumente > Publii > sites > wokushi > input > languages

  3. Datei im Language-Ordner editieren

Dazu taugt jeder Texteditor, es müssen lediglich die englischen Ausdrücke durch deutsche ersetzt werden. Übrigens muss Publii nach dem Speichern der Sprachdatei nicht erst neu gestartet werden; Die deutschen Sprachschnipsel werden automatisch beim nächsten Rendering übernommen.

Die roten Zeichenketten werden durch die übersetzten Strings ersetzt. Fertig ist die Übersetzung! Auch teilweise Übersetzungen sind in Ordnung, in diesem Falle werden die deutschen Strings angezeigt wo vorhanden, und die englischen, wo keine Übersetzung eingetragen wurde.

Aber warum so kompliziert?

Findige Leser mögen sich jetzt fragen, warum man nicht gleich die Datei im Themes-Ordner editieren kann. Die Antwort: das kann man. Allerdings ist diese fester Bestandteil des Themes, sodass sie bei einem Update des Themes überschrieben würde - unter Verlust der Übersetzung.
Daher haben wir mit der Kopie im Sites-Ordner ein sogenanntes override file erstellt. Diese Datei ist site-spezifisch und nicht theme-spezifisch, sie überlebt daher auch Updates des Themes. Dieses Vorgehen ergibt also Sinn und ist die Mühe des kurzen Kopiervorgangs wert.

Fazit und Verfügbarkeit

Publii bietet eine einfache Möglichkeit, Themes mit Bordmitteln zu lokalisieren, ohne dass diese Lokalisierung durch ein Update des Themes verloren ginge.
Die Anleitung im englischen Original ist hier zu finden.
Publii ist kostenlos verfügbar, freut sich aber über Spenden.

 

Comments