Localisation/it

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 importante che si può fare per FreeCAD, se non si è un programmatore, è quella di contribuire a tradurre il programma nella propria lingua.

Ora, con l'uso di Crowdin, un sistema collaborativo di traduzione on line, contribuire è più facile che mai.

Come tradurre

 * Andare alla pagina Progetto di traduzione di FreeCAD in Crowdin;
 * Accedere creando un nuovo profilo, o utilizzando un account di terze parti come il proprio indirizzo Gmail;
 * 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.

Note: 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: http://www.freecadweb.org/tracker/view.php?id=137

Traduzione con Qt-Linguist (forma antiquata - OBSOLETA)
Le seguenti informazioni non devono più essere utilizzate ed è probabile che diventino obsolete. Sono mantenute qui in modo che i programmatori possano conoscere come funziona.


 * Aprire tutte le cartelle di lingua di FreeCAD riportate in seguito
 * Verificare che non esista un file .ts file con il codice della lingua ("fr" per francese, "de" per tedesco, etc...)
 * Se esiste, è possibile scaricare il file, se si vuole modificare / rivedere / megliorare la traduzione (fare clic sul file, quindi scaricare)
 * Se non esiste, scaricare i file .ts senza il codice della lingua (o qualsiasi altro .ts disponibile, funzionerà ugualmente)
 * Rinominare il file con il codice della propria lingua
 * Aprirlo con il programma Qt-Linguist
 * Iniziare la traduzione (Qt Linguist è molto semplice da usare)
 * Terminata la traduzione, salvare il file
 * Inviare i file in modo da poterli includere nel codice sorgente di FreeCAD e consentire l'utilizzo della traduzione anche ad altri utenti.

Archivio dei file di traduzione disponibili

 * FreeCAD main GUI
 * Complete Workbench
 * Drawing Workbench
 * Draft Workbench
 * Reverse Engineering Workbench
 * FEM Workbench
 * Robot Workbench
 * Image Workbench
 * Sketcher Workbench
 * Mesh Workbench
 * Test Workbench
 * Points Workbench
 * Raytracing Workbench
 * Part Workbench
 * PartDesign Workbench
 * Assembly Workbench
 * MeshPart Workbench

Prerequisiti
Per realizzare la traduzione del modulo dell'applicazione servono delle utility fornite con Qt. Esse si possono scaricare da Trolltech-Website, ma sono anche contenute in LibPack:
 * qmake: Genera i file del progetto
 * lupdate: Estrae o aggiorna i testi originali del progetto tramite la scansione del codice sorgente
 * Qt-Linguist: Qt-Linguist è molto facile da usare, agevola la traduzione con pratiche funzioni e dispone di un frasario per le espressioni più comuni.

Installazione del progetto
Per iniziare la localizzazione del progetto andare alla GUI-Part del prorio modulo e digitare sulla riga di comando:

qmake -project

Questo esegue la scansione della directory del progetto alla ricerca dei file contenenti stringhe di testo e crea un file di progetto come nel seguente esempio:

TEMPLATE = app DEPENDPATH += .\Icons INCLUDEPATH +=. HEADERS += ViewProvider.h Workbench.h SOURCES += AppMyModGui.cpp \ Command.cpp \ ViewProvider.cpp \ Workbench.cpp TRANSLATIONS += MyMod_de.ts
 * 1) Automatically generated by qmake (1.06c) Do 2. Nov 14:44:21 2006
 * 1) Automatically generated by qmake (1.06c) Do 2. Nov 14:44:21 2006
 * 1) Input

È possibile aggiungere manualmente i file qui. La sezione TRANSLATIONS contiene un elenco di file con la traduzione per ogni lingua. Nell'esempio precedente MyMod_de.ts è la traduzione in tedesco.

Ora è necessario eseguire lupdate per estrarre tutte le stringhe letterali nella propria GUI. Eseguire lupdate dopo le modifiche del codice sorgente è sempre una operazione sicura in quanto non cancella mai stringhe dai file di traduzione. Aggiunge solo le nuove stringhe.

Ora è necessario aggiungere i file .ts al proprio progetto VisualStudio. Specificare per essi il seguente metodo di costruzione personalizzato: python ..\..\..\Tools\qembed.py "$(InputDir)\$(InputName).ts" "$(InputDir)\$(InputName).h" "$(InputName)" Nota: Inserire questo comando in un'unica riga, l'interruzione di riga è finalizzata solo alla visualizzazione.

Compilando il file .ts dell'esempio precedente, si crea un file di di intestazione MyMod_de.h. La posizione migliore per memorizzare questo file è AppGui.cpp. In questo esempio potrebbe essere AppMyModGui.cpp. Aggiungere lì la riga: new Gui::LanguageProducer("Deutsch", _de_h_data, _de_h_len); per pubblicare la traduzione nell'applicazione.

Configurare i file python per la traduzione
Per facilitare la localizzazione dei file .py è possibile utilizzare lo strumento pylupdate4 che accetta uno o più file .py. Con l'opzione -ts si può preparare / aggiornare uno o più file .ts. Ad esempio per preparare un file .ts per la traduzione in francese è sufficiente inserire nella riga di comando: pylupdate4 *.py -ts YourModule_fr.ts

lo strumento pylupdate esegue la scansione dei file .py per le funzioni translate o tr y e crea un file YourModule_fr.ts. Si può tradurre questo file con QLinguist e produrre il file YourModule_fr.qm con QLinguist o con il comando:

lrelease YourModule_fr.ts

Attenzione che lo strumento pylupdate4 non è molto efficace nel riconoscere le funzioni translate, esse devono essere formattate in modo molto specifico (vedere come esempio i file del modulo Progetto Draft). All'interno del file, è possibile impostare un traduttore come questo (dopo il caricamento delle QApplication però PRIMA di creare qualsiasi widget Qt):

translator = QtCore.QTranslator translator.load("YourModule_"+languages[ln]) QtGui.QApplication.installTranslator(translator) Facoltativamente, è possibile anche creare il file XML Draft.qrc con questo contenuto:   Draft_fr.qm 

e eseguire pyrcc4 Draft.qrc -o qrc_Draft.py che crea un grande file Python contenente tutte le risorse. Questo metodo funziona anche per inserire i file di icona in un file di risorse

Tradurre il wiki
Questo wiki ospita svariati contenuti. Il materiale più aggiornato e interessante viene raccolto nel manuale.

Quindi il primo passo è controllare se è già stato avviata la traduzione del manuale per la propria lingua (cercare nella barra laterale sinistra, sotto "manual").

In caso contrario, andare al forum e comunicare che si intende avviare una nuova traduzione, creeremo le impostazioni di base per la lingua che si desidera lavorare.

È necessario ottenere il permesso di modifica del wiki.

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

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.

Aggiungere una barra e il codice della propria lingua nelle categorie, come

Quindi, terminata la traduzione di una pagina, è necessario aggiungere alla pagina originale in inglese un link alla propria traduzione, per far sapere ai lettori che esiste una versione tradotta disponibile, utilizzando il modello. Guardare come hanno fatto gli altri traduttori.


 * Nella pagina originale in inglese aggiungere la proria lingua in ordine alfabetico:


 * Nella pagina tradotta è necessario utilizzare il modello della propria lingua e mettere per prima l'inglese e poi il resto delle lingue in ordine alfabetico:

Se non si è sicuri, andare nel forum e richiedere un controllo su quello che si è fatto, qualcuno vi dirà se và bene oppure no.

Nelle pagine del manuale sono comunemente utilizzati quattro modelli (maschere standard). Questi 4 modelli hanno versioni localizzate (Template:Docnav/it, Template:it, etc...)
 * Template:GuiCommand : è il blocco di informazioni del comando Gui in alto a destra nella documentazione del comando.
 * Template:Docnav : è la barra di navigazione visualizzata nella parte inferiore delle pagine, mostra le pagine precedenti e successive
 * Template:Languages : questo modello deve essere posto sulle pagine originali, per indicare al lettore che esiste una traduzione. La versione localizzata Template:Languages/it deve essere inserito nella pagina tradotta, per stabilire il collegamento alla pagina originale in inglese.
 * Template:en : c'è uno di questi modelli per ogni lingua. Essi devono essere posizionati all'interno del modello lingua.

Convenzioni sui nomi delle pagine
Si prega di prendere atto che, a causa di limitazioni in Sourceforge al motore MediaWiki, è necessario che tutte le pagine tradotte mantengano il nome originale in inglese della pagina corrispondente, con l'aggiunta di uno slash e del codice della lingua. Per esempio, la pagina tradotta di About FreeCAD deve essere About Freecad/it in italiano, About FreeCAD/pl in polacco, etc. Il motivo è semplice: in questo modo se i traduttori interrompono il lavoro, gli amministratori del wiki, che non parlano tutte le lingue, sanno di quali pagine si tratta. Ciò facilita la manutenzione ed evita di perdere delle pagine.

Se si desidera che il modello Docnav mostri pagine collegate nella propria lingua, è possibile utilizzare redirect pages. Esse sono sostanzialmente collegate alla pagina vera e propria. Ecco un esempio con la pagina in francese di About FreeCAD.

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 About FreeCAD/fr è la pagina con il contenuto
 * La pagina À propos de FreeCAD contiene contiene questo codice:
 * 1) REDIRECT About FreeCAD/fr
 * Nella pagina About FreeCAD/fr, il codice Docnav sarà simile a questo:

Se non siete sicuri su come procedere, non esitate a chiedere aiuto nel forum.