Avvio rapido: rendere un testo bilingue

Il percorso più breve da «il plugin è installato» a «una stessa riga sorgente appare in tedesco sulla pagina tedesca e in inglese su quella inglese». Tre passi, circa dieci minuti.

• wki18n è installato e attivato nel gestore delle estensioni.
• Il wiki è organizzato per lingua: la lingua è il primo namespace di un identificatore di pagina, quindi de:wiki:start e en:wiki:start. Se da voi il segmento linguistico si trova più in profondità, impostare langPosition su quell'indice invece di spostare tutte le pagine.
• Potete creare pagine.

Amministrazione → Configurazione, sezione wki18n:

enabled      = 1
languages    = de,en
defaultLang  = de
langPosition = 0

languages decide quale namespace di primo livello valga come lingua. Un namespace che non figura in questo elenco resta un namespace ordinario: una pagina interno:note non corre rischi.

Creare de:wiki:start e en:wiki:start. Per ora non serve altro contenuto oltre a quello del passo 3.

Scrivere la stessa riga in entrambe le pagine:

de:Willkommen|en:Welcome

Gli spazi attorno alle barre verticali vengono ignorati, quindi de:Willkommen | en:Welcome è altrettanto valido e più leggibile.

• de:wiki:start mostra Willkommen, en:wiki:start mostra Welcome. Una riga sorgente, due esiti.
• Osservare sulla stessa pagina le etichette proprie di DokuWiki — il pulsante di modifica, il campo di ricerca, la traccia. Sulla pagina inglese sono anch'esse in inglese. Il plugin imposta la lingua dell'interfaccia a partire dalla pagina; senza di esso un testo inglese starebbe dentro un'interfaccia tedesca.
• Dove per la lingua corrente manca una traduzione, compare la versione di defaultLang — non uno spazio vuoto.

• wkacmenu — titoli di menu tradotti.
• wkopengraph — un'unica scheda di anteprima per tutte le lingue.
• wki18n (in tedesco) — la pagina del pacchetto: traduzione dei valori di configurazione, lingua forzata …, helper per il proprio codice.