Help:Extension:Translate/Page translation example/it

Benvenuto! Dopo aver completato questo tutorial, saprai come creare e gestire pagine traducibili usando l'estensione Translate. Cercheremo di mantenere questo tutorial il più breve possibile, mentre introdurremo tutti i concetti e le attività di base. Dopo averlo completato, puoi leggere la documentazione approfondita sulla funzionalità di traduzione delle pagine.

Passo 1: Prima di iniziare
Questo tutorial presuppone che l'estensione Translate sia già installata e configurata. Forse hai già in mente una pagina che ha bisogno di essere tradotta, altrimenti puoi usare la pagina di esempio fornita sotto per provare i passi di questo tutorial nel tuo wiki.

Questa è una pagina che descrive l'immaginario comune di Fréttinga.

Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. == Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.


 * 1. Vai alla pagina Fréttinga nel tuo wiki (o una pagina di prova) e clicca sulla scritta che permette di creare la pagina.
 * 2. Incolla quanto scritto sopra e salva.

Passo 2: Preparazione
Ora abbiamo una pagina con del testo. Se la pagina è ancora soggetta a molti cambiamenti, potrebbe essere meglio aspettare finché la frequenza delle modifiche non cala ad un livello normale prima di aggiungere questa pagina al sistema di traduzione. Questo per evitare un eccessivo lavoro ai traduttori che devono stare al passo con i cambiamenti.


 * 3. Modifica Fréttinga
 * 4. Inserisci l'intero contenuto dentro ai tag &lt;translate>...&lt;/translate> come mostrato sotto
 * 5. Salva la pagina

&lt;translate> Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. == Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. &lt;/translate>

Non hai bisogno di aggiungere i tag &lt;translate> a tutti gli elementi, o aggiungere marcatori come ; l'estensione lo fa al posto tuo.

Passo 3: Abilitare le traduzioni
Dopo aver salvato la pagina, vedrai un collegamento in alto che dice "Marca questa pagina per la traduzione" (oppure "Questa pagina contiene delle modifiche che non sono segnate per la traduzione." se non sei un amministratore di traduzione). Nel caso tu sia un amministratore di traduzione, clicca sul collegamento "Marca questa pagina per la traduzione". La pagina è stata automaticamente divisa in quattro unità di traduzione. La prima è il titolo della pagina, la seconda è il primo paragrafo, la terza è l'intestazione del secondo paragrafo, e la quarta è il testo del secondo paragrafo. Gli elementi fondamentali delle pagine traducibili sono i seguenti: ogni unità è indipendente; la pagina può e deve essere tradotta come un insieme; i cambiamenti al contenuto della pagina vengono tracciati a livello delle unità di traduzione, che possono essere riarrangiate o cancellate.

C'è anche una vista del template della pagina di traduzione; ciò verrà trattato nei passi successivi. Puoi dare dei nomi alle unità di traduzione, ma in questo esempio abbiamo scelto di lasciare quelli predeterminati.


 * 6. Clicca sul collegamento "Marca questa pagina per la traduzione"
 * 7. Assicurati che il corpo della pagina sia diviso correttamente in 3 unità
 * 8. Clicca sul pulsante "Marca questa versione per la traduzione"
 * 9. Torna alla pagina

Ora vedrai un nuovo collegamento in cima, "Traduci questa pagina", che permette ai traduttori di tradurre la pagina. Puoi dare un'occhiata al tutorial di traduzione che usa questa pagina come un esempio e provare a fare qualche traduzione. Poi torna qui per il passo successivo.

Passo 4: Effettuare modifiche
Tenere traccia dei cambiamenti è una funzionalità molto importante, quindi facciamo alcuni cambiamenti e vediamo come funziona. Quando apri la pagina per modificarla puoi vedere che è stata modificata con dei marcatori come. Questi vengono aggiunti dall'estensione e aiutano ad identificare le unità. Ciò ti permette di riarrangiare e modificare tali unità. Quando modifichi la pagina, i marcatori dovrebbero essere lasciati stare e la loro posizione in relazione all'unita a cui appartendono non dovrebbe essere cambiata. Quando sposti un'unità, sposta anche il marcatore dell'unità.

Quando cancelli un'unità, cancella anche il marcatore. Quando aggiungi nuovi paragrafi, nuovi marcatori verranno aggiunti dal programma. Non provare a farlo manualmente, potresti confondere il programma. I marcatori che hai eliminato verranno automaticamente cancellati dal bot nelle traduzioni esistenti.

Se apporti piccoli cambiamenti ad un'unità di traduzione esistente (aggiungendo qualche parola o un collegamento ad un paragrafo), mantieni il marcatore. Se cambi un'intero paragrafo (cancellandolo e rifacendolo), cancella il marcatore. In questo modo i traduttori avranno compiti diversi, tra rivedere una traduzione imprecisa o crearne una nuova. &lt;languages /> &lt;translate> &lt;!--T:1--> Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. It has marvelous beaches with a lot of seagulls. == Services == &lt;!--T:2--> &lt;!--T:3--> It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. '''In 2009 January the roof of the church in the island fell down. It was rebuilt''' collaboratively the following summer. &lt;/translate>


 * 10. Fai alcune aggiunte come evidenziato sopra
 * 11. Clicca il link "segnata per la traduzione" in cima
 * 12. Osserva i cambiamenti
 * 13. Clicca il pulsante "Segna per la traduzione"
 * 14. Ritorna alla pagina originale

Se hai effettuato delle traduzioni come suggerito nel passo precedente, sei ora in grado di vedere quelle traduzioni linkate nella parte alta della pagina. Vedrai anche che la traduzione non è aggiornata al 100%. Se vai alla vista di traduzione, vedrai che l'unità è marcata come bisognosa di traduzione.

Le traduzioni non aggiornate verranno evidenziate con uno sfondo rosa; l'utente viene avvisato che la traduzione è incompleta.

La vista del template di traduzione ti aiuta a vedere quali parti della pagina sono costanti in tutte le versioni linguistiche (il "template di traduzione della pagina", p.e. le parti al di fuori delle etichette di traduzione) e ti mostra anche se le unità sono state spostate o cancellate.

Ci può essere un breve ritardo prima che le versioni tradotte vengano aggiornate, perchè potrebbero esserci molte pagine da aggiornare.

Ora conosci le basi, ma questo tutorial continuerà con altre cose che incontrerai facilmente.

Passo 5: Aggiungere altri elementi wiki
Hai ora una pagina traducibile di base, ma è molto scarna. Aggiungiamo un'immagine e qualche altra cosa per renderla più simile ad una normale pagina wiki e vediamo come questi elementi interagiscono con la traduzione.

Abbiamo anche rimosso un paragrafo, compreso il suo marcatore di unità, e lo abbiamo rimpiazzato con una lista, in modo che tu possa vedere cosa succede.

&lt;languages /> &lt;translate> &lt;!--T:1--> Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing and tourists like to visit it in the summertime. It has marvelous beaches with a lot of  seagulls . == Services == &lt;!--T:2--> &lt;!--T:3--> It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. Main events: * The roof of the church fell down in 2009 * New church was built in 1877    &lt;/translate>
 * 15. Aggiungi un'immagine, una categoria e una lista alla pagina, come mostrato sotto
 * 16. Salva la pagina
 * 17. Clicca sul collegamento "marcato per la traduzione" in cima alla pagina
 * 18. Verifica che i cambiamenti appaiano come previsto
 * 19. Premi il pulsante "Marca questa versione per la traduzione"
 * 20. Torna alla pagina traducibile

Documentare una traduzione
Qui puoi notare che abbiamo lasciato la maggior parte del markup dell'immagine fuori dall'unità di traduzione e che è invece presente nel template della pagina di traduzione. Ciò di solito va bene, ma talvolta i traduttori possono voler cambiare l'immagine, specialmente se presenta dei contenuti linguistici (testo). In questi casi è generalmente più semplice includere l'intero markup in un'unità (come facciamo per la categoria). Quando la traduzione di un'unità coinvolge o interagisce con il markup è una buona idea scrivere un piccolo suggerimento per i traduttori. Puoi farlo con i passi seguenti.


 * 21. Clicca sul collegamento "Traduci questa pagina" in alto
 * 22. Seleziona la lingua "qqq - Page documentation"
 * 23. Clicca sul nome del messaggio che contiene il messaggio "A typical view of Fréttinga"
 * 24. Scrivi "Descrizione di un'immagine" e clicca "Salva"

Categorie
In questo esempio, l'intero assegnamento della categoria è un'unita di traduzione. Ciò permette ai traduttori di cambiarla in o qualsiasi convenzione nominale tu voglia usare per le categorie. Se fosse stata fuori dal template di traduzione, avresti avuto tutte le pagine Foo, Foo/de, Foo/ru, Foo/ta e così via nella stessa categoria. Qualche volta va bene, ma di solito distrae gli utenti. Assicurati che i tuoi traduttori sappiano quale siano le convenzioni locali.

Collegamenti
In maniera analoga, per i collegamenti ci sono molte maniere di fare la stessa cosa. Abbiamo usato " Special:MyLanguage/Seagull ", che ridireziona automaticamente alla versione tradotta della pagina in base al linguaggio di interfaccia dell'utente (se tale traduzione esiste). Non si tratta di una soluzione definitiva, perché gli utenti vorranno sempre essere ridirezionati al linguaggio di interfaccia che stanno usando, non quello che stanno leggendo. Inoltre Special:MyLanguage interferisce con Special:WhatLinksHere e non lo fa funzionare. Una buona cosa di Special:MyLanguage è che otterrai sempre una versione della pagina, anche se la traduzione richiesta non esiste.

Titoli
Affinché i titoli vengano considerati elementi separati dal testo, non dimenticare di aggiungere una riga "vuota" (se non ce n'è già una) tra il titolo ed il paragrafo seguente.

L'esempio seguente creerà un'unica unità di traduzione:

== Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

Il successivo creerà due unità di traduzione, di cui una sarà quella del titolo.

== Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

Aggiungere una riga vuota permette ai traduttori di sapere quando possono fermarsi. Inoltre previene problemi con il wikitesto.

Conclusione
È anche possibile spostare le pagine traducibili comprese tutte le loro traduzioni sotto un nuovo nome. Poiché potrebbe essere necessario spostare molte pagine, questa operazione non è istantanea. Puoi eliminare l'intera pagina comprendendo tutte le traduzioni, o solo una sua versione tradotta. Puoi accedere a queste funzioni dallo stesso luogo in cui si trovano su tutte le altre pagine.

Special:PageTranslation elenca tutte le pagine nel sistema. Oltre a fornirti una panoramica di tutte le pagine traducibili, è anche in grado di scoraggiare la traduzione di determinate pagine, nascondendole da molte liste. Non ne impedisce però la traduzione.

Hai ora creato una pagina traducibile e provato tutte le azioni comuni che possono essere realizzate sulle pagine traducibili. Per ulteriori informazioni, o se vuoi comprendere questa funzionalità più approfonditamente, per favore continua leggendo la documentazione approfondita della funzionalità di traduzione delle pagine. Contiene inoltre la discussione sulle varie maniere di gestire collegamenti, categorie e template, e i pro e i contro dell'utilizzo di unità di traduzione più grandi o più piccole.