Die Galerie mehrsprachig machen

Der Sportverein hat eine Partnerstadt in Frankreich, die Tante wohnt seit zwanzig Jahren in Kanada, und der Chor war im Sommer auf Konzertreise in Polen. Spätestens dann fragt jemand, ob die Fotos auch „auf Englisch“ zu sehen sind. Gemeint ist selten eine perfekt übersetzte Website. Meist reicht es, wenn ein Gast aus dem Ausland versteht, welches Album er gerade öffnet und was auf dem Bild passiert. Wer seine Galerie mehrsprachig machen möchte, sollte deshalb zuerst festlegen, welche Texte wirklich in zwei Sprachen erscheinen müssen und welche nicht.

Galerie mehrsprachig machen: große Ansicht mit deutsch-englischer Bildbeschreibung und dem Zähler „Image 2 of 4“

Zwei Sorten Text auf jeder Seite

Öffnen Sie eine beliebige Kategorieseite Ihrer Galerie und lesen Sie alles, was darauf steht. Sie finden zwei sehr verschiedene Arten von Wörtern. Die eine Sorte gehört zur Bedienung: der Link zurück zur Übersicht, der Satz mit der Bilderanzahl, „Schließen“ und „Nächstes Bild“ in der großen Ansicht. Diese Wörter sind auf jeder Seite gleich und ändern sich nie, egal wie viele Fotos Sie hochladen. Die andere Sorte stammt von Ihnen: Albumnamen, die Beschreibung einer Kategorie, die Zeile unter jedem Foto. Sie wächst mit jedem Bild.

Für die Planung macht das einen großen Unterschied, denn unterschätzt wird fast immer die zweite Sorte. Rechnen wir eine typische Vereinsgalerie durch: 12 Kategorien, zusammen 300 Fotos. Die Bedienung besteht aus vielleicht 15 bis 20 kurzen Begriffen, die übersetzen Sie an einem Abend einmal und sind fertig. Die eigenen Inhalte sind 12 Namen, 12 Beschreibungen und 300 Bildzeilen. Wenn Sie für jede Bildzeile eine halbe Minute brauchen, sitzen Sie zweieinhalb Stunden an den Fotos, und jede neue Veranstaltung bringt wieder 30 oder 40 Zeilen dazu. Der laufende Aufwand liegt also fast nie bei der Oberfläche, sondern bei Ihren eigenen Texten. Wer eine Galerie mehrsprachig machen will, plant deshalb vor allem Zeit für die Bildzeilen ein.

Drei Wege zur zweiten Sprache

Für die eigenen Texte gibt es drei praktikable Lösungen. Sie unterscheiden sich vor allem darin, was jedes neue Foto an Arbeit kostet.

Weg	Arbeit je neuem Foto	Passt, wenn …
Beide Sprachen in einem Feld, etwa „Herbst / Autumn“	einmal hochladen, eine Zeile etwas länger schreiben	die meisten Besucher Deutsch lesen und Gäste nur grob verstehen sollen
Eigene Kategorien je Sprache	zweimal hochladen, weil ein Foto immer nur in einer Kategorie liegt	es nur wenige, ausgewählte Alben für ausländische Gäste gibt
Zwei getrennte Galerien	alles doppelt: Upload, Beschreibung, Pflege	beide Sprachgruppen gleich wichtig sind und Sie Zeit dafür haben

Die Faustregel daraus: Wenn Sie allein pflegen und die Galerie regelmäßig wächst, nehmen Sie den Schrägstrich. Wenn nur ein einzelnes Album, etwa die Reise in die Partnerstadt, für Gäste gedacht ist, legen Sie dafür eine zweite, englische Kategorie an und lassen den Rest deutsch. Zwei vollständige Galerien lohnen sich erst, wenn wirklich zwei Redaktionen dahinterstehen. Ein häufiger Fehler ist der umgekehrte Weg: Man will die Galerie mehrsprachig machen und startet ehrgeizig mit drei Sprachen. Nach einem halben Jahr sind nur noch die deutschen Beschreibungen aktuell, und die englische Fassung wirkt verlassen. Eine zweite Sprache, die konsequent mitgepflegt wird, macht mehr Eindruck als drei halbe.

Galerie mehrsprachig machen mit dem Bildergalerie-Script

Das Bildergalerie-Script ist in Version 3.15 einsprachig deutsch. Es gibt keine Sprachdateien, keine Sprachauswahl für Besucher und keine zweite Spalte für übersetzte Beschreibungen. Im Änderungsprotokoll steht eine mehrsprachige Oberfläche erst unter „Geplant“. Wer die Galerie trotzdem mehrsprachig machen will, muss wissen, woher jeder Text auf der Seite kommt. Davon hängt ab, ob Sie ihn in der Verwaltung, in der Vorlage oder nur im PHP-Code ändern können.

Text in der Galerie	Wo er steht	So übersetzen Sie ihn
„Bilder anzeigen...“, „Sie befinden sich:“, „Es sind 4 Bilder in der Kategorie …“, „« Zurück zur Übersicht“	fest im PHP-Code in `inc/functions.php`	nur durch Änderung im Code, die jedes Update wieder überschreibt
Zähler „Bild 2 von 4“ sowie die Hinweise „Schließen“, „Nächstes Bild“ und „Vorheriges Bild“ in der großen Ansicht	Optionen in `js/lightbox.js`	ohne Codeänderung über `window.LightboxOptions` in der Vorlage
Seitentitel „Bildergalerie“, Sprachangabe `lang="de"`	Vorlage `tpl/bildergalerie.html`	direkt in der Vorlage ändern
Kategorienamen, Kategoriebeschreibungen, Bildbeschreibungen	Datenbank	selbst in der Verwaltung zweisprachig eintragen

Die große Ansicht lässt sich am saubersten anpassen. Tragen Sie in tpl/bildergalerie.html vor der Zeile mit js/lightbox.js einen kleinen Skriptblock ein: window.LightboxOptions = { labelImage: "Image", labelOf: "of", labelClose: "Close", labelNext: "Next image", labelPrev: "Previous image" };. Der Zähler zeigt dann „Image 2 of 4“, und weil die Werte in der Vorlage stehen, bleibt js/lightbox.js unverändert. Das funktioniert, weil lightbox.js seine eigenen Standardwerte mit einem vorhandenen window.LightboxOptions überschreibt. Für eine zweisprachige Galerie gehen auch kurze Doppelformen wie labelClose: "Schließen / Close". Die sichtbare Schaltfläche „SCHLIESSEN“ unter dem Bild ist allerdings eine Grafik (images/closelabel.gif); labelClose ändert nur den Hinweis, der beim Darüberfahren erscheint. Für eine englische Beschriftung tauschen Sie die Grafik gegen eine eigene in gleicher Größe. Sichern Sie die Vorlage vor jedem Update, denn beim Hochladen der neuen Version wird auch sie überschrieben.

Welche Texte Sie mit Bordmitteln in die zweite Sprache bringen und welche deutsch bleiben, fasst das Diagramm zusammen. Die Namen und Beschreibungen tragen Sie selbst ein, die große Ansicht steuern Sie über die Vorlage. Was im PHP-Code steht, bleibt ohne Eingriff deutsch.

Animiertes Diagramm: Auf einer Kategorieseite werden Kategoriename und Zähler der großen Ansicht zweisprachig, weil sie aus Datenbank und Vorlage kommen; Navigationspfad und Bilderanzahl stehen im PHP-Code und bleiben deutsch — Drei Quellen, drei Antworten: Datenbank und Vorlage lassen sich übersetzen, der PHP-Code nicht ohne Eingriff.

Zwei deutsche Sätze auf der Kategorieseite können Sie ausblenden, wenn sie stören. Unter „Einstellungen“ im Abschnitt „Kategorieseiten“ schalten Sie „Anzahl der Bilder anzeigen“ auf „Nein“, dann entfällt „Es sind 4 Bilder in der Kategorie …“. Schalten Sie dort „Navigationspfad anzeigen“ ab, verschwindet „Sie befinden sich:“, allerdings steht dann unter den Bildern der Link „« Zurück zur Übersicht“, ebenfalls deutsch. Ganz frei von deutschen Bedienwörtern wird die Galerie also ohne Codeänderung nicht.

Praxisfall: Deutsch und Englisch im selben Feld

Am wenigsten Aufwand macht die Schreibweise mit Schrägstrich direkt in den Feldern der Verwaltung. Eine Bildbeschreibung darf höchstens 500 Zeichen lang sein. „Sonnenuntergang am Strand / Sunset at the beach“ braucht 47 davon, Platz ist also reichlich. Enger wird es auf der Startseite: Jede Kachel zeigt nur einen Kurztext aus der Kategoriebeschreibung, ab Werk 75 Zeichen. Hat der deutsche Teil schon 60 Zeichen, bleiben für das Englische 15 übrig, der Rest endet mit „…“. Stellen Sie deshalb unter „Einstellungen“ im Abschnitt „Startseite der Galerie“ das Feld „Länge der Kategoriebeschreibung“ höher, etwa auf 160 Zeichen. Erlaubt sind 1 bis 1000. Auf der Kategorieseite selbst steht ohnehin die ganze Beschreibung, und Zeilenumbrüche bleiben dort erhalten, sodass Sie beide Sprachen untereinander schreiben können. Bei Bildbeschreibungen klappt das nicht, dort entfernt die Galerie Zeilenumbrüche, der Schrägstrich bleibt also die beste Trennung.

Laden Sie viele Bilder hoch, hilft „Dateiname als Beschreibung“ im Abschnitt „Beschreibungen“ (Standard: Ja). Aus sonnenuntergang-sunset.jpg wird die Beschreibung „Sonnenuntergang sunset“, die Sie danach unter „Bilder verwalten“ in die richtige Form bringen. Getrennte Galerien je Sprache sind möglich, aber aufwendig: Eine zweite Installation braucht einen eigenen Ordner, etwa /gallery/, und eine eigene leere Datenbank, weil sich ein Tabellenpräfix nicht einstellen lässt. Bilder pflegen Sie dann doppelt. Die Schrägstrich-Lösung können Sie an einer Testkategorie ausprobieren, wenn Sie das Bildergalerie-Script kostenlos herunterladen.

Die letzten deutschen Wörter: Anpassung im PHP-Code

Wer die Galerie mehrsprachig machen und dabei auch das letzte deutsche Bedienwort ersetzen will, etwa für eine rein englische Projektseite, kommt an inc/functions.php nicht vorbei. Die Texte stehen dort in zwei Funktionen: bildergalerie_startseite() baut die Startseite mit den Kategorie-Kacheln, bildergalerie_frontend_ausgabe() die Seite einer einzelnen Kategorie. Diese Zeichenketten kommen vor:

Seite	Deutscher Text im Code	Mögliche englische Fassung
Startseite, je Kachel	„Bilder anzeigen...“, „1 Bild“, „12 Bilder“, „Noch keine Bilder“	„View photos...“, „1 photo“, „12 photos“, „No photos yet“
Kategorieseite	„Sie befinden sich:“, „Bildergalerie-Übersicht“, „Es sind 4 Bilder in der Kategorie …“	„You are here:“, „Gallery overview“, „There are 4 photos in …“
Leere Kategorie oder ausgeschalteter Navigationspfad	„In dieser Kategorie sind noch keine Bilder.“, „« Zurück zur Übersicht“	„This album is still empty.“, „« Back to overview“
Galerie ganz ohne Inhalt	„Es sind noch keine Bilder oder Kategorien vorhanden.“	„No photos or albums yet.“

So gehen Sie vor, ohne die Galerie zu beschädigen:

Laden Sie inc/functions.php per FTP herunter und legen Sie eine unveränderte Kopie beiseite.
Öffnen Sie die Datei in einem Editor, der UTF-8 speichert, und suchen Sie die Texte aus der Tabelle wörtlich.
Ersetzen Sie nur die Wörter zwischen den einfachen Anführungszeichen. Punkte, Leerzeichen und Zeichen wie « bleiben stehen.
Laden Sie die Datei zurück und öffnen Sie die Startseite, eine Kategorie mit Bildern und eine leere Kategorie.

Ein Fehler kommt bei englischen Texten besonders oft vor: der Apostroph. Die Zeichenketten stehen in einfachen Anführungszeichen, ein „Don't“ beendet die Zeichenkette mitten im Wort, und die Galerie zeigt statt der Seite nur noch einen PHP-Fehler. Schreiben Sie dann Don\'t oder formulieren Sie ohne Apostroph um, etwa „No photos yet“ statt „There aren't any photos“. Wichtiger noch ist die Pflege: Ein Update überschreibt inc/functions.php vollständig. Notieren Sie sich deshalb jede geänderte Zeichenkette in einer kleinen Textdatei und übertragen Sie die Änderungen nach jedem Update erneut. Bei vier oder fünf Texten dauert das zehn Minuten. Wer die Galerie mehrsprachig machen möchte, ohne nach jedem Update Code nachzuziehen, fährt mit den abgeschalteten Einstellungen und der englischen großen Ansicht gut, denn dann bleiben auf einer Kategorieseite mit Bildern nur noch „« Zurück zur Übersicht“ und auf der Startseite „Bilder anzeigen...“ deutsch.

Häufige Fragen

Bevor Sie die ersten Beschreibungen umschreiben, klären diese Fragen die häufigsten Stolpersteine.

Soll ich die Sprachangabe lang="de" in der Vorlage ändern?

Nur wenn die Seite überwiegend englisch ist. Die Angabe in tpl/bildergalerie.html sagt Browsern und Vorleseprogrammen, in welcher Sprache sie den Text aussprechen sollen. Bei der Schrägstrich-Lösung bleibt Deutsch die Hauptsprache, lang="de" stimmt also. Eine Galerie, deren Texte Sie ganz auf Englisch umgestellt haben, bekommt lang="en", und dann passt auch ein englischer Seitentitel wie „Photo gallery“.

Die geänderte Datei wurde nicht als UTF-8 gespeichert. Das Bildergalerie-Script liefert seine Seiten in UTF-8 aus, und ein Editor, der in einem anderen Zeichensatz speichert, macht aus „ä“ oder „é“ zwei fremde Zeichen. Speichern Sie tpl/bildergalerie.html ausdrücklich als UTF-8 ohne BOM und laden Sie die Datei erneut hoch. Dasselbe gilt für inc/functions.php, falls Sie dort Texte geändert haben.

Sollte ich pro Sprache ein eigenes Album anlegen oder beide Sprachen in ein Feld schreiben?

Das hängt davon ab, wie oft Sie neue Fotos einstellen. Bei einer wachsenden Galerie ist der Schrägstrich im selben Feld die einzige Lösung, die Sie auf Dauer durchhalten. Eigene Alben je Sprache lohnen sich nur für wenige ausgewählte Sammlungen, weil jedes Foto dafür zweimal hochgeladen werden muss.

Hat das Bildergalerie-Script eine Sprachumschaltung?

Nein, in Version 3.15 nicht. Besucher können nicht zwischen Sprachen wechseln, und die festen Texte der Galerie stehen deutsch im Code. Übersetzen lassen sich ohne Codeänderung die Beschriftungen der großen Ansicht über window.LightboxOptions, der Seitentitel in der Vorlage und alle Ihre eigenen Texte wie Kategorienamen und Bildbeschreibungen.