Localisation/it: Difference between revisions
No edit summary |
No edit summary |
||
(45 intermediate revisions by the same user not shown) | |||
Line 3: | Line 3: | ||
{{Docnav/it |
{{Docnav/it |
||
|[[Branding/it|Marchiatura]] |
|[[Branding/it|Marchiatura]] |
||
|[[Workbench_creation/it|Creare |
|[[Workbench_creation/it|Creare un Ambiente di lavoro]] |
||
}} |
}} |
||
Line 19: | Line 19: | ||
<span id="Translate_the_FreeCAD_source_code"></span> |
<span id="Translate_the_FreeCAD_source_code"></span> |
||
<div class="mw-translate-fuzzy"> |
|||
== Tradurre il codice sorgente di FreeCAD == |
== Tradurre il codice sorgente di FreeCAD == |
||
FreeCAD utilizza un sistema di traduzione in linea collaborativo di terze parti chiamato [https://crowdin.net Crowdin]. |
|||
</div> |
|||
FreeCAD |
FreeCAD utilizza un sistema di traduzione in linea collaborativo di terze parti chiamato [https://crowdin.net Crowdin]. |
||
[[File:Logo-crowdin.png|320px]] |
[[File:Logo-crowdin.png|320px]] |
||
⚫ | |||
<div class="mw-translate-fuzzy"> |
|||
⚫ | |||
</div> |
|||
* Andare alla pagina [http://crowdin.net/project/freecad Traduzione del progetto FreeCAD] in Crowdin. |
* Andare alla pagina [http://crowdin.net/project/freecad Traduzione del progetto FreeCAD] in Crowdin. |
||
Line 40: | Line 35: | ||
{{Message|Se si partecipa alla traduzione di FreeCAD, e si desidera essere informati prima della pubblicazione di una prossima versione che è il momento di rivedere la propria traduzione, si prega di iscriversi a uno dei team di traduzione di FreeCAD in Crowdin}}. |
{{Message|Se si partecipa alla traduzione di FreeCAD, e si desidera essere informati prima della pubblicazione di una prossima versione che è il momento di rivedere la propria traduzione, si prega di iscriversi a uno dei team di traduzione di FreeCAD in Crowdin}}. |
||
{{Emphasis| |
{{Emphasis|Nota:}} I dettagli su come utilizzare crowdin possono essere trovati nella pagina [[Crowdin_Administration|Amministrazione di Crowdin]]. |
||
<span id="Translating_external_workbenches"></span> |
<span id="Translating_external_workbenches"></span> |
||
== Traduzione degli ambienti esterni == |
== Traduzione degli ambienti esterni == |
||
Vedere [[Translating an external workbench/it|Traduzione di un ambiente esterno]] |
Vedere [[Translating an external workbench/it|Traduzione di un ambiente esterno]]. |
||
<span id="FreeCAD_Preferences_for_Translators"></span> |
|||
== FreeCAD Preferences for Translators == |
|||
== Preferenze di FreeCAD per i traduttori == |
|||
A partire da FreeCAD 0.20, le seguenti variabili possono essere aggiunte manualmente alla sezione BaseApp/Preferences/General del file user.cfg per facilitare lo sviluppo di nuove traduzioni: |
|||
'''AdditionalLanguageDomainEntries''' - |
'''AdditionalLanguageDomainEntries''' - per aggiungere lingue completamente nuove a FreeCAD, che non sono attualmente supportate dal codice sorgente, è possibile utilizzare questa preferenza utente per aggiungere all'elenco delle lingue disponibili. Il formato delle lingue è "Language Name"="codice"; Per esempio: |
||
<pre> |
<pre> |
||
Line 57: | Line 53: | ||
</pre> |
</pre> |
||
'''AdditionalTranslationsDirectory''' - |
'''AdditionalTranslationsDirectory''' - aggiunge una directory aggiuntiva per FreeCAD per cercare i file *.qm. Questa posizione avrà la precedenza su $userAppDataDir/translations e $resourceDir/translations. Per esempio: |
||
<pre> |
<pre> |
||
Line 68: | Line 64: | ||
Questo wiki ospita molti contenuti, la maggior parte dei quali costruisce il manuale. È possibile sfogliare la documentazione a partire dalla [[Main Page/it|Pagina principale]], o dare un'occhiata al [[Online Help Toc/it|Sommario]] del manuale utente. |
Questo wiki ospita molti contenuti, la maggior parte dei quali costruisce il manuale. È possibile sfogliare la documentazione a partire dalla [[Main Page/it|Pagina principale]], o dare un'occhiata al [[Online Help Toc/it|Sommario]] del manuale utente. |
||
Per tradurre il wiki, si deve disporre dei permessi di modifica del wiki; vedere [[Frequently_asked_questions/it#Come si può ottenere il permesso di modificare il wiki?|Come si può ottenere il permesso di modificare il wiki?]]. |
|||
<div class="mw-translate-fuzzy"> |
|||
Per poter tradurre nel wiki, è necessario [[FAQ#How_can_I_get_edit_permission_on_the_wiki.3F|richiedere l'autorizzazione]]. |
|||
</div> |
|||
È necessario avere una conoscenza di base sulla formattazione dello stile wiki e sulle linee guida generali del wiki di FreeCAD, perché durante la traduzione bisogna sapere cosa fare con alcuni tag. Potete trovare queste informazioni in [[WikiPages|WikiPages]] (en). |
È necessario avere una conoscenza di base sulla formattazione dello stile wiki e sulle linee guida generali del wiki di FreeCAD, perché durante la traduzione bisogna sapere cosa fare con alcuni tag. Potete trovare queste informazioni in [[WikiPages|WikiPages]] (en). |
||
Line 89: | Line 83: | ||
deve circondare l'intera pagina per attivare il sistema di traduzione e la pagina deve essere contrassegnata per la traduzione. |
deve circondare l'intera pagina per attivare il sistema di traduzione e la pagina deve essere contrassegnata per la traduzione. |
||
Per vedere un esempio di come funziona lo strumento di traduzione, visitare la [[Main_Page/it|Pagina principale]]. Si vedrà una barra della lingua generata automaticamente in alto. Cliccare su [[Main_Page/de|Deutsch]] (tedesco), si andrà a [[Main_Page/de]]. Proprio sotto il titolo, "Hauptseite" (in inglese "Main Page"), si può leggere <small>{{Emphasis|Questa pagina è una versione tradotta della pagina Pagina principale e la traduzione è completa al XX%}}</small >, XX è la percentuale corrente di traduzione. Fare clic su "Traduci" nella parte superiore della pagina per avviare l'utilità di traduzione per aggiornare, correggere e rivedere la traduzione esistente. |
|||
<div class="mw-translate-fuzzy"> |
|||
Per vedere un esempio di come funziona lo strumento di traduzione quando il plugin di traduzione è attivo su una pagina, è possibile visitare la [[Main Page]]. Verrà visualizzata una nuova barra del menu lingua in basso. Esso viene generato automaticamente. Cliccando, per esempio, sul link tedesco, si apre la pagina [[Main Page/de]]. Immediatamente sotto al titolo, è possibile leggere <small>{{Emphasis|This page is a translated version of the page Main Page and the translation is XX% complete}}</small> "Questa pagina è una ''versione tradotta'' di Main Page e la traduzione è xx% completa." |
|||
(xx è la percentuale attuale di traduzione). Cliccare sul link "Traduci questa pagina" per avviare la traduzione, o per aggiornare o correggere la traduzione esistente. |
|||
</div> |
|||
Ora se |
Ora se si va nella pagina [[Main Page]], si nota che quando la pagina viene contrassegnata per la traduzione non è possibile modificarla direttamente, ma che si deve passare attraverso l'utility di traduzione. |
||
Quando si aggiungono nuovi contenuti, prima deve essere creata la pagina inglese, e poi la pagina inglese può essere tradotta in un'altra lingua. Se qualcuno vuole cambiare o aggiungere dei contenuti in una pagina esistente, deve farlo nella pagina inglese, marcarla per la traduzione e poi tradurre i contenuti editati. |
Quando si aggiungono nuovi contenuti, prima deve essere creata la pagina inglese, e poi la pagina inglese può essere tradotta in un'altra lingua. Se qualcuno vuole cambiare o aggiungere dei contenuti in una pagina esistente, deve farlo nella pagina inglese, marcarla per la traduzione e poi tradurre i contenuti editati. |
||
Line 103: | Line 94: | ||
===Note importanti=== |
===Note importanti=== |
||
⚫ | |||
<div class="mw-translate-fuzzy"> |
|||
⚫ | |||
</div> |
|||
Tuttavia, solo gli utenti con permessi di "Amministratore" possono contrassegnare le pagine per la traduzione. Una pagina che non è stata contrassegnata per la traduzione non fa uso dell'estensione di traduzione e non è sincronizzata correttamente con le informazioni in inglese. |
Tuttavia, solo gli utenti con permessi di "Amministratore" possono contrassegnare le pagine per la traduzione. Una pagina che non è stata contrassegnata per la traduzione non fa uso dell'estensione di traduzione e non è sincronizzata correttamente con le informazioni in inglese. |
||
Line 116: | Line 105: | ||
=== Tradurre la documentazione di FreeCAD === |
=== Tradurre la documentazione di FreeCAD === |
||
Come |
Come da consenso generale, la pagina di riferimento nel wiki è la pagina inglese, che dovrebbe essere creata per prima. Se si desidera modificare o aggiungere contenuto a una pagina, è necessario farlo prima alla pagina inglese e solo una volta completato l'aggiornamento, portare la modifica nella pagina tradotta. |
||
<span id="Old_translation_instructions"></span> |
<span id="Old_translation_instructions"></span> |
||
=== Vecchie istruzioni di traduzione === |
=== Vecchie istruzioni di traduzione === |
||
<div class="mw-translate-fuzzy"> |
|||
{| class="mw-collapsible mw-collapsed wikitable" |
{| class="mw-collapsible mw-collapsed wikitable" |
||
|Queste istruzioni sono solo un background storico, mentre le pagine vengono passate al nuovo plugin di traduzione. |
|Queste istruzioni sono solo un background storico, mentre le pagine vengono passate al nuovo plugin di traduzione. |
||
|- |
|- |
||
| |
| |
||
Il primo passo è '''controllare se è già stata avviata la traduzione del manuale per la propria lingua''' (cercare nella barra laterale sinistra, sotto "manual").<br /> |
|||
In caso contrario, andare al [http://forum.freecadweb.org/ forum] e comunicare che si intende avviare una nuova traduzione, |
In caso contrario, andare al [http://forum.freecadweb.org/ forum] e comunicare che si intende avviare una nuova traduzione, verranno create le impostazioni di base per la lingua che si desidera lavorare.<br /> |
||
Vedere [[Frequently_asked_questions/it#Come si può ottenere il permesso di modificare il wiki?|Come si può ottenere il permesso di modificare il wiki?]].<br /> |
|||
Se la lingua è già presente, vedere quali pagine da tradurre sono ancora mancanti (sono quelle elencate in rosso). La tecnica è semplice: '''entrare in una pagina rossa, copiare e incollare il contenuto della corrispondente pagina inglese, e iniziare a tradurre.'''.<br /> |
Se la lingua è già presente, vedere quali pagine da tradurre sono ancora mancanti (sono quelle elencate in rosso). La tecnica è semplice: '''entrare in una pagina rossa, copiare e incollare il contenuto della corrispondente pagina inglese, e iniziare a tradurre.'''.<br /> |
||
Non dimenticare di includere tutti i tag e i modelli dalla pagina originale in inglese. Alcuni di questi modelli avranno un equivalente nella nuova lingua (per esempio, esiste un modello di Docnav in francese denominato Docnav/fr). Si deve utilizzare '''una barra slash e il codice della proria lingua''' in quasi tutti i collegamenti. Guardare altre pagine già tradotte per vedere come procedere.<br /> |
Non dimenticare di includere tutti i tag e i modelli dalla pagina originale in inglese. Alcuni di questi modelli avranno un equivalente nella nuova lingua (per esempio, esiste un modello di Docnav in francese denominato Docnav/fr). Si deve utilizzare '''una barra slash e il codice della proria lingua''' in quasi tutti i collegamenti. Guardare altre pagine già tradotte per vedere come procedere.<br /> |
||
Line 147: | Line 135: | ||
La pagina "Bienvenue sur l'aide en ligne" reindirizza a Online Help Startpage/fr, e la pagina "Fonctionnalités" reindirizza a Feature list/fr. |
La pagina "Bienvenue sur l'aide en ligne" reindirizza a Online Help Startpage/fr, e la pagina "Fonctionnalités" reindirizza a Feature list/fr. |
||
|} |
|} |
||
</div> |
|||
<span id="Translate_the_FreeCAD_website"></span> |
<span id="Translate_the_FreeCAD_website"></span> |
||
<div class="mw-translate-fuzzy"> |
|||
== Tradurre il sito Web di FreeCAD == |
== Tradurre il sito Web di FreeCAD == |
||
La traduzione del sito Web di FreeCAD è ora fatta tramite [https://crowdin.com/translate/freecad/561/en-en Crowdin]. Il file si chiama {{FileName|homepage.po}}. |
|||
</div> |
|||
La traduzione del sito Web di FreeCAD viene ora eseguita tramite [https://crowdin.com/translate/freecad/561/en-en Crowdin]. Il file si chiama {{FileName|homepage.po}}. |
|||
<span id="Development_-_How_to_Add_Localisation"></span> |
<span id="Development_-_How_to_Add_Localisation"></span> |
||
<div class="mw-translate-fuzzy"> |
|||
== Sviluppo - Come aggiungere la localizzazione == |
== Sviluppo - Come aggiungere la localizzazione == |
||
⚫ | |||
</div> |
|||
⚫ | |||
This section is for developers who want to add localisation to their code. |
|||
<span id="Preparing_your_FreeCAD/master_modules_for_translation"></span> |
<span id="Preparing_your_FreeCAD/master_modules_for_translation"></span> |
||
<div class="mw-translate-fuzzy"> |
|||
=== Preparare i moduli di FreeCAD/master per la traduzione === |
=== Preparare i moduli di FreeCAD/master per la traduzione === |
||
Queste sono le parti del processo di traduzione di FreeCAD: |
Queste sono le parti del processo di traduzione di FreeCAD: |
||
* estrarre le stringhe di testo dal codice sorgente nei file *.ts |
* estrarre le stringhe di testo dal codice sorgente nei file *.ts |
||
* caricare i file *.ts in [http://crowdin.net/project/freecad FreeCAD Crowdin]. |
* caricare i file *.ts in [http://crowdin.net/project/freecad FreeCAD Crowdin]. |
||
* tradurre le stringhe all'interno di Crowdin |
* tradurre le stringhe all'interno di Crowdin |
||
* estrarre i |
* estrarre i file *.ts nuovi o modicati da Crowdin |
||
* convertire i file *.ts in file *.qm e aggiornare il file *.qrc di ogni modulo |
* convertire i file *.ts in file *.qm e aggiornare il file *.qrc di ogni modulo |
||
* aggiornare FreeCAD master |
* aggiornare FreeCAD master |
||
</div> |
|||
These are the parts to the FreeCAD translation process: |
|||
* extract text strings from source code into *.ts files |
|||
* load *.ts files into [http://crowdin.net/project/freecad FreeCAD Crowdin]. |
|||
* translation of strings within Crowdin |
|||
* extract modified/new *.ts files from Crowdin |
|||
* convert *.ts files into *.qm files and update each module's *.qrc file |
|||
* update FreeCAD master |
|||
Tutti i passaggi precedenti sono eseguiti dagli "script di traduzione" che vengono eseguiti periodicamente da un amministratore. |
Tutti i passaggi precedenti sono eseguiti dagli "script di traduzione" che vengono eseguiti periodicamente da un amministratore. |
||
<div class="mw-translate-fuzzy"> |
|||
Preparare il modulo per la traduzione è abbastanza semplice. Innanzitutto, è necessario assicurarsi di avere una directory "translations" in {{FileName|myModule/Gui/Resources}}. Quindi aprire una finestra di terminale (o equivalente in Windows/OSX) nella directory "translations" e inserire il seguente comando: |
Preparare il modulo per la traduzione è abbastanza semplice. Innanzitutto, è necessario assicurarsi di avere una directory "translations" in {{FileName|myModule/Gui/Resources}}. Quindi aprire una finestra di terminale (o equivalente in Windows/OSX) nella directory "translations" e inserire il seguente comando: |
||
{{Code|code=lupdate -ts myModule.ts}} |
{{Code|code=lupdate -ts myModule.ts}} |
||
</div> |
|||
⚫ | |||
<div class="mw-translate-fuzzy"> |
|||
⚫ | |||
</div> |
|||
⚫ | |||
<div class="mw-translate-fuzzy"> |
|||
⚫ | |||
</div> |
|||
<span id="Preparing_your_3rd_party_module_or_macro_for_translation"></span> |
<span id="Preparing_your_3rd_party_module_or_macro_for_translation"></span> |
||
<div class="mw-translate-fuzzy"> |
|||
=== Preparare il proprio modulo o la macro per la traduzione === |
=== Preparare il proprio modulo o la macro per la traduzione === |
||
⚫ | |||
Questa [https://www.forum.freecadweb.org/viewtopic.php?f=3&t=25180 discussione nel forum] descrive i dettagli. |
|||
</div> |
|||
⚫ | |||
3rd party modules or macros are translated in much the same fashion, except that you must do some of the work yourself. |
|||
Questa [https://www.forum.freecadweb.org/viewtopic.php?f=3&t=25180 discussione del forum] descrive i dettagli. |
|||
Aggiornamento: vedere [[Translating_an_external_workbench/it|Traduzione di un ambiente di lavoro esterno]] |
|||
<span id="Older_module_translation_techniques"></span> |
<span id="Older_module_translation_techniques"></span> |
||
<div class="mw-translate-fuzzy"> |
|||
=== Precedenti tecniche di traduzione dei moduli === |
=== Precedenti tecniche di traduzione dei moduli === |
||
[[Localization Older Methods/it|Vecchi metodi di localizzazione]] descrive in dettaglio l'uso di strumenti di traduzione come Qt Linguist, lupdate, lrelease, pylupdate4, ecc. La maggior parte di questo non è più richiesto per i moduli di FreeCAD/master, ma può essere utile per preparare e aggiornare i moduli di terze parti. |
|||
</div> |
|||
[[Localization_Older_Methods| |
[[Localization_Older_Methods/it|Vecchi metodi di localizzazione]] descrive in dettaglio l'uso di strumenti di traduzione come Qt Linguist, lupdate, lrelease, pylupdate4, ecc. La maggior parte di questi strumenti non sono più richiesti per i moduli FreeCAD/master, ma può essere utile conoscerli per la preparazione e l'aggiornamento di moduli di terze parti. |
||
<span id="Automating_Crowdin_Translation_Updates"></span> |
<span id="Automating_Crowdin_Translation_Updates"></span> |
||
<div class="mw-translate-fuzzy"> |
|||
== Aggiornamento automatico delle traduzioni in Crowdin == |
== Aggiornamento automatico delle traduzioni in Crowdin == |
||
Attualmente i manutentori di FreeCAD utilizzano l'API Crowdin tramite [[Crowdin Scripts/it|Crowdin Scripts]] per estrarre e trasferire le traduzioni in Crowdin e riportarle nel repository Github. L'API Crowdin offre ai manutentori di FreeCAD la possibilità di automatizzare aspetti del flusso di lavoro di traduzione del progetto, per maggiori informazioni fare riferimento alla [https://support.crowdin.com/api/api-integration-setup/ Crowdin API documentation]. |
|||
</div> |
|||
Attualmente i manutentori di FreeCAD utilizzano l'API Crowdin tramite [[Crowdin_Scripts/it|Crowdin Scripts]] per eseguire il pull e il push delle traduzioni in Crowdin e di nuovo nel repository Github. L'API di Crowdin offre ai manutentori di FreeCAD la possibilità di automatizzare aspetti del flusso di lavoro di traduzione del progetto, per maggiori informazioni fare riferimento alla [https://support.crowdin.com/api/api-integration-setup/ Documentazione dell'API di Crowdin]. |
|||
<span id="Related_Pages"></span> |
<span id="Related_Pages"></span> |
||
<div class="mw-translate-fuzzy"> |
|||
== Pagine correlate == |
== Pagine correlate == |
||
* [[Crowdin Administration/it|Crowdin Administration]] |
|||
* [[Crowdin Scripts/it|Crowdin Scripts]] |
|||
</div> |
|||
* [[ |
* [[Crowdin Administration/it|Amministrazione di Crowdin]] |
||
* [[ |
* [[Crowdin Scripts/it|Crowdin Scripts]] |
||
==Scripting== |
==Scripting== |
||
{{Emphasis| |
{{Emphasis|Vedere anche:}} [[FreeCAD_Scripting_Basics|Script di base per FreeCAD]]. |
||
Per ottenere un dizionario con le lingue supportate dall'interfaccia di FreeCAD, utilizzare il metodo {{incode|supportedLocales}} del modulo {{incode|FreeCADGui}}. |
|||
{{Code|code= |
{{Code|code= |
||
Line 248: | Line 200: | ||
}} |
}} |
||
Dopo l'esecuzione {{incode|locales}} conterrà: |
|||
{{Code|code= |
{{Code|code= |
||
Line 254: | Line 206: | ||
}} |
}} |
||
Per ottenere la lingua dell'interfaccia corrente usa il metodo {{incode|getLocale}} dello stesso modulo: |
|||
{{Code|code= |
{{Code|code= |
||
Line 260: | Line 212: | ||
}} |
}} |
||
Se la lingua corrente è l'inglese {{incode|locale}} conterrà: |
|||
{{Code|code= |
{{Code|code= |
||
Line 266: | Line 218: | ||
}} |
}} |
||
Per ottenere il [https://support.crowdin.com/api/language-codes/ language code] corrispondente utilizzare: |
|||
{{Code|code= |
{{Code|code= |
||
Line 272: | Line 224: | ||
}} |
}} |
||
Se la lingua corrente è l'inglese il risultato sarà: |
|||
If the current language is English the result will be: |
|||
{{Code|code= |
{{Code|code= |
||
Line 278: | Line 230: | ||
}} |
}} |
||
Per impostare la lingua dell'interfaccia corrente utilizzare il metodo {{incode|setLocale}} dello stesso modulo. È possibile specificare la lingua o il codice della lingua: |
|||
{{Code|code= |
{{Code|code= |
||
Line 288: | Line 240: | ||
{{Docnav/it |
{{Docnav/it |
||
|[[Branding/it|Marchiatura]] |
|[[Branding/it|Marchiatura]] |
||
|[[Workbench_creation/it|Creare |
|[[Workbench_creation/it|Creare un Ambiente di lavoro]] |
||
}} |
}} |
||
Latest revision as of 07:20, 19 April 2023
Introduzione
Localizzazione è in generale il processo che fornisce un software con una interfaccia utente (GUI) multilingua. In FreeCAD è possibile impostare la lingua dell'interfaccia utente in Modifica → Preferenze → Generale. FreeCAD utilizza Qt per abilitare il supporto di più lingue. Sui sistemi Unix / Linux, FreeCAD utilizza le impostazioni locali di default del sistema.
Contribuire a tradurre FreeCAD
Una cosa molto importante che gli utenti possono fare per contribuire a FreeCAD (se per esempio non hanno competenze di programmazione) è quella di aiutare a tradurre i suoi diversi aspetti (codice sorgente, wiki, sito Web, documentazione ecc.) in un'altra lingua. Ecco i modi per farlo.
Tradurre il codice sorgente di FreeCAD
FreeCAD utilizza un sistema di traduzione in linea collaborativo di terze parti chiamato Crowdin.
È un software proprietario ma gratuito per i progetti FOSS. Sotto ci sono le istruzioni su come usarlo:
- Andare alla pagina Traduzione del progetto FreeCAD in Crowdin.
- Accedere creando un nuovo profilo, o utilizzando un account di terze parti (GitHub, GitLab, GMail etc...).
- Fare clic sulla lingua su cui si desidera lavorare.
- Iniziare a tradurre facendo clic sul pulsante Traduci accanto a uno dei file. Ad esempio, su FreeCAD.ts che contiene le stringhe di testo per la GUI principale di FreeCAD.
- Si può convalidare le traduzioni esistenti, oppure è possibile crearne di proprie.
.
Nota: I dettagli su come utilizzare crowdin possono essere trovati nella pagina Amministrazione di Crowdin.
Traduzione degli ambienti esterni
Vedere Traduzione di un ambiente esterno.
Preferenze di FreeCAD per i traduttori
A partire da FreeCAD 0.20, le seguenti variabili possono essere aggiunte manualmente alla sezione BaseApp/Preferences/General del file user.cfg per facilitare lo sviluppo di nuove traduzioni:
AdditionalLanguageDomainEntries - per aggiungere lingue completamente nuove a FreeCAD, che non sono attualmente supportate dal codice sorgente, è possibile utilizzare questa preferenza utente per aggiungere all'elenco delle lingue disponibili. Il formato delle lingue è "Language Name"="codice"; Per esempio:
<FCText Name="AdditionalLanguageDomainEntries">"Esperanto"="eo";"French"="fr";</FCText>
AdditionalTranslationsDirectory - aggiunge una directory aggiuntiva per FreeCAD per cercare i file *.qm. Questa posizione avrà la precedenza su $userAppDataDir/translations e $resourceDir/translations. Per esempio:
<FCText Name="AdditionalTranslationsDirectory">C:/Users/FreeCADUser/TestTranslations</FCText>
Tradurre il wiki
Questo wiki ospita molti contenuti, la maggior parte dei quali costruisce il manuale. È possibile sfogliare la documentazione a partire dalla Pagina principale, o dare un'occhiata al Sommario del manuale utente.
Per tradurre il wiki, si deve disporre dei permessi di modifica del wiki; vedere Come si può ottenere il permesso di modificare il wiki?.
È necessario avere una conoscenza di base sulla formattazione dello stile wiki e sulle linee guida generali del wiki di FreeCAD, perché durante la traduzione bisogna sapere cosa fare con alcuni tag. Potete trovare queste informazioni in WikiPages (en).
Plugin Mediawiki Translation
Quando il Wiki è stato spostato da SourceForge, Yorik ha installato un MediaWiki's plugin di traduzione che facilita la traduzione delle pagine. I vantaggi del plugin di traduzione sono che, ad esempio, ora può essere tradotto anche il titolo della pagina, che tiene traccia delle traduzioni, notifica se la pagina originale è stata aggiornata, e mantiene le traduzioni sincronizzate con la pagina originale inglese.
Lo strumento è documentato in Help:Extension:Translate, ed è parte di MediaWiki Language Extension Bundle.
Per sapere come preparare rapidamente una pagina per la traduzione e attivare il plugin, si prega di leggere Page translation example. In sostanza, una coppia di tag
<translate> ... </translate>
deve circondare l'intera pagina per attivare il sistema di traduzione e la pagina deve essere contrassegnata per la traduzione.
Per vedere un esempio di come funziona lo strumento di traduzione, visitare la Pagina principale. Si vedrà una barra della lingua generata automaticamente in alto. Cliccare su Deutsch (tedesco), si andrà a Main_Page/de. Proprio sotto il titolo, "Hauptseite" (in inglese "Main Page"), si può leggere Questa pagina è una versione tradotta della pagina Pagina principale e la traduzione è completa al XX%, XX è la percentuale corrente di traduzione. Fare clic su "Traduci" nella parte superiore della pagina per avviare l'utilità di traduzione per aggiornare, correggere e rivedere la traduzione esistente.
Ora se si va nella pagina Main Page, si nota che quando la pagina viene contrassegnata per la traduzione non è possibile modificarla direttamente, ma che si deve passare attraverso l'utility di traduzione.
Quando si aggiungono nuovi contenuti, prima deve essere creata la pagina inglese, e poi la pagina inglese può essere tradotta in un'altra lingua. Se qualcuno vuole cambiare o aggiungere dei contenuti in una pagina esistente, deve farlo nella pagina inglese, marcarla per la traduzione e poi tradurre i contenuti editati.
Se non siete sicuri su come procedere, non esitate a chiedere aiuto nel Development → Wiki subforum o nel specific language subforum del FreeCAD forum.
Note importanti
Ogni utente del wiki che dispone delle autorizzazioni "Editor" è in grado di avviare l'utilità di traduzione per scrivere, salvare e rivedere le traduzioni.
Tuttavia, solo gli utenti con permessi di "Amministratore" possono contrassegnare le pagine per la traduzione. Una pagina che non è stata contrassegnata per la traduzione non fa uso dell'estensione di traduzione e non è sincronizzata correttamente con le informazioni in inglese.
Anche la barra laterale (il menu di navigazione a sinistra) è traducibile, ma solo gli amministratori possono modificare questo elemento del sito. Si prega di seguire le istruzioni dedicate a questo nella pagina Tradurre la Sidebar.
La prima volta che una pagina viene passata al nuovo sistema di traduzione perde tutte le sue vecchie traduzioni "manuali". Per recuperare una traduzione, bisogna salvare una copia offline del vecchio testo prima della conversione. Quindi si può usare questo vecchio testo tradotto per riempire le unità di traduzione nel nuovo sistema. Si può anche aprire una versione precedente dalla cronologia (pulsante History) e ottenere il vecchio testo in questo modo. Questo deve essere fatto per ogni lingua che ha una pagina tradotta.
Tradurre la documentazione di FreeCAD
Come da consenso generale, la pagina di riferimento nel wiki è la pagina inglese, che dovrebbe essere creata per prima. Se si desidera modificare o aggiungere contenuto a una pagina, è necessario farlo prima alla pagina inglese e solo una volta completato l'aggiornamento, portare la modifica nella pagina tradotta.
Vecchie istruzioni di traduzione
Queste istruzioni sono solo un background storico, mentre le pagine vengono passate al nuovo plugin di traduzione. |
Il primo passo è controllare se è già stata avviata la traduzione del manuale per la propria lingua (cercare nella barra laterale sinistra, sotto "manual").
Convenzioni sui nomi delle pagine
#REDIRECT [[About FreeCAD/fr]]
{{docnav/fr|Bienvenue sur l'aide en ligne|Fonctionnalités}} La pagina "Bienvenue sur l'aide en ligne" reindirizza a Online Help Startpage/fr, e la pagina "Fonctionnalités" reindirizza a Feature list/fr. |
Tradurre il sito Web di FreeCAD
La traduzione del sito Web di FreeCAD viene ora eseguita tramite Crowdin. Il file si chiama homepage.po.
Sviluppo - Come aggiungere la localizzazione
Questa sezione è per gli sviluppatori che desiderano aggiungere la localizzazione al loro codice.
Preparare i moduli di FreeCAD/master per la traduzione
Queste sono le parti del processo di traduzione di FreeCAD:
- estrarre le stringhe di testo dal codice sorgente nei file *.ts
- caricare i file *.ts in FreeCAD Crowdin.
- tradurre le stringhe all'interno di Crowdin
- estrarre i file *.ts nuovi o modicati da Crowdin
- convertire i file *.ts in file *.qm e aggiornare il file *.qrc di ogni modulo
- aggiornare FreeCAD master
Tutti i passaggi precedenti sono eseguiti dagli "script di traduzione" che vengono eseguiti periodicamente da un amministratore.
Preparare il modulo per la traduzione è abbastanza semplice. Innanzitutto, è necessario assicurarsi di avere una directory "translations" in myModule/Gui/Resources. Quindi aprire una finestra di terminale (o equivalente in Windows/OSX) nella directory "translations" e inserire il seguente comando:
lupdate -ts myModule.ts
Questo crea un file di traduzione vuoto. Una volta fatto ciò, è necessario assicurarsi che gli script di traduzione siano aggiornati come in questa pull request.
Tutto quello che segue va in automatico per quanto riguarda lo sviluppatore. L'amministratore estrarrà le stringhe di testo, i traduttori le tradurranno, quindi l'amministratore estrarrà le traduzioni e aggiornerà FreeCAD/master.
Preparare il proprio modulo o la macro per la traduzione
I moduli o le macro di terze parti vengono tradotti più o meno allo stesso modo, tranne per il fatto che si deve eseguire parte del lavoro da solo. Questa discussione del forum descrive i dettagli.
Aggiornamento: vedere Traduzione di un ambiente di lavoro esterno
Precedenti tecniche di traduzione dei moduli
Vecchi metodi di localizzazione descrive in dettaglio l'uso di strumenti di traduzione come Qt Linguist, lupdate, lrelease, pylupdate4, ecc. La maggior parte di questi strumenti non sono più richiesti per i moduli FreeCAD/master, ma può essere utile conoscerli per la preparazione e l'aggiornamento di moduli di terze parti.
Aggiornamento automatico delle traduzioni in Crowdin
Attualmente i manutentori di FreeCAD utilizzano l'API Crowdin tramite Crowdin Scripts per eseguire il pull e il push delle traduzioni in Crowdin e di nuovo nel repository Github. L'API di Crowdin offre ai manutentori di FreeCAD la possibilità di automatizzare aspetti del flusso di lavoro di traduzione del progetto, per maggiori informazioni fare riferimento alla Documentazione dell'API di Crowdin.
Pagine correlate
Scripting
Vedere anche: Script di base per FreeCAD.
Per ottenere un dizionario con le lingue supportate dall'interfaccia di FreeCAD, utilizzare il metodo supportedLocales
del modulo FreeCADGui
.
locales = FreeCADGui.supportedLocales()
Dopo l'esecuzione locales
conterrà:
{'English': 'en', 'Afrikaans': 'af', 'Arabic': 'ar', 'Basque': 'eu', 'Catalan': 'ca', 'Chinese Simplified': 'zh-CN', 'Chinese Traditional': 'zh-TW', 'Croatian': 'hr', 'Czech': 'cs', 'Dutch': 'nl', 'Filipino': 'fil', 'Finnish': 'fi', 'French': 'fr', 'Galician': 'gl', 'German': 'de', 'Hungarian': 'hu', 'Indonesian': 'id', 'Italian': 'it', 'Japanese': 'ja', 'Kabyle': 'kab', 'Korean': 'ko', 'Lithuanian': 'lt', 'Norwegian': 'no', 'Polish': 'pl', 'Portuguese': 'pt-PT', 'Portuguese, Brazilian': 'pt-BR', 'Romanian': 'ro', 'Russian': 'ru', 'Slovak': 'sk', 'Slovenian': 'sl', 'Spanish': 'es-ES', 'Swedish': 'sv-SE', 'Turkish': 'tr', 'Ukrainian': 'uk', 'Valencian': 'val-ES', 'Vietnamese': 'vi'}
Per ottenere la lingua dell'interfaccia corrente usa il metodo getLocale
dello stesso modulo:
locale = FreeCADGui.getLocale()
Se la lingua corrente è l'inglese locale
conterrà:
'English'
Per ottenere il language code corrispondente utilizzare:
locale = FreeCADGui.supportedLocales()[Gui.getLocale()]
Se la lingua corrente è l'inglese il risultato sarà:
'en'
Per impostare la lingua dell'interfaccia corrente utilizzare il metodo setLocale
dello stesso modulo. È possibile specificare la lingua o il codice della lingua:
FreeCADGui.setLocale('Russian')
FreeCADGui.setLocale('ru')
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub