SI PREGA DI PRENDERE VISIONE DI QUANTO SEGUE SE SI DESIDERA CONTRIBUIRE ALLA TRADUZIONE IN LINGUA ITALIANA
In questo repository sono inclusi diversi file di testo, ciascuno con la propria sezione di traduzioni:
- translations.txt -- traduzioni generali, utilizzate in diverse sezioni - helptext.txt -- traduzioni per le sezioni di aiuto - dashboard.txt -- traduzioni per la sezione Dashboard - main.txt -- traduzioni per la sezione Principale - shares.txt -- traduzioni per la sezione Condivisioni - users.txt -- traduzioni per la sezione Utenti - settings.txt -- traduzioni per la sezione Impostazioni - plugins.txt -- traduzioni per la sezione Plugin - docker.txt -- traduzioni per la sezione Docker - vms.txt -- traduzioni per la sezione Macchine virtuali - tools.txt -- traduzioni per la sezione Strumenti - javascript.txt -- traduzioni per gli script JavaScript - scripts.txt -- traduzioni per gli Script locali - apps.txt -- traduzioni per la sezione App (CA = Community Applications) - ca_settings.txt -- traduzioni per le Impostazioni App (CA) - javascript.ca.txt -- traduzioni per gli Script JavaScript della sezione CA
Tutti i nomi dei file sono in minuscolo e devono essere inclusi nel repository per rendere complete le traduzioni.
La rimozione di un determinato file comporta l’assenza di traduzioni per quella sezione e l’interfaccia grafica (GUI) mostrerà il testo in inglese originale.
Ogni file di testo contiene stringhe di testo regolare, memorizzate in formato UTF-8 con terminazioni di riga in formato Linux. Utilizzare un editor di testo che supporti UTF-8 e il formato Linux, come Notepad++.
Il contenuto di ciascun file di testo è suddiviso in due parti, come illustrato di seguito.
Queste sono voci su singola riga visualizzate nel seguente formato:
Testo originale in inglese=Traduzione nella lingua desiderata
Modificare solo il testo dopo il segno di uguale (=) e lasciare invariato il testo originale in inglese a sinistra. La rimozione di una riga o l’omissione della traduzione dopo il segno di uguale comporterà la visualizzazione, nella GUI, del testo originale in inglese per quella riga.
Il testo tradotto può contenere “caratteri speciali” come barre, parentesi tonde o parentesi quadre, che non sono inclusi nel testo chiave, ma servono per la corretta visualizzazione del testo. Ad esempio:
Options see Help=Opzioni (vedi Aiuto)
I caratteri * e ** sono utilizzati per visualizzare rispettivamente il testo in corsivo e in grassetto. Ad esempio:
"Array must be Stopped to change=L’*Array* deve essere **Fermato** per apportare le modifiche".
Si consiglia di effettuare le traduzioni per sezione, ossia un file alla volta, e di verificarne la correttezza nella GUI prima di procedere con la sezione successiva.
Tenere presente la lunghezza delle traduzioni, cercando di mantenerla simile a quella del testo originale, così da evitare problemi di spaziatura nella GUI.
Queste sono voci su più righe utilizzate per tradurre più righe contemporaneamente. Le traduzioni su più righe hanno un tag di apertura e chiusura univoco:
:unique_tag_name_plug: – tag di apertura univoco utilizzato per qualsiasi sezione di testo
su più righe
:end - tag di chiusura
Tutto il testo di aiuto della GUI è memorizzato in un singolo file denominato helptext.txt.
Questo file contiene più sezioni di testo di aiuto. Ogni sezione è racchiusa da un tag di apertura univoco e dal corrispondente tag di chiusura:
:unique_tag_name_help: – tag di apertura univoco utilizzato per una sezione di testo di aiuto
:end – tag di chiusura corrispondente
Nota: viene utilizzata la sintassi di stile Markdown, la quale deve essere preservata.
Una volta completate le traduzioni, se si desidera testare localmente i risultati (anche parziali), i file di testo devono essere compressi in un unico file ZIP.
Dare al file ZIP il nome della propria lingua, ad esempio: "Italian.zip".
Nella GUI di Unraid andare in: Strumenti → Interfaccia Grafica Web → Lingua (e passare alla vista Sviluppatore)
- Per impostazione predefinita, è inclusa solo la lingua inglese (integrata nativamente).
- Selezionare come file sorgente il file ZIP creato in precedenza.
- Se il nome della lingua viene riconosciuto, verrà selezionato automaticamente; altrimenti, scegliere il nome della lingua dal menu a discesa per installarla.
- Fare clic su 'Carica' per aggiungere la traduzione alla GUI sotto il nome lingua selezionato.
NOTA: Se la lingua non è disponibile nel menu a discesa, fare richiesta nella Sezione Multi-Lingua del Forum di Unraid.
A questo punto la lingua sarà disponibile per i test locali!
Nella GUI di Unraid andare in: Impostazioni → Impostazioni Interfaccia → Lingua
- Selezionare la lingua preferita dal menu a discesa. Si ricorda che qui vengono visualizzate solo le lingue disponibili.
Un language repository sarà reso disponibile su GitHub, dove i traduttori potranno creare delle Pull Request (PR) per inviare il proprio lavoro.
Una volta soddisfatti del risultato, utilizzare GitHub (è necessario un account) per effettuare il fork del repository della lingua corrispondente e creare una PR per inoltrare le proprie modifiche.
LimeTech esaminerà la proposta e, se approvata, integrerà il tuo lavoro.
Quando in futuro saranno disponibili versioni aggiornate dei file sorgente in inglese, queste saranno pubblicate tramite GitHub.
I traduttori potranno usare il sistema GitHub per verificare le modifiche apportate e aggiornare di conseguenza le proprie traduzioni.
Il tuo contributo è molto apprezzato e, come segno di riconoscenza, il tuo nome e la lingua tradotta saranno inseriti nella sezione Crediti della pagina Strumenti nella GUI di Unraid.
Ti preghiamo di indicarci quale nome e credenziali utilizzare.
Grazie mille per la collaborazione e l’impegno ❤️