WvdS Internationalization (i18n)

i18n naredi vsebino strani večjezično, ne da bi stran podvojili: oznaka kljuc na svojem mestu vstavi besedilo v trenutnem jeziku – iz preglednice CSV, iz nastavitve ali neposredno iz oznake. Paket je namenjen avtorjem, ki pripravljajo menije, gumbe in gradnike v več jezikih, in razvijalcem predlog, ki ista besedila potrebujejo v kodi PHP.

Hitri začetek: izpis enega besedila v dveh jezikih – najkrajša pot do prvega rezultata, v treh korakih.

Ustvarite preglednico prevodov → Vstavite oznako na stran → Preverite izbiro jezika

Vtičnik wki18n zagotavlja funkcije za internacionalizacijo večjezične vsebine:

• Prevajalski ključi – iz datoteke CSV
• Prevodi v oznaki – de:Text|en:Text
• Vrednosti nastavitev – z razčlenjevanjem večjezičnih vrednosti
• Vrednosti predloge – z razčlenjevanjem večjezičnih vrednosti

• Večjezična navigacija – besedila menijev v različnih jezikih
• Prevedljivi elementi vmesnika – gumbi, napisi, namigi
• Vključitev v predloge – stranska vrstica, noga, glava
• Prevodi na enem mestu – vsa besedila v eni datoteki CSV

Startseite
Kontakt

Naloži vrednost iz preglednice prevodov (glej Oblika CSV) za trenutni jezik.

Startseite
Home

Vsili določen jezik ne glede na brskalnik.

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

Prevod neposredno v oznaki, brez datoteke CSV.

conf:title
conf:tagline

Prebere nastavitev DokuWiki in razčleni večjezične vrednosti v njej.

tpl:footerText
tpl:topSidebarTitle

Prebere nastavitev predloge in razčleni večjezične vrednosti v njej.

Lastni prevodi sodijo v data/wki18n/i18n.csv (natančneje: <savedir>/wki18n/i18n.csv). Datoteka je zunaj mape vtičnika, preživi vsako posodobitev, spletni strežnik pa je ne streže:

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

Vtičnik v lib/plugins/wki18n/i18n.csv prinese le nekaj splošnih ključev (menu_home, menu_contact, menu_back); to datoteko vsaka namestitev zamenja. Lastna preglednica se prebere za njo in prevlada za vsak ključ in jezik: vrstica v njej nadomesti priloženo vrednost v vsakem jeziku, ki ga izpolni, prazna celica pa jo pusti. Vrstica, ki se začne z #, je komentar.

Jezik se določi v tem vrstnem redu (helper.php, detectLanguage()):

1. Jezik, ki ga je obiskovalec izrecno izbral – ?lang=sl v zahtevi, sicer izbira, zapomnjena iz ene od prejšnjih zahtev (piškotek). Velja šele po zavestnem kliku v izbiri jezika; kdor nikoli ne izbira, tega ne opazi.
2. Pot imenskega prostora – de:start → de
3. Jezik okna, iz katerega je bila stran odprta – okno, kot je pogovorno okno za predstavnostne datoteke, ohrani jezik, v katerem je bilo odprto; ta se ne zapomni
4. Glava brskalnika – Accept-Language: de-DE → de
5. Jezik DokuWiki – $conf['lang']
6. Privzeta vrednost vtičnika – nastavitev defaultLang

Vsaka vrednost se preveri s seznamom languages; oznaka jezika, ki je na njem ni, se preskoči.

Privzeto je vrednost, ki jo vtičnik prinese s seboj. Na tej namestitvi je languages nastavljen na de,en,sl.

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

Rezultat (brskalnik: sl):

• Domov
• Projektna dokumentacija
• Kontakt

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

<footer>
tpl:footerText
</footer>

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

Rezultat:

• Jeziki: Startseite | Home | Domov

<?php
// Naloži pomočnika (helper)
$helper = plugin_load('helper', 'wki18n');
 
if ($helper) {
    // Prevod za ključ
    echo hsc($helper->get('menu_home'));
 
    // Izrecno izbran jezik
    echo hsc($helper->get('menu_home', 'en'));
 
    // Razčleni prevod v oznaki
    echo hsc($helper->parseMultilang('de:Ja|en:Yes'));
 
    // Nastavitev predloge
    echo hsc($helper->getTplConfig('footerText'));
}
?>

Staro: {{wk:lang>
Novo: {{wk:i18n>

Staro: {{wk:lang:
Novo: {{wk:i18n:

• WvdS.DokuWiki.Cond Plugin – pogojna vsebina in preusmeritve
• Snippet – izseki HTML za večkratno uporabo
• WvdS.DokuWiki.Flat Template – predloga s preklopnikom jezika

Datoteka: lib/plugins/wki18n/syntax.php

Datoteka: 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

Vtičnik: wki18n
Različica: 1.0.0
Imenski prostor: lib/plugins/wki18n/
Avtor: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs)
Licenca: GPL 2