WvdS.DokuWiki.I18n Plugin

Plugin: wvdsi18n
Versione: 1.0.0
Namespace: lib/plugins/wvdsi18n/
Autore: Wolfgang van der Stille zeljko.petrusic@outlook.de
Licenza: GPL 2

Il plugin wvdsi18n fornisce un sistema di traduzione multilingue per pagine DokuWiki. Supporta sia file di lingua centrali che traduzioni inline, con rilevamento automatico della lingua basato sul namespace.

• Interfacce multilingue - Voci di menu, pulsanti, etichette
• Documentazione - Testi che devono apparire in più lingue
• Template - Elementi riutilizzabili con supporto linguistico
• Widget - Snippet con contenuto specifico per lingua

key
conf:title

de:Testo tedesco|en:Testo inglese|it:Testo italiano

key
intro_text

lib/plugins/wvdsi18n/lang/
├── de/
│   └── translations.php
├── en/
│   └── translations.php
├── sl/
│   └── translations.php
├── hr/
│   └── translations.php
└── it/
    └── translations.php

lib/plugins/wvdsi18n/lang/it/translations.php:

<?php
$lang['menu_home'] = 'Home';
$lang['menu_docs'] = 'Documentazione';
$lang['menu_contact'] = 'Contatto';
$lang['menu_back'] = 'Indietro';
$lang['greeting'] = 'Benvenuto nella nostra documentazione';

  * [[start|Home]]
  * [[docs:start|Documentazione progetto]]
  * [[contatto|Contatto]]

Risultato (pagina italiana):

• Home
• Documentazione
• Contatto

de:Willkommen|en:Welcome|it:Benvenuto|hr:Dobrodošli

Risultato: Visualizza il testo nella lingua del namespace corrente.

File: lib/plugins/wvdssnippet/snippets/footer.html

<footer>
    <p>de:Alle Rechte vorbehalten|en:All rights reserved|it:Tutti i diritti riservati</p>
</footer>

La versione inglese è: greeting

Visualizza sempre il testo in inglese, indipendentemente dal namespace corrente.

La lingua viene determinata dalla posizione nel namespace:

de:docs:start     → Tedesco
en:docs:start     → Inglese
it:docs:start     → Italiano
hr:docs:start     → Croato
sl:docs:start     → Sloveno

1. Lingua del namespace corrente
2. Lingua predefinita (configurazione)
3. Prima lingua disponibile nella traduzione inline
4. Chiave come fallback (per debug)

Tramite Admin → Configurazione → wvdsi18n:

Snippet possono usare tag i18n:

<nav>
    <a href="?id=start">Home</a>
    <a href="?id=docs">Documentazione progetto</a>
</nav>

Il template usa l'helper i18n per:

• Footer multilingue
• Titoli sidebar
• Etichette switcher lingua

• Chiavi significative - Usare nomi descrittivi: menu_home invece di m1
• File centrali - Usare file lingua per testi frequenti
• Inline per casi speciali - Usare inline per testi unici
• - Aggiungere a pagine con contenuto multilingue

• WvdS.DokuWiki.Cond Plugin - Contenuti condizionali e redirect
• WvdS.DokuWiki.Snippet Plugin - Blocchi HTML riutilizzabili
• WvdS.DokuWiki.Flat Template - Template con supporto multilingue

File: lib/plugins/wvdsi18n/syntax.php

File: lib/plugins/wvdsi18n/helper.php