WvdS Internationalization (i18n)

i18n macht Seiteninhalt mehrsprachig, ohne die Seite zu vervielfachen: die Marke schluessel setzt an Ort und Stelle den Text der aktuellen Sprache ein – aus einer CSV-Tabelle, einer Einstellung oder unmittelbar aus der Marke. Gedacht ist das Paket für Autoren, die Menüs, Schaltflächen und Bausteine in mehreren Sprachen führen, und für Vorlagen-Entwickler, die dieselben Texte aus PHP heraus brauchen.

Schnelleinstieg: Einen Text zweisprachig ausgeben – der kürzeste Weg zum ersten Ergebnis, in drei Schritten.

Übersetzungstabelle anlegen → Marke auf einer Seite setzen → Sprachwahl prüfen

Das wki18n Plugin bietet Internationalisierungs-Funktionen für mehrsprachige Inhalte:

• Übersetzungs-Keys - Aus CSV-Datei
• Inline-Übersetzungen - de:Text|en:Text
• Config-Werte - Mit Mehrsprach-Parsing
• Template-Werte - Mit Mehrsprach-Parsing

• Mehrsprachige Navigation - Menu-Texte in verschiedenen Sprachen
• Übersetzbare UI-Elemente - Buttons, Labels, Hinweise
• Template-Integrationen - Sidebar, Footer, Header
• Zentralisierte Übersetzungen - Alle Texte in einer CSV-Datei

Startseite
Kontakt

Lädt den Wert aus der Übersetzungstabelle (siehe CSV-Format) für die aktuelle Sprache.

Startseite
Home

Erzwingt eine bestimmte Sprache, unabhängig vom Browser.

de:Ja|en:Yes|sl:Da
de:Speichern|en:Save|sl:Shrani

Direkte Übersetzung ohne CSV-Datei.

conf:title
conf:tagline

Liest DokuWiki-Konfiguration mit Mehrsprach-Parsing.

tpl:footerText
tpl:topSidebarTitle

Liest Template-Konfiguration mit Mehrsprach-Parsing.

Eigene Übersetzungen gehören in data/wki18n/i18n.csv (genau: <savedir>/wki18n/i18n.csv). Die Datei liegt außerhalb des Plugin-Ordners, übersteht jede Aktualisierung und wird vom Webserver nicht ausgeliefert:

key,de,en,sl
menu_home,Startseite,Home,Domov
menu_contact,Kontakt,Contact,Kontakt
button_save,Speichern,Save,Shrani

Das Plugin bringt in lib/plugins/wki18n/i18n.csv nur wenige allgemeine Schlüssel mit (menu_home, menu_contact, menu_back); diese Datei ersetzt jede Installation. Die eigene Tabelle wird danach gelesen und gewinnt je Schlüssel und Sprache: Eine Zeile dort überschreibt den mitgelieferten Wert in jeder Sprache, die sie füllt; eine leere Zelle lässt ihn stehen. Eine Zeile, die mit # beginnt, ist ein Kommentar.

Die Sprache wird in folgender Reihenfolge ermittelt (helper.php, detectLanguage()):

1. Ausdrückliche Wahl des Besuchers - ?lang=sl in der Anfrage, sonst die gemerkte Wahl aus einer früheren Anfrage (Cookie). Sie gilt erst nach einem bewussten Klick in einer Sprachwahl; wer nie wählt, merkt davon nichts.
2. Namespace-Pfad - de:start → de
3. Sprache des öffnenden Fensters - ein Fenster wie der Medien-Dialog behält die Sprache, in der es geöffnet wurde; sie wird nicht gemerkt
4. Browser-Header - Accept-Language: de-DE → de
5. DokuWiki-Sprache - $conf['lang']
6. Plugin-Standard - defaultLang Konfiguration

Jeder Wert wird gegen die Liste languages geprüft; ein Kürzel, das dort nicht steht, wird übergangen.

Der Standard ist der Wert, den das Plugin mitbringt. Auf dieser Instanz ist languages auf de,en,sl gesetzt.

===== menu_navigation =====
  * [[..:start|Startseite]]
  * [[..:docs:index|Projekt-Dokumentation]]
  * [[..:contact|Kontakt]]

Ergebnis (Browser: de):

• Startseite
• Projekt-Dokumentation
• Kontakt

<button>de:Absenden|en:Submit|sl:Pošlji</button>

<footer>
tpl:footerText
</footer>

Sprachen: [[..:de:start|Startseite]] |
          [[..:en:start|Home]] |
          [[..:sl:start|Domov]]

Ergebnis:

• Sprachen: Startseite | Home | Domov

<?php
// Helper laden
$helper = plugin_load('helper', 'wki18n');
 
if ($helper) {
    // Uebersetzung holen
    echo hsc($helper->get('menu_home'));
 
    // Explizite Sprache
    echo hsc($helper->get('menu_home', 'en'));
 
    // Inline parsen
    echo hsc($helper->parseMultilang('de:Ja|en:Yes'));
 
    // Template-Config
    echo hsc($helper->getTplConfig('footerText'));
}
?>

Alt: {{wk:lang>
Neu: {{wk:i18n>

Alt: {{wk:lang:
Neu: {{wk:i18n:

• WvdS.DokuWiki.Cond Plugin - Bedingte Inhalte und Redirects
• WvdS Snippet Plugin - Wiederverwendbare HTML-Bausteine
• WvdS.DokuWiki.Flat Template - Template mit Sprachwechsler

Datei: lib/plugins/wki18n/syntax.php

Datei: lib/plugins/wki18n/helper.php

<wk:audit stack=„doku“ title=„wki18n Plugin“>

<wk:include ref="code:qualitaet" critical="true">[x][x][x][x]</wk:include>
<wk:include ref="stacks:dokuwiki-php">[x][x][x][x][x]</wk:include>
<wk:include ref="sicherheit:kritis" critical="true">[x][x][x][x][x]</wk:include>

</wk:audit>

DISCUSSION

Plugin: wki18n
Version: 1.0.0
Namespace: lib/plugins/wki18n/
Autor: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs)
Lizenz: GPL 2