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. Maybe you already have a page in mind that needs translation, or you can use the example page provided below to try out the steps in this tutorial in your own wiki.

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

Here is the wikicode associated to it :

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.

If the page is still going to be subject to lots of changes, it may be better to wait until the edits slow down to a normal level before adding the page into the translation system. This is to avoid too much work for translators as they need to keep up with all the changes.

The page is ready for translation ? So let's see how to request translation :


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

 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. 

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. If you are a translation administrator, then click on the "Mark this page for translation" link. The page has been automatically split into four translation units. The first unit is the title of the page, the second is the first paragraph, the third is the header of the second paragraph, and the fourth is the text of the second paragraph. These are the basics items of translatable pages: each unit is independent; it can and must be translated as a whole; changes to the page content are tracked into the unit level. Units can be rearranged or deleted.

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.

(reminder: you have to be a Translation administrator for this)
 * 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
 * 9. Return to the page

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.

Understanding how changes are impacting translations and translations units
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à. These are added by the extension and help it identify which unit is which. This allows you to rearrange and edit those units. When editing the page, the markers should be left alone and their position in relation to the unit they belong to should not be changed. When moving a unit, move the unit marker, too.

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.

let's modify something !
Here is what you will do :

(reminder: you have to be a Translation administrator for this)
 * 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
 * 14. Return to the original page

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.

Adding an image, a category and a list with translation markers
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.


 * 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. (reminder: the translation page template doesn't change between the different translated pages) This is usually okay, but sometimes translators may want to change the image, especially if it contains linguistic content (text). In those cases it's usually easiest to include the whole markup in a unit (as we did for the category).

When the translation of a unit involves or interacts with markup it's a good idea to write a small tip to the translators about it. You can do this with the following steps.


 * 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"

Now, the documentation "Description of an image" is shown next to the to-be-translated-title of the image.

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. We used " Special:MyLanguage/Seagull ", which automatically redirects to the translated version of the page depending on the users' interface language (if that translation exists). This isn't an ultimate solution, because users will always be redirected to the interface language they are using, not to the language they are currently reading. Special:MyLanguage also interferes with Special:WhatLinksHere and makes it not work. The good thing about Special:MyLanguage is that you always get some version of the page, even if the requested translation doesn't exist.

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. This lets translators change it to or whatever naming convention you want to use for categories. If it were outside the translation template, you would have all the pages Foo, Foo/de, Foo/ru, Foo/ta and so on in the same category. Sometimes this is okay, but usually it distracts the users. Make sure your translators know what the local convention is.

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.

Operating on the whole page and its translations
È 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.

Managing all wiki's pages translations with Special pages
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.

Now, you know !
Hai ora creato una pagina traducibile e provato tutte le azioni comuni che possono essere realizzate sulle pagine traducibili.

Going deeper ?
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.