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 fuer mehrsprachige Inhalte:

• Uebersetzungs-Keys - Aus CSV-Datei
• Inline-Uebersetzungen - de:Text|en:Text
• Config-Werte - Mit Mehrsprach-Parsing
• Template-Werte - Mit Mehrsprach-Parsing

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

Startseite
Kontakt

Laedt den Wert aus i18n.csv basierend auf der aktuellen Sprache.

Startseite
Home

Erzwingt eine bestimmte Sprache, unabhaengig vom Browser.

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

Direkte Uebersetzung ohne CSV-Datei.

conf:title
conf:tagline

Liest DokuWiki-Konfiguration mit Mehrsprach-Parsing.

tpl:footerText
tpl:topSidebarTitle

Liest Template-Konfiguration mit Mehrsprach-Parsing.

Die Uebersetzungen werden in lib/plugins/wki18n/i18n.csv gespeichert:

key,de,en,sl,it,hr
menu_home,Startseite,Home,Domov,Home,Pocetna
menu_contact,Kontakt,Contact,Kontakt,Contatto,Kontakt
button_save,Speichern,Save,Shrani,Salva,Spremi

Die Sprache wird in folgender Reihenfolge ermittelt:

1. Namespace-Pfad - de:start → de
2. Browser-Header - Accept-Language: de-DE → de
3. DokuWiki-Sprache - $conf['lang']
4. Plugin-Standard - defaultLang Konfiguration

===== 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