Localizzazione
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 → Applicazione.
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. Di seguito 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.
.
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 poter tradurre nel wiki, è necessario richiedere l'autorizzazione.
È 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.
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 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 "This page is a translated version of a page Main Page and the translation is xx% complete." "Questa pagina è una versione tradotta di Main Page e la traduzione è xx% completa." (xx è la percentuale attuale di traduzione). Cliccare sul link "Translate this page" per avviare la traduzione, o per aggiornare o correggere la traduzione esistente.
Noterete che quando la pagina è stata 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 e 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. Si prega di seguire le istruzioni dedicate a questo nella pagina Localisation Sidebar.
NOTA: La prima volta che una pagina viene passata al nuovo sistema di traduzione perde tutte le sue vecchie traduzioni "manuali". Per recuperare le traduzioni, è necessario aprire una versione precedente dalla cronologia (pulsante History), e fare manualmente il copia/incolla dei precedenti paragrafi nel nuovo sistema di traduzione.
Vecchie istruzioni di traduzione
Queste istruzioni sono solo un background storico, mentre le pagine vengono passate al nuovo plugin di traduzione. |
Quindi il primo passo è controllare se è già stato 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. |
Translate the FreeCAD website
Translation of the FreeCAD website is now done through Crowdin. The file is named homepage.po.
Translate the FreeCAD documentation
Development - How to Add Localisation
This section is for developers who want to add localisation to their code.
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 nuovi o modicati file *.ts 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 questo, è necessario assicurarsi che gli script di traduzione siano aggiornati come in questa pull request.
Tutto ciò che segue è automatico per quanto riguarda lo sviluppatore. L'amministratore estrae le stringhe di testo, i traduttori le traducono, quindi l'amministratore estrae le traduzioni e aggiorna FreeCAD/master.
Preparare il proprio modulo o la macro per la traduzione
I moduli di terze parti o le macro sono tradotti in modo molto simile, tranne per il fatto che bisogna fare un po' di lavoro da soli. Questa discussione nel forum descrive i dettagli.
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 questo non è più richiesto per i moduli di FreeCAD/master, ma può essere utile per preparare e aggiornare i moduli di terze parti.
Aggiornamento automatico delle traduzioni
Attualmente FreeCAD utilizza l'API Crowdin tramite Crowdin Scripts per estrarre e trasferire le traduzioni in Crowdin e riportarle nel repository Github.
Related Pages
![](/images/thumb/9/94/User_hub.png/24px-User_hub.png)
- 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, Assembly, BIM, 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