====== WvdS.DokuWiki.i18n Plugin ======

**Vtičnik:** wvdsi18n\\
**Verzija:** 1.0.0\\
**Imenski prostor:** ''lib/plugins/wvdsi18n/''\\
**Avtor:** Wolfgang van der Stille <zeljko.petrusic@outlook.de>\\
**Licenca:** GPL 2

----

<note important>
**Migracija iz wvdslang:** Ta vtičnik nadomešča stari vtičnik ''wvdslang''.
Funkcionalnost preusmeritev je bila preseljena v vtičnik ''wvdscond'' (ločitev odgovornosti).
</note>

----

===== Definicija =====

Vtičnik **wvdsi18n** ponuja funkcije za internacionalizacijo večjezične vsebine:

  * **Prevajalski ključi** - Iz CSV datoteke
  * **Vgrajeni prevodi** - ''de:Besedilo|en:Text''
  * **Config vrednosti** - Z večjezičnim razčlenjevanjem
  * **Template vrednosti** - Z večjezičnim razčlenjevanjem

===== Primeri uporabe =====

  * **Večjezična navigacija** - Besedila menijev v različnih jezikih
  * **Prevedljivi UI elementi** - Gumbi, oznake, opozorila
  * **Integracije s predlogami** - Stranska vrstica, noga, glava
  * **Centralizirani prevodi** - Vsa besedila v eni CSV datoteki

----

===== Sintaksa =====

==== Prevajalski ključ ====

<code>
{{wvds:i18n>menu_home}}
{{wvds:i18n>menu_contact}}
</code>

Naloži vrednost iz ''i18n.csv'' na podlagi trenutnega jezika.

==== Eksplicitni jezik ====

<code>
{{wvds:i18n:de>menu_home}}
{{wvds:i18n:en>menu_home}}
</code>

Vsili določen jezik, neodvisno od brskalnika.

==== Vgrajeni prevod ====

<code>
{{wvds:i18n>de:Ja|en:Yes|sl:Da}}
{{wvds:i18n>de:Speichern|en:Save|sl:Shrani}}
</code>

Neposredni prevod brez CSV datoteke.

==== Config vrednost ====

<code>
{{wvds:i18n>conf:title}}
{{wvds:i18n>conf:tagline}}
</code>

Prebere DokuWiki konfiguracijo z večjezičnim razčlenjevanjem.

==== Template Config ====

<code>
{{wvds:i18n>tpl:footerText}}
{{wvds:i18n>tpl:topSidebarTitle}}
</code>

Prebere konfiguracijo predloge z večjezičnim razčlenjevanjem.

----

===== CSV Format =====

Prevodi so shranjeni v ''lib/plugins/wvdsi18n/i18n.csv'':

<code>
key,de,en,sl,it,hr
menu_home,Startseite,Home,Domov,Home,Početna
menu_contact,Kontakt,Contact,Kontakt,Contatto,Kontakt
button_save,Speichern,Save,Shrani,Salva,Spremi
</code>

^ Stolpec ^ Opis ^
| ''key'' | Edinstveni ključ |
| ''de'' | Nemški prevod |
| ''en'' | Angleški prevod |
| ... | Dodatni jeziki |

----

===== Zaznavanje jezika =====

Jezik se določi v naslednjem vrstnem redu:

  - **Pot imenskega prostora** - ''de:start'' → de
  - **Glava brskalnika** - ''Accept-Language: de-DE'' → de
  - **DokuWiki jezik** - ''$conf['lang']''
  - **Privzeto vtičnika** - ''defaultLang'' konfiguracija

----

===== Konfiguracija =====

^ Možnost ^ Privzeto ^ Opis ^
| ''enabled'' | 1 | Aktiviraj vtičnik |
| ''languages'' | de,en,sl,it,hr | Razpoložljivi jeziki |
| ''defaultLang'' | en | Privzeti jezik (rezerva) |
| ''langPosition'' | 0 | Pozicija jezika v imenskem prostoru (0 = prva raven) |

----

===== Primeri =====

==== Primer 1: Navigacija ====

<code>
===== {{wvds:i18n>menu_navigation}} =====
  * [[.:start|{{wvds:i18n>menu_home}}]]
  * [[.:docs:index|{{wvds:i18n>menu_docs}}]]
  * [[.:contact|{{wvds:i18n>menu_contact}}]]
</code>

**Rezultat (brskalnik: sl):**
  * Domov
  * Dokumentacija
  * Kontakt

==== Primer 2: Vgrajeno v gumbih ====

<code>
<button>{{wvds:i18n>de:Absenden|en:Submit|sl:Pošlji}}</button>
</code>

==== Primer 3: Noga s Template-Config ====

<code>
<footer>
{{wvds:i18n>tpl:footerText}}
</footer>
</code>

==== Primer 4: Eksplicitni jezik za povezave ====

<code>
Jeziki: [[.:de:start|{{wvds:i18n:de>menu_home}}]] |
        [[.:en:start|{{wvds:i18n:en>menu_home}}]] |
        [[.:sl:start|{{wvds:i18n:sl>menu_home}}]]
</code>

**Rezultat:**
  * Jeziki: Startseite | Home | Domov

----

===== Integracija v predloge =====

==== PHP uporaba ====

<code php>
<?php
// Naloži helper
$helper = plugin_load('helper', 'wvdsi18n');

if ($helper) {
    // Pridobi prevod
    echo hsc($helper->get('menu_home'));

    // Eksplicitni jezik
    echo hsc($helper->get('menu_home', 'en'));

    // Razčleni vgrajeno
    echo hsc($helper->parseMultilang('de:Ja|en:Yes'));

    // Template-Config
    echo hsc($helper->getTplConfig('footerText'));
}
?>
</code>

----

===== Migracija iz wvdslang =====

^ Staro (wvdslang) ^ Novo (wvdsi18n) ^ Status ^
| ''{{wvds:lang>key}}'' | ''{{wvds:i18n>key}}'' | Sintaksa spremenjena |
| ''{{wvds:lang:de>key}}'' | ''{{wvds:i18n:de>key}}'' | Sintaksa spremenjena |
| ''{{wvds:lang>de:X|en:Y}}'' | ''{{wvds:i18n>de:X|en:Y}}'' | Sintaksa spremenjena |
| ''{{wvds:redirect>...}}'' | ''{{wvds:redirect ...}}'' | Preseljeno v wvdscond |

==== Poišči in zamenjaj ====

<code>
Staro: {{wvds:lang>
Novo: {{wvds:i18n>

Staro: {{wvds:lang:
Novo: {{wvds:i18n:
</code>

----

===== Opombe o verzijah =====

^ Verzija ^ Datum ^ Spremembe ^
| 1.0.0 | 2026-01-29 | Prva izdaja (naslednik wvdslang) |

----

===== Glej tudi =====

  * [[.:wvdscond]] - Pogojna vsebina in preusmeritve
  * [[.:wvdssnippet]] - Ponovno uporabni HTML gradniki
  * [[.:flat]] - Predloga s preklopnikom jezika

----

===== Tehnična referenca =====

==== Razred: syntax_plugin_wvdsi18n ====

**Datoteka:** ''lib/plugins/wvdsi18n/syntax.php''

^ Metoda ^ Opis ^
| ''getType()'' | Vrne ''substition'' |
| ''getSort()'' | Vrne ''100'' |
| ''connectTo($mode)'' | Registrira i18n vzorce |
| ''handle($match, ...)'' | Razčleni sintakso in izvleče vsebino |
| ''render($mode, ...)'' | Vrne prevedeno besedilo |

==== Razred: helper_plugin_wvdsi18n ====

**Datoteka:** ''lib/plugins/wvdsi18n/helper.php''

^ Metoda ^ Opis ^
| ''get($key, $lang)'' | Pridobi prevod za ključ |
| ''parseMultilang($value, $lang)'' | Razčleni ''de:X|en:Y'' format |
| ''getConfig($key, $lang)'' | Pridobi DokuWiki-Config z razčlenjevanjem |
| ''getTplConfig($key, $lang)'' | Pridobi Template-Config z razčlenjevanjem |
| ''detectLanguage()'' | Zazna trenutni jezik |
| ''getLanguages()'' | Vrne konfigurirane jezike |

----

<wvds:audit stack="doku" title="wvdsi18n Plugin">
  <wvds:include ref="code:qualitaet" critical="true">[x][x][x][x]</wvds:include>
  <wvds:include ref="stacks:dokuwiki-php">[x][x][x][x][x]</wvds:include>
  <wvds:include ref="sicherheit:kritis" critical="true">[x][x][x][x][x]</wvds:include>
</wvds:audit>

~~DISCUSSION~~