Joomla! Documentation™

Questa pagina dovrebbe aiutare un traduttore ad iniziare rapidamente con le traduzioni della documentazione. Per la versione più dettagliata della traduzione della pagina, vai a vedere Page Translation Explained. Per registrarti come traduttore, vai a Documentation Translators aggiungi il tuo nome utente.

Quando il tuo userid è approvato puoi trovare documenti da tradurre per la tua lingua su Language Statistics. Quando apri un documento per la traduzione in una nuova finestra, vedrai un elenco di pezzi da tradurre. Nella parte superiore è presente un collegamento al documento che stai traducendo. Apri questo in una nuova finestra e hai tutto insieme. Puoi tradurre in una schermata e controllare cosa hai tradotto nell'altra.

Se sei già registrato come traduttore, puoi giocare su Translation Sandbox.

È bene sapere come parti dei documenti sono contrassegnate per la traduzione. In generale è così <translate><T:number>Testo da tradurre</translate> e quando traduci vedrai Testo da tradurre, che puoi tradurre. Il <translate></translate> è messo dalla persona che contrassegna il documento per la traduzione, il <T:number> viene eseguito dal sistema.

L'interfaccia

Se una pagina è pronta per la traduzione, vedrai (immagini in basso) o una variazione (in base alla visualizzazione della pagina):

Dopo aver fatto clic sul collegamento di traduzione, verrà visualizzata la seguente interfaccia per la traduzione. La documentazione ora ha un ULS (Universal Language Selector) installato che imposterà automaticamente l'interfaccia utente sulla lingua localizzata. Questo si basa sul browser (impostazione della lingua) e/o sulla posizione geografica. L'impostazione della lingua può anche essere sovrascritta manualmente selezionando l'icona dell'utente (in alto a destra) e dal menu a discesa fare clic sulla lingua in alto. Puoi anche andare al tuo utente personal preferences for language.

Ora sei pronto per tradurre, fai clic su qualsiasi collegamento nelle unità di messaggio separate.

È possibile fare clic sul testo suggerito per aggiungerlo automaticamente alla finestra di modifica. Quindi è possibile modificare il testo. Il testo suggerito è fornito gratuitamente dai servizi di traduzione. Non vi è alcuna garanzia che ci sarà un testo suggerito. La query dei suggerimenti potrebbe scadere sul server dei servizi di traduzione.

Quando sei soddisfatto della tua traduzione, salvala. Puoi anche saltare le sezioni se desideri tradurre solo alcuni dei gruppi di messaggi.

Titoli di pagina

I titoli di pagina possono e devono essere tradotti. Sono il primo gruppo di messaggi nella parte superiore dell'interfaccia di modifica.

Importante!

Il nome di una pagina si trova in uno spazio dei nomi quando appare così: "Prefisso:Nome della pagina".

Il nome di questa pagina non si trova in uno spazio dei nomi quando appare così: "Nome della pagina".

Corretto?	Esempi di titoli
Si!!!	"J2.5: titolo di una pagina" tradotto così "Título de la página" "J2.5: titolo di una pagina" tradotto così "Titel einer Seite"
NO!	"J2.5: titolo di una pagina" tradotto così "J2.5:Título de la página" "J2.5: titolo di una pagina" tradotto così "J2.5:Titel einer Seite"

Links

Informazioni importanti sui collegamenti

Le informazioni di seguito sono una rapida panoramica. Per una spiegazione più dettagliata, vedi Traduzione dei Links.

Link alle pagine interne standard

I collegamenti ipertestuali a un'altra pagina sono facili nella lingua di origine, sono nomi di pagina tra [[ (brackets) ]] o le varianti elencate di seguito. Good source page standards per i collegamenti di pagina inizieranno a includere il markup di collegamento corretto per la navigazione tradotta.

1. [[JDOC:Translation Sandbox]] diventa JDOC:Translation Sandbox
2. [[JDOC:Translation Sandbox|Translation Sandbox]] diventa Translation Sandbox
3. [[JDOC:Translation Sandbox|Translator Sandbox]] diventa Translator Sandbox

I collegamenti da una pagina tradotta a una pagina nella stessa lingua devono essere eseguiti tramite un processore di collegamenti di localizzazione.

1. [[Special:MyLanguage/JDOC:Translation Sandbox]] diventa Special:MyLanguage/JDOC:Translation Sandbox
   Questo sopra non è davvero un link piacevole, né è mostrato nella lingua del lettore. Per migliorare l'esperienza dell'utente, vedere il link di esempio di traduzione olandese di seguito.
2. [[Special:MyLanguage/JDOC: Translation Sandbox|Vertaling Sandbox]]diventa Vertaling Sandbox
   Ora un lettore olandese vedrà il link nella loro lingua. Proprio come sopra, puoi nominare il link in qualsiasi modo.

C'è un alias per la parola Special:, quindi puoi anche usare solo la lettera S: come una versione breve di Special:.

Suggerimenti importanti per i collegamenti

• Usa sempre

  [[Speciale:MyLanguage/<nome pagina lingua di origine>|<la traduzione>]]

• O

  [[S:MyLanguage/<source language pagename>|<the translation>]]

Un esempio potrebbe essere:

[[JDOC:Translation Sandbox|Translation Sandbox]] 
  è tradotto come
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
 o
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]

So Remember: Aggiungi sempre Special: MyLanguage/davanti a <source page name>. Il <source page name> è sempre non tradotto. Aggiungi sempre un | se manca e quindi la traduzione di <source page name>. Spesso questo Special:MyLanguage/ è già aggiunto nel documento di origine. Quindi quando Speciale: MyLanguage/JDOC:Translation Sandbox| <translate> Translation Sandbox </translate> è nel documento originale devi solo tradurre Sandbox di traduzione e non vedi il link totale.

Link estern

I collegamenti esterni sono facili da tradurre. Sono scritti in questo modo nella lingua di partenza.

1. https://www.php.net/ diventa https://www.php.net/
2. [https://www.php.net/ per informazioni PHP] diventa per informazioni PHP

Cosa tradurre?

1. Questo è un URL standard e non richiede traduzione. https://www.php.net/ È un collegamento ipertestuale regolare e deve essere scritto come tale. Nessuna traduzione richiesta.
2. Questo [https://www.php.net/ per informazioni PHP] richiederà solo la traduzione di per informazioni PHP.

Categorie

Le categorie richiedono un metodo specifico!

La traduzione di una categoria è molto semplice, basta aggiungere /<codice lingua> alla fine del nome della categoria.

Fai questo

Ad esempio, se traduci una pagina dall'inglese allo spagnolo (codice lingua es) e la pagina contiene la seguente categoria:

<Nowicki>[[Categoria: Sviluppo]]</Nowicki>

Devi aggiungere /es alla fine del nome della categoria.

[[Categoria:Developement/es]]

Anche le pagine delle categorie possono essere tradotte (il che dovrebbe essere rapido - la maggior parte sono vuote tranne che per contenere una categoria principale) e quando saranno pronte faranno parte di un progetto di categorizzazione speciale.

Per prepararci a questo, possiamo aggiungere /nl|Ontwikkeling (lingua olandese) alla fine del nome della categoria

[[Category:Developement/nl|Ontwikkeling]]

Non farlo

Ci sono alcune cose che non dovresti fare.

Per favore non farlo

Traduci la parola "Categoria" o il nome della categoria.

[[Categoria: sviluppo]] a [[Categorie: Ontwikkeling]]

O questo

Traduci solo il nome della categoria.

[[Categoria:Sviluppo]] a [[Categoria:Ontwikkeling]]

Immagini

Si prevede che la pagina tradotta vorrà mostrare immagini localizzate nella lingua della pagina. Questo è incoraggiato perché migliora l'esperienza dell'utente. La documentazione richiede solo ai traduttori di seguire uno schema di denominazione delle immagini coerente con la lingua di origine di una pagina.

Denominazione immagine

Utilizzando un'immagine usata sopra in questa pagina che è scritta come:

[[File:JDOC-translator_interface-editing-view.png]]

Fai questo

Mantieni il nome dell'immagine e aggiungi il codice della lingua alla fine:

español sarebbe es [[File:JDOC-translator_interface-editing-view-es.png]]
italiano sarebbe it [[File:JDOC-translator_interface-editing-view-it.png]]
português español sarebbe pt [[File:JDOC-translator_interface-editing-view-pt.png]]

Se il file non è un tipo di file localizzato (ad esempio Schermata di un'interfaccia) ed è un elemento grafico di qualcosa di universale (ad esempio una palla o una freccia), non è necessario rinominare l'immagine. Se l'immagine ha una didascalia, potresti dover tradurre la didascalia.

[[File:ball.png|caption=Questa è una palla]]
Will become
[[File:ball.png|caption=<traduci solo questa parte>]]

Dopo aver finito di tradurre una pagina con le immagini che localizzerai. Dovresti visualizzare la pagina anche nella lingua appena tradotta e fare clic sui collegamenti ai file "rossi". Ciò ti consentirà di caricare la versione localizzata del file.

Spesso l'immagine nel documento da tradurre ha già un ID lingua che è contrassegnato per la traduzione: [[File:JDOC-translator_interface-editing-view-<translate>en</translate>.png]]. Quindi dovrai tradurre en el tuo ID lingua locale (in olandese nl). Se l'immagine non ha elementi localizzati che desideri tradurre en into en per conservare l'immagine originale.

Non farlo

Se non inserisci l'immagine locale (perché al momento non hai tempo) è meglio non tradurre en nella tua lingua, altrimenti avrai un link al file "rosso".

Blocchi

I blocchi sono pezzi di documentazione che possono essere utilizzati in più di un posto. Ci sono grossi pezzi, ma la maggior parte di essi è una piccola parte della documentazione, a volte solo una riga. Ad esempio, viene utilizzato per i colomnheaders nelle schermate di aiuto in cui gli stessi campi vengono utilizzati in molte schermate di aiuto

Utilizzo di blocchi

L'uso di un blocco in un documento è molto semplice. Se vediamo: https://docs.joomla.org/Chunk30:Help_screen_Show_Title possiamo usarlo in un documento con il seguente codice:

{{Chunk30:Help_screen_Show_Title/<translate>en</translate>}}

Se lo utilizziamo in un documento, vediamo quanto segue:

• Show Title. (Use Global/Use Article Settings/Show/Hide) Whether or not to show the article's Title.

Quindi dovrai tradurre en nel tuo ID lingua locale (in olandese nl). Se, dopo la traduzione, il pezzo non è disponibile nella tua lingua, vedrai un link rosso. Usa il link e aprilo in una nuova finestra. Vedrai un messaggio che il documento non esiste. Quello che devi fare ora è: Rimuovi il codice della lingua nell'URL, in olandese / nl, ora vedrai il pezzo in inglese. Traduci il blocco nella tua lingua (è sufficiente solo la prima riga) e il blocco viene creato nella tua lingua e visibile nel documento di origine. Esiste un modo più sofisticato di utilizzo di blocchi, con parametri. In questo modo è possibile passare parametri al blocco nella propria lingua. Lo facciamo con il seguente codice:

{{Chunk30:Help_screen_toolbar_icon_Save/<translate>en</translate>|<translate>voce di menu</translate>}}

La fonte di questo pezzo è:

*'''Salva'''. Salva il {{{1|item}}} e rimane nella schermata corrente. 

Quando lo utilizziamo in un documento, il risultato sarà:

• Save. Saves the voce di menu and stays in the current screen.

In questo modo la traduzione di en ci porterà nella lingua che vogliamo e la traduzione di voce di menu verrà usata nella voce.

Templates

I modelli sono parti di codice riutilizzabili che hanno un risultato prevedibile.

{{tip|title=Questo è un suggerimento|Questo è il contenuto del corpo di un suggerimento!}}

Assomiglierebbe a questo:

Questo è un consiglio

Fai questo

Per l'esempio sopra:

{{tip|title=Questo è un suggerimento|Questo è il contenuto del corpo di un suggerimento!}}

Dovresti fare quanto segue:

{{tip|title=<traduci il titolo>|<traduci il contenuto del corpo>}}

Non farlo

Ecco un elenco di cose da non fare.

• Non tradurre mai il nome del modello. Il template {{tip}} è chiamato dalla parola 'tip' seguendo la doppia serie di parentesi graffe. Se traduci il suggerimento, la traduzione chiamerebbe un nome di modello inesistente.
• Non tradurre mai le variabili utilizzate in un modello, solo il valore assegnato alla variabile. Nell'esempio del modello {{tip}}, la parola "titolo" è la variabile.