TDF Wiki/Multilingua

    From The Document Foundation Wiki
    This page is a translated version of the page TDF Wiki/Multilingual and the translation is 74% complete.
    Outdated translations are marked like this.

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

    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/Team
     https://wiki.documentfoundation.org/DE/Veranstaltungen
     ...
     https://wiki.documentfoundation.org/FR/Documentation/Publications
     
    

    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. Usate il prefisso Special:MyLanguage quando vi collegate a pagine traducibili locali
    4. 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.

    Suggerimenti

    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.

    You can do a partial update of a translation while still leaving the status as outdated by clicking the downward-pointing triangle next to the translation unit name and selecting Show in wiki editor. You will be taken to a separate editing page where you can make your changes and save them while leaving the !!FUZZY!! special word at the start of the text intact.

    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 lavorate su una pagina con molti blocchi di traduzione, a volte capita di commettere un errore nell'aprire o chiudere i tag di traduzione. In una situazione come questa, l'anteprima della pagina mostrerà tutto il markup della traduzione insieme al contenuto. Fate clic su Salva modifiche ha un effetto sorprendentemente utile, tuttavia: invece di salvare, mostrerà una visualizzazione ridotta del testo di origine, aiutandovi a trovare l'errore.

    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. È meglio utilizzare il parametro NOSEP per i numeri interi per evitare di mostrare i separatori delle migliaia in quanto possono confondere i lettori. Per i numeri decimali è meglio non usare NOSEP, perché salterebbe la localizzazione del separatore decimale.

    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}}
     {{Menu}}
     {{Menu.Documentation}}
     <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>}}
     |-
     | <bdi>{{formatnum:-1.10714871779409}}</bdi>
     |-
     | {{formatnum:110714871779409|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
    
    def wrap_translate(string):
        if string.endswith(('}}', '</translate>')) or (len(string) < 2 and not string.isnumeric()):
            return string
        elif string.isnumeric() or is_float_or_complex(string):
            if string.isnumeric():
                format_end = '|NOSEP}}'
            else:
                format_end = '}}'
            # Add bdi element so minuses will stay in place with RTL languages
            if string[0] == '-':
                return ' <bdi>{{formatnum:' + string + format_end + '</bdi> '
            else:
                return ' {{formatnum:' + string + format_end + ' '
        else:
            return ' <translate>' + string + '</translate> '
    
    with open(sys.argv[1]) as f:
        doc = f.read()
    
    p = wtp.parse(doc)
    tables = p.get_tables()
    
    for t in tables:
        if t.caption:
            caption = t.caption.strip()
            if len(caption) > 0:
                t.caption = wrap_translate(caption)
        for row in t.cells():
            for cell in row:
                c = cell.value.strip()
                if len(c) > 0:
                    cell.value = wrap_translate(c)
    
    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.