Schnelleinstieg: Einen Text zweisprachig ausgeben

Der kürzeste Weg von „Plugin ist installiert“ zu „ein und dieselbe Quellzeile erscheint auf der deutschen Seite deutsch und auf der englischen englisch“. Drei Schritte, etwa zehn Minuten.

• wki18n ist installiert und im Erweiterungsmanager aktiviert.
• Das Wiki ist nach Sprachen gegliedert: Die Sprache ist der erste Namensraum einer Seitenkennung, also de:wiki:start und en:wiki:start. Liegt die Sprache bei Ihnen tiefer, setzen Sie langPosition auf diesen Index, statt Seiten zu verschieben.
• Sie dürfen Seiten anlegen.

Administration → Konfiguration, Abschnitt wki18n:

enabled      = 1
languages    = de,en
defaultLang  = de
langPosition = 0

languages entscheidet, welcher oberste Namensraum überhaupt als Sprache gilt. Ein Namensraum, der nicht in dieser Liste steht, bleibt ein gewöhnlicher Namensraum — eine Seite intern:notizen ist also nicht gefährdet.

Legen Sie de:wiki:start und en:wiki:start an. Sie brauchen vorerst keinen Inhalt außer dem aus Schritt 3.

Schreiben Sie in beide Seiten dieselbe Zeile:

de:Willkommen|en:Welcome

Leerzeichen um die senkrechten Striche werden übergangen, de:Willkommen | en:Welcome ist also gleichwertig und besser lesbar.

• de:wiki:start zeigt Willkommen, en:wiki:start zeigt Welcome. Eine Quellzeile, zwei Ausgaben.
• Sehen Sie auf derselben Seite auf DokuWikis eigene Beschriftungen — Schaltfläche Seite bearbeiten, Suchfeld, Spurlinie. Auf der englischen Seite sind sie englisch. Das Plugin setzt die Oberflächensprache aus der Seite; ohne das stünde ein englischer Text in einer deutschen Oberfläche.
• Fehlt für die aktuelle Sprache eine Übersetzung, erscheint die Fassung aus defaultLang — nicht eine Leerstelle.

• wkacmenu — Menütitel übersetzen, indem der Übersetzungsbaustein in {{wk:title>…}} geschachtelt wird.
• wkopengraph — eine Vorschaukarte für alle Sprachen.
• wki18n — Referenz: Konfigurationswerte übersetzen, erzwungene Sprache …, Helfer für eigenen Code.