Benvenuti

Questa pagina descrive come personalizzare il supporto per le lingue di MoinMoin. I nuovi visitatori del wiki possono visualizzare una pagina iniziale nella loro lingua preferita oppure è possibile far vedere una sola pagina specifica. È anche possibile bloccare la lingua usata nelle traduzioni delle pagine e delle frasi del wiki.

Per prima cosa andare alla pagina SystemPagesSetup e installare le pagine di sistema e di aiuto per tutte le lingue desiderate.

Fatto questo, leggere quanto segue per decidere cosa fare e per modificare la configurazione del wiki.

Per gli impazienti (è necessario impostare page_front_page affinché questa pagina non sia sempre la pagina principale):

    # choose this, if most wiki content is in a single language
    page_front_page = u"LaMiaPaginaIniziale"

Oppure

    # choose this, if wiki content is maintained in multiple languages
    page_front_page = u"FrontPage"

Se si segue la via del single language, è possibile copiare parte del contenuto di PaginaPrincipale nella pagina scelta per page_front_page. In alternativa, se l'azione di rinomina è abilitata nel wiki, è possibile rinominare PaginaPrincipale impostando quel nome (per esempio Benvenuti) nella variabile page_front_page.

Se si segue la via del multiple language, ricordarsi di modificare tutte le traduzioni di FrontPage.

Se si segue la via del multiple languages, le persone che raggiungono il proprio wiki verrano direzionate alla pagina principale corrispondente alla lingua impostata nel browser. Se non è stata preparata quella pagina, visualizzeranno la pagina predefinita e avranno l'impressione che il wiki sia vuoto o mal configurato.

Interfaccia utente e language_default

MoinMoin cerca di adattare l'interfaccia utente alla lingua preferita dall'utente.

Se l'utente imposta una particolare lingue nelle sue preferenze, tale lingua verrà usata per l'interfaccia, ma l'utente non dovrebbe nemmeno fare tutto questo se il suo browser è stato configurato correttamente.

Se non ci sono impostazioni preferite per la lingua, moin cerca di adattarsi alla lingua configurata nel browser. Quindi, se il browser indica a moin che preferisce l'inglese canadese piuttosto, il tedesco o l'inglese in generale e moin ha installato il supporto per il tedesco e l'inglese, ma non per l'inglese canadase, l'utente avrà l'interfaccia in tedesco.

Se non è disponibile una lingua comune nella configurazione del browser e in moin e se è stata impostata l'opzione language_ignore_browser = True, moin userà la lingua configurata in language_default. Questo è anche il caso in cui il browser non specifichi alcuna lingua.

Tipicamente, viene impostato language_ignore_browser = True se è in esecuzione un wiki locale non accessibile da utenti internazionali e il wiki viene gestito in una sola lingua. Ricordarsi di specificare la sola lingua in language_default!

Pagine di sistema, compresa la PaginaPrincipale

L'archivio di MoinMoin contiene le pagine di sistema (come ModificheRecenti) in diverse lingue (consultare SystemPagesGroup) e seleziona la lingua corretta nello stesso modo dell'interfaccia.

Per esempio, se navi_bar contiene un collegamento a FrontPage, moin cercherà prima una traduzione di FrontPage nella lingua dell'utente. In questo modo, se la lingua dell'utente è il tedesco (de), otterrà una traduzione di FrontPage che è StartSeite (internamente moin utilizza MoinMoin/i18n/de.py, che viene creato automaticamente da de.po). Moin userà quindi StartSiete se esiste, altrimenti utilizzerà FrontPage.

Questo va bene se si vuole avere una FrontPage e le sue traduzioni. Ma se tutto questo non è ciò che si vuole?

È possibile cancellare tutte le traduzioni di FrontPage, verranno usate solo se esistono, o semplicemente usare la variabile page_front_page per scegliere una pagina diversa da FrontPage come pagina principale (per esempio IlMioProgetto). Moin cercherà quindi le traduzioni per IlMioProgetto, ma solitamente non ne troverà alcuna e verrà usata la pagina IlMioProgetto qualsiasi lingua sia impostata.

Traduzioni integrate Vs. specificate dall'utente

MoinMoin tipicamenete utilizza le traduzioni integrate (consultare MoinMoin/i18n/*) per le traduzioni dell'interfaccia utente e dei nomi delle pagine in navi_bar.

C'è comunque la possibilità di personalizzare la navi_bar con ciò che si vuole. Moin non ha alcuna traduzione integrata per questo. Per fare questo, basta creare una pagina come GermanDict, FrenchDict, ItalianDict (usaer il nome inglese della lingua) e inserire un elenco di valori che definiscono le traduzioni per i termini inglesi. Per esempio, in GermanDict:

 MyProject:: MeinProjekt
 LatestNews:: NeuesteNachrichten

Notare lo spazio prima di ogni riga. Se non viene inserito, Moin non considera le voci come voci di dizionario. Per maggiori informazioni consultare WikiDict.

Moin userà quindi le pagine dizionario se non può trovare dei valori corrispondenti nelle traduzioni integrate.

Come specificare la lingua della pagina

È raccomandato specificare la lingua della pagina nell'intestazione della pagina in questo modo:

#language it

Il nome della lingua è il codice iso-639-1 per quella lingua. Le lingue non supportate da moin vengono ignorate.

Questo è molto importante se il wiki è composto da contenuti in diverse lingue, come le pagine in ebraico, che devono essere visualizzate con direzione destra-sinistra, e le pagine in italiano, che devono essere visualizzate con direzione sinistra-destra.

Nelle vecchie versioni del wiki, le pagine di sistema avevano un commento ##language:it. Questo commento non ha alcun effetto e dovrebbe essere modificato in #language it. Per sistemare le vecchie pagine nel proprio wiki, eseguire scripts.repair_language.py nella directory data del wiki. Eseguire un backup della directory data prima di fare questo!