Help:Extension:Translate/Page translation example/it

Benvenuti! Dopo aver completato questo tutorial, saprete come creare e gestire pagine traducibili usando l'estensione Translate. Il tutorial e` creato con l'idea di essere il piu` breve possibile, pur introducendo tutti i concetti e le istruzioni basilari. Dopo aver completato questo tutorial, potete leggere la documentazione approfondita sulle caratteristiche delle traduzioni 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, oppure puoi usare la pagina di esempio fornita sotto per provare i passi di questo tutorial nella tua wiki.

Questa è una pagina che descrive la municipalità immaginaria 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 summer time. == Services == It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day.
 * 1. Vai alla pagina Fréttinga nella tua wiki e clicca "crea".
 * 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é le modifiche non calano ad un livello normale prima di aggiungere questa pagina nel sistema delle traduzioni. Ciò per evitare un eccessivo lavoro ai traduttori che devono stare al passo con i cambiamenti.

&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 summer time. == Services == It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day. &lt;/translate>
 * 3. Modifica Fréttinga
 * 4. Inserisci l'intero contenuto dentro ai tag &lt;translate>...&lt;/translate> come mostrato sotto
 * 5. Salva la pagina

Passo 3: Abilitare le traduzioni
Dopo aver salvato la pagina, vedrai un collegamento in alto che dice "Marca questa pagina per la traduzione" (o "Questa pagina contiene cambiamenti che non sono marcati per la traduzione." se non sei un amministratore di traduzione). Clicca sul collegamento. La pagina è stata automaticamente divisa in quattro unità di traduzione. La prima unità è il titolo della pagina, la seconda è il primo paragrafo, la terza è l'intestazione del secondo paragrafo, e la quarta è il testo del secondo paragrafo. Questi sono gli oggetti di base delle pagine traducibili: ogni unità è indipendente; può e deve essere tradotta come un insieme; i cambiamenti al contenuto della pagina vengono tracciati nel livello unitario. Le unità 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 all'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 programmma. &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 summer time. 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 car ferry visits the island from mainland once a day. In 2009 January the roof of the church in the island fell down. It was rebuilt collaboratively in 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 guardi alla versione tradotta, vedrai il nuovo paragrafo in inglese, e i paragrafi modificati saranno stati sostituiti con il testo inglese. Se vai alla vista di traduzione, vedrai che l'unità è marcata come bisognosa di traduzione.

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 summer time. 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

Here you can see that we left most of the image markup outside of a translation unit and have it in the translation page template instead. 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. Click "Translate this page" link at the top
 * 22. Select "qqq - Page documentation" language
 * 23. Click the message name which contains the message "A typical view of Fréttinga"
 * 24. Write "Description of an image" and click "Save"

In this example, the whole category assignment is a translation unit. 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.

Similarly, for links there are many ways to do it. 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're 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.

Last words
It is also possible to move translatable pages including all their translations to a new name. Because many pages may need to be moved, this operation is not instant. You can delete either the whole page including all translations, or just one translated version of a page. You can access these functions from the same place they are on all other pages.

Special:PageTranslation lists all the pages in the system. Besides giving you an overview of all translatable pages, it is also possible to discourage pages from translation. This hides the page from most lists. It does not prevent further translations.

You have now created a translatable page and tried all of the common actions that can be performed on translatable pages. For more information, or if you want to understand the feature more deeply, please continue reading on the in-depth documentation of page translation feature. It also contains discussion about different ways of handling links, categories and templates, or pros and cons of using larger or smaller translation units.