Synchronfassung und Kino: das Modul und der Installer¶

Hinter einem Drupal CMS, das nach der Installation wirklich deutsch ist, stehen zwei eigenständige Projekte auf drupal.org. Sie arbeiten gut zusammen, aber keines ist ein Teil des anderen.

Im Bild unserer Erklärung ist das Modul das Synchronstudio: Es sorgt dafür, dass der Film selbst deutsch spricht. Der Installer ist das Kino, in dem der Film gezeigt wird.

Die Faustregel: Das Modul übersetzt, der Installer repariert¶

Das Modul fasst nur an, was einer Vorlage gehört: ihre Inhalte und ihre Einstellungen. Den Code anderer Projekte ändert es nie. Es bleibt ja nach der Installation auf der Website und soll dort keine Überraschungen hinterlassen.

Alles andere erledigt der Installer: Er übersetzt die Bildschirme der Installation und korrigiert Fehler in fremdem Code, die eine deutsche Installation sonst verhindern würden. Wo genau welche Lösung steckt, zeigt die Spalte „Projekt“ in der Fehlertabelle.

Warum es den Installer braucht¶

Ein deutscher Film in einem englischen Kino¶

Stellen Sie sich vor, Sie gehen ins Kino, um die deutsche Fassung eines Films zu sehen. Die Synchronisation ist hervorragend. Aber an der Kasse, auf den Plakaten und bei den Durchsagen ist alles Englisch. Und zweimal reißt der Film, bevor er überhaupt angefangen hat.

So fühlte sich eine deutsche Installation von Drupal CMS an, und damit fing alles an: Der Drupal CMS German Installer ist im März 2026 entstanden, gut zwei Monate bevor es Default Content Locale überhaupt gab. Zuerst ging es nur darum, die Installation selbst deutsch zu machen. Dass danach auch die Vorlagen englisch sind, war das nächste Problem, und aus ihm ist das Modul entstanden.

Das Foyer: die Installation selbst¶

Die Installation ist der erste Kontakt mit Drupal CMS: Sprache wählen, Datenbank eintragen, der Website einen Namen geben, eine Vorlage aussuchen, ein Konto anlegen. Diese Bildschirme waren anfangs fest auf Englisch.

Seit Drupal CMS 2.2 lädt der Installer eine offizielle deutsche Übersetzung von localize.drupal.org. Sie ist gut, aber nicht vollständig:

• Der neue Sprachdialog und die Abschlussseite („Your site is almost ready“) fehlen dort.
• Die Beschreibungen der Vorlagen kommen aus einer Online-Liste und lassen sich offiziell gar nicht übersetzen. Eine Vorlage erschien sogar als „Drush Site-Install“ ohne jede Beschreibung.
• Die Auswahlseite duzte („Wähle eine Website-Vorlage aus“), während der Rest der Installation siezt.
• Die Statusmeldungen während der Installation („Installed 20 modules“, „Completed 3 of 22“) waren englisch, weil Drupal die deutschen Übersetzungen erst ganz am Ende lädt.

Das Modul kann hier nicht helfen: In diesem Moment gibt es noch gar keine Website, auf der es installiert sein könnte. Das kann nur etwas, das sich in den Installer selbst einklinkt. Der Installer ergänzt die fehlenden Texte deshalb direkt im Browser. Sobald localize.drupal.org einen dieser Texte kennt, erscheint die offizielle Übersetzung, und der Installer muss dort nichts mehr tun.

Der Filmriss: Fehler, die eine Installation abbrechen¶

Beim Übersetzen aller Vorlagen sind wir auf Fehler gestoßen, die eine deutsche Installation gar nicht erst ankommen lassen:

• Summit wurde in der Sprache „undefiniert“ eingerichtet, jede Seite brach danach ab.
• Convivial Gov stellte die Website mitten in der Installation auf Englisch um.
• Fünf Vorlagen (Archimedes, Healthcare, Pulse, CareSphere, Convene) ließen sich überhaupt nicht installieren, auch nicht auf Englisch.
• Eine neue Version der Vorlagen-Engine Twig ließ schon die erste Seite der Installation abstürzen, für alle.
• Mehrere Themes schreiben Sätze wie „Follow us on“ so fest in ihren Code, dass keine Übersetzungsdatei sie erreicht.

Alle diese Fehler stecken in anderen Projekten: in Drupal Core, in Drupal CMS, in Canvas, in den Vorlagen und ihren Themes. Richtig beheben lassen sie sich nur dort. Bis dahin hilft der Installer mit kleinen, gezielten Korrekturen von außen. Jede prüft vorher, ob sie noch nötig ist, und tut nichts mehr, sobald ein Projekt den Fehler selbst behoben hat. Alle Fehler haben wir als Fehlerberichte für die jeweiligen Projekte aufgeschrieben.

Die Vorstellung beginnt pünktlich: der richtige Zeitpunkt¶

Das Modul muss aktiv sein, bevor eine Vorlage ihre Inhalte anlegt. Kommt es auch nur einen Schritt zu spät, bleibt alles englisch. Der Drupal-CMS-Installer sieht dafür keinen Platz vor. Der German Installer fügt deshalb vor jedem Inhaltsimport einen eigenen Schritt ein, der das Modul installiert.

Für alle anderen Sprachen und für alle, die den German Installer nicht nutzen möchten, bringt das Modul inzwischen einen eigenen Weg mit: drush dcle:site-templates (siehe unten).

Ein Installer, der sich selbst überflüssig machen will¶

Nach der Installation hat der German Installer seine Arbeit getan. Ein zweiter Aufruf seines Skripts entfernt ihn wieder und setzt den Drupal-CMS-Installer auf den Originalzustand zurück. Auf der fertigen Website bleibt von ihm nichts übrig außer dem Modul und einigen Zusatzmodulen für deutschsprachige Websites.

Das eigentliche Ziel ist, dass es ihn eines Tages nicht mehr braucht: wenn die Fehler in den jeweiligen Projekten behoben sind und localize.drupal.org alle Texte der Installation kennt. Das Modul dagegen bleibt nützlich, solange Vorlagen englische Beispielinhalte mitbringen.

Welches Projekt brauche ich?¶

Sie installieren Drupal CMS auf Deutsch: Nehmen Sie den Drupal CMS German Installer. Er übersetzt die Installation, korrigiert die bekannten Fehler und bindet das Modul für die Vorlagen ein.