TDF Wiki/Multilingua

From The Document Foundation Wiki
Jump to navigation Jump to search
This page is a translated version of the page TDF Wiki/Multilingual and the translation is 95% complete.
Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Esperanto • ‎Jawa • ‎Nederlands • ‎dansk • ‎español • ‎français • ‎galego • ‎italiano • ‎lietuvių • ‎português • ‎português do Brasil • ‎română • ‎slovenčina • ‎Ελληνικά • ‎русский • ‎українська • ‎עברית • ‎العربية • ‎فارسی • ‎中文(台灣)‎ • ‎日本語 • ‎한국어

Questa pagina riguarda il contenuto del Wiki Multilingua presente sul TDF Wiki.

Gnome-dialog-warning.svg

Informazione
Per le pagine di nuova creazione non usate il tipo di traduzione OrigLang. Attualmente stiamo passando all'utilizzo dell'estensione MediaWiki Translate.

Contesto

Questa pagina contiene alcuni suggerimenti importanti per coloro che modificano i contenuti del wiki. Siete pregati di leggere questa pagina prima di aggiungere sul wiki contenuti tradotti o localizzati.

Contenuto con tematiche prettamente locali

Tali pagine sono scritte esclusivamente nella lingua locale e non vengono tradotte. Si tratta di sottopagine di una pagina il cui nome è costituito dal codice della lingua scritto in caratteri maiuscoli.

Esempi:

 https://wiki.documentfoundation.org/DE
 https://wiki.documentfoundation.org/DE/Team
 https://wiki.documentfoundation.org/DE/Veranstaltungen
 ...
 https://wiki.documentfoundation.org/FR
 https://wiki.documentfoundation.org/FR/Blabla
 

Contenuto con tematiche globali

Queste pagine sono inserite in Inglese e vengono tradotte nelle diverse lingue. Le pagine tradotte sono delle sottopagine denominate con il codice della loro lingua. Il processo di traduzione viene gestito dall'estensione Translate.

Per rendere traducibile una pagina, seguite questi passaggi:

  1. Inserite il testo da tradurre all'interno di blocchi <translate></translate>
  2. Usate il template {{#translation:}} per aggiungere il suffisso della lingua agli elementi come menu, categorie o collegamenti a pagine locali
  3. Aggiungete il blocco con il menu delle lingue <languages/>
  1. Dopo aver salvato la pagina, fate clic sul collegamento in alto che dice Segna questa pagina per la traduzione
  2. Controllate che sia tutto corretto e fate clic sul pulsante in fondo che dice Segna questa pagina per la traduzione

Dopo che la pagina è stata contrassegnata per la traduzione, l'estensione Translate aggiungerà automaticamente i marcatori del tipo <!--T:1--> che identificano le stringhe da tradurre. Affinché un blocco di testo venga suddiviso in stringhe, dev'essere preceduto e seguito da righe bianche. Per forzare la suddivisione delle stringhe, potete aggiungere ulteriori marcatori <translate></translate>. Prestate particolare attenzione agli elenchi puntati e numerati.

Quando aggiungete o modificate il contenuto nella pagina sorgente, in cima alla pagina apparirà il messaggio: Questa pagina è stata modificata da quando era stata segnata per la traduzione. Fate clic sul collegamento "segnata per la traduzione" al fine di aggiornare il sistema di traduzione seguendo la stessa procedura usata inizialmente per segnare la pagina per la traduzione.

In una situazione ideale i traduttori dovebbero vedere una minima quantità di markup del wiki. Avere il markup di una tabella o di un modello all'interno delle stringhe da tradurre, per i traduttori è frustrante e crea confusione. Cercate di lasciare i simboli di markup al di fuori dei blocchi <translate></translate>.

Il titolo della pagina è traducibile per default, ma potete modificare questa impostazione con la casella di controllo "Consenti la traduzione del titolo della pagina" nel momento in cui segnate la pagina per la traduzione. Il titolo della pagina è la prima stringa traducibile nell'elenco delle stringhe. Nel sistema di traduzione e nell'interfaccia la stringa ha un nome del tipo: "Translations:Faq/General/127/Titolo della pagina/ru", mentre le altre stringhe hanno degli identificativi numerici come il "4" in "Translations:Faq/General/127/4/ru".

Alle volte è necessario assegnare ad una pagina un titolo da visualizzare diverso dal nome del percorso della pagina. Un tanto non è raccomandato e dovrebbe essere evitato. In questi casi, usate il template Rename come segue: {{Rename|Nuovo nome}}. Il template assicurerà che non vi siano errori nel titolo delle pagine tradotte.

Alle volte è necessario poter accedere al sorgente della pagina wiki in Inglese senza i contrassegni <!--T:1-->. Ciò è possibile aggiungendo /en alla fine del percorso della pagina e modificando poi il sorgente. Un tanto vi permetterà di copiare la struttura di una pagina in una nuova pagina (come ad esempio quella delle Note di rilascio).

Quando usate il template {{#translation:}} per aggiungere il suffisso della lingua locale ai collegamenti, assicuratevi di utilizzare percorsi assoluti e non relativi che iniziano con /. Se lo usate con dei percorsi relativi finirete con avere due volte il codice della lingua ed un collegamento non funzionante.

Se un blocco contiene solamente un numero, invece di tradurlo, potete usare la the parola magica (magic word) {{formatnum:1234}}. Quando necessario, il numero verrà automaticamente formattato usando gli stili non occidentali.

Qui di seguito trovare un esempio di una pagina predisposta per la traduzione. Notate la separazione dell'elenco puntato e dei contenuti della tabella.

 {{TopMenu{{#translation:}}}}
 {{Menu{{#translation:}}}}
 {{Menu.Documentation{{#translation:}}}}
 <languages/>

 <translate>
 == Hello World ==

 * We must take the world as we find it
 * When we are gone, let the world be flooded
 * The world is as fools wish it to be
 * It's a small world!
 </translate>
 <translate>
 * Crows are black the world over
 * He slipped once and all the world knew about it
 * The world is like a market, the one does business and the other does none
 * Huge though the world is, I always miss when I hit at it
 </translate>


 {| class="wikitable"
 |-
 | <translate>Cell content</translate>
 |-
 | {{sometemplate|<translate>Text content for a template</translate>}}
 |-
 | {{formatnum:1.10714871779409|NOSEP}}
 |}

 [[Special:MyLanguage/Development/Create_a_Hello_World_LibreOffice_extension|<translate>Tutorial on creating a Hello World extension</translate>]]

 [[Category:Documentation]]
 

Considerato che il contenuto delle tabelle può essere noioso da predisporre per le traduzioni, è stato creato uno script di supporto. Per usarlo copiate il contenuto di un articolo del wiki in un file di testo salvato in locale e passate il nome del file come argomento dello script. I contenuti verranno riscritti all'interno dello stesso file. Nel caso in cui dei numeri interi, a virgola mobile o complessi, siano l'unico contenuto di una cella della tabella, verrà usata la parola magica formatnum. Lo script richiede che siano installati i pacchetti: wikitextparser, regex e wcwidth. Fate clic su Espandi per vedere lo script.


#!/usr/bin/env python3
#
# uses the library https://github.com/5j9/wikitextparser
import sys
import wikitextparser as wtp

def is_float_or_complex(value):
    try:
        float(value)
        return True
    except:
        return False
    try:
        complex(value)
        return True
    except:
        return False

with open(sys.argv[1]) as f:
    doc = f.read()

p = wtp.parse(doc)
tables = p.get_tables()

for t in tables:
    for row in t.cells():
        for cell in row:
            c = cell.value.lstrip().rstrip()
            if len(c) > 0:
                if c.isnumeric() or is_float_or_complex(c):
                    # Add Left-To-Right Mark so minuses will stay in place with RTL languages
                    if c[0] == '-':
                        cell.value = ' {{formatnum:‎' + c + '|NOSEP}} '
                    else:
                        cell.value = ' {{formatnum:' + c + '|NOSEP}} '
                else:
                    cell.value = ' <translate>' + c + '</translate> '

with open(sys.argv[1], 'w') as f:
    f.write(p.string)

Migrare al sistema attuale contenuti già tradotti con il vecchio metodo

In passato, il wiki di TDF utilizzava una procedura di traduzione che faceva uso dei template denominati OrigLang e Lang. Questi template visualizzavano un menu che collegava la pagina sorgente a quelle delle traduzioni. In questo elenco potete trovare tutti i contenuti tradotti che fanno uso del template Lang: Special:WhatLinksHere/Template:Lang. Allo stesso modo, potete ottenere l'elenco delle pagine che usano il template OrigLang.

L'estensione Translate comprende uno strumento di migrazione, che aiuta a trasferire al nuovo sistema i contenuti già tradotti. Se i blocchi della pagina sorgente e della traduzione corrispondono esattamente, la migrazione sarà molto semplice. Altrimenti dovrete copiare ed incollare stringhe all'interno dei campi di inserimento.

La migrazione si effettua come segue:

  1. Dopo aver segnato una pagina per la traduzione, attendete qualche minuto, in modo che il server possa elaborare la pagina
  2. Puntate alla pagina Special:PageMigration
  3. Nel campo inserite il percorso della pagina da migrare comprensivo del codice della lingua, come ad esempio: MioPercorso/MiaPagina/de per un'ipotetica traduzione in Tedesco
  4. Fate clic sul pulsante Importa
  5. Ripulite i contenuti nei campi di inserimento che contengono le vecchie traduzioni (eliminate, per esempio, tutti i template di menu inutili)
  6. In fondo alla colonna con le traduzioni, non potete lasciare dei campi di imputazione vuoti o in più, perciò eliminateli facendo clic sull'icona del cestino a fianco ad essi
  7. Dopo aver ripulito e messo tutto in ordine, fate clic sul pulsante Salva

Ricordatevi che, usando il collegamento Cronologia e facendo clic su di una revisione precedente, potete sempre vedere la vecchia versione di una pagina tradotta.

Se volete vedere il sorgente di una vecchia revisione, copiate il suo collegamento dalla cronologia e visitatelo dopo aver questo aggiunto alla sua fine: &action=edit

Alcune volte non ha senso usare lo strumento di migrazione. Lasciare degli elementi di markup al di fuori dei blocchi da tradurre può, in molti casi, confondere lo strumento. In questi casi, possono essere utili i suggerimenti proposti dalle memorie di traduzione.

Messaggi nella Barra laterale

Per tradurre i messaggi relativi a ”Partecipa” e ”Supporta LibreOffice!”, dovete inviare le traduzioni a uno degli amministratori del wiki. Gli altri sono messaggi di sistema tradotti a monte in MediaWiki.

Le traduzioni degli elementi aggiuntivi della Barra laterale è stata impostata usando i passaggi indicati nella pagina di aiuto dell'estensione Translate traduzione di elementi non strutturati. Per tradurre i messaggi, gli amministratori devono solamente visitare la pagina Special:Translate/wiki-sidebar.

I collegamenti alla ”Pagina principale” e ”Partecipa” usano il prefisso Special:MyLanguage, che li fa puntare direttamente alla pagina tradotta, se questa è disponibile.