Localisation/fr: Difference between revisions
(Updating to match new version of source page) |
(Updating to match new version of source page) |
||
Line 1: | Line 1: | ||
{{Page_in_progress}} |
|||
<languages/> |
<languages/> |
||
Line 46: | Line 45: | ||
'''AdditionalLanguageDomainEntries''' - to add entirely new languages to FreeCAD that are not currently supported by the source code, you can use this user preference to add to the list of available languages. The format of the languages is "Language Name"="code"; for example: |
'''AdditionalLanguageDomainEntries''' - to add entirely new languages to FreeCAD that are not currently supported by the source code, you can use this user preference to add to the list of available languages. The format of the languages is "Language Name"="code"; for example: |
||
<pre> |
<pre> |
||
<FCText Name="AdditionalLanguageDomainEntries">"Esperanto"="eo";"French"="fr";</FCText> |
<FCText Name="AdditionalLanguageDomainEntries">"Esperanto"="eo";"French"="fr";</FCText> |
||
</pre> |
</pre> |
||
'''AdditionalTranslationsDirectory''' - add an additional directory for FreeCAD to search for *.qm files. This location will take precedence over $userAppDataDir/translations and $resourceDir/translations. For example |
'''AdditionalTranslationsDirectory''' - add an additional directory for FreeCAD to search for *.qm files. This location will take precedence over $userAppDataDir/translations and $resourceDir/translations. For example: |
||
<pre> |
<pre> |
||
<FCText Name="AdditionalTranslationsDirectory">C:/Users/FreeCADUser/TestTranslations</FCText> |
<FCText Name="AdditionalTranslationsDirectory">C:/Users/FreeCADUser/TestTranslations</FCText> |
||
Line 70: | Line 71: | ||
Pour commencer rapidement la préparation d'une page pour la traduction et activer le plugin, veuillez lire l'[https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_example/fr Exemple de traduction de page]. Essentiellement, une paire de |
Pour commencer rapidement la préparation d'une page pour la traduction et activer le plugin, veuillez lire l'[https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_example/fr Exemple de traduction de page]. Essentiellement, une paire de |
||
<pre> |
<pre> |
||
<translate> ... </translate> |
<translate> ... </translate> |
||
</pre><!--using lt and gt so that tags are not recognized--> |
|||
balises doit entourer la page entière pour activer le système de traduction, et la page doit être marquée pour traduction. |
balises doit entourer la page entière pour activer le système de traduction, et la page doit être marquée pour traduction. |
||
Line 175: | Line 179: | ||
{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]]. |
{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]]. |
||
To get |
To get a dictionary with the languages the FreeCAD interface supports, use the {{incode|supportedLocales}} method of the {{incode|FreeCADGui}} module. |
||
{{Code|code= |
{{Code|code= |
||
locales = |
locales = FreeCADGui.supportedLocales() |
||
}} |
}} |
||
After execution |
After execution {{incode|locales}} will contain: |
||
{{Code|code= |
{{Code|code= |
||
Line 187: | Line 191: | ||
}} |
}} |
||
To get |
To get the current interface language use the {{incode|getLocale}} method of the same module: |
||
{{Code|code= |
{{Code|code= |
||
locale = FreeCADGui.getLocale() |
|||
}} |
}} |
||
If the current language is English {{incode|locale}} will contain: |
|||
In resulit, loc is equals: |
|||
{{Code|code= |
{{Code|code= |
||
Line 199: | Line 203: | ||
}} |
}} |
||
To get the corresponding [https://support.crowdin.com/api/language-codes/ language code] you can use use: |
|||
To convert this value into locale code, use a simple technique: |
|||
{{Code|code= |
{{Code|code= |
||
locale = FreeCADGui.supportedLocales()[Gui.getLocale()] |
|||
}} |
}} |
||
If the current language is English the result will be: |
|||
Resulit is: |
|||
{{Code|code= |
{{Code|code= |
||
Line 211: | Line 215: | ||
}} |
}} |
||
To set |
To set the current interface language use the {{incode|setLocale}} method of the same module. You can specify the language or the language code: |
||
You can specify the language explicitly: |
|||
{{Code|code= |
{{Code|code= |
||
FreeCADGui.setLocale('Russian') |
|||
⚫ | |||
}} |
}} |
||
Or you can set langage directly by locale code: |
|||
{{Code|code= |
|||
⚫ | |||
}} |
|||
{{Docnav/fr |
{{Docnav/fr |
||
Line 233: | Line 231: | ||
[[Category:Developer Documentation{{#translation:}}]] |
[[Category:Developer Documentation{{#translation:}}]] |
||
[[Category:Wiki{{#translation:}}]] |
[[Category:Wiki{{#translation:}}]] |
||
{{clear}} |
Revision as of 18:25, 19 September 2021
Vue d’ensemble
La localisation en général, est le processus de fourniture d'un logiciel avec une interface utilisateur en plusieurs langues. Dans FreeCAD vous pouvez définir la langue d'interface utilisateur dans le menu Édition → Préférences → Général → Onglet Général → Langue. FreeCAD utilise Qt pour activer le support de plusieurs langues. Sur les systèmes Unix/Linux, FreeCAD utilise les paramètres régionaux actuels de votre système par défaut.
Aider à la traduction de FreeCAD
Une des choses importantes que les utilisateurs peuvent apporter à FreeCAD (s’ils ne possèdent pas de compétences en programmation, par exemple) est d’aider à traduire ses différents aspects (code source, wiki, site Web, documentation, etc.) dans une autre langue. Voici les moyens de le faire.
Traduire le code source de FreeCAD
FreeCAD utilise un système de traduction en ligne tiers collaboratif appelé Crowdin.
Il s'agit d'un logiciel propriétaire mais gratuit pour les projets FOSS. Vous trouverez ci-dessous des instructions sur son utilisation :
- Aller à la page du projet de traduction de FreeCAD sur Crowdin ;
- Connectez-vous en créant un nouveau profil, ou en utilisant un compte tiers, comme votre adresse (GitHub, GitLab, GMail etc...) ;
- Cliquez sur la langue que vous souhaitez traduire ;
- Commencez la traduction en cliquant sur le bouton Translate à côté d'un des fichiers. Par exemple, FreeCAD.ts contient les chaînes de texte pour l'interface principale de FreeCAD ;
- Vous pouvez voter pour les traductions existantes, ou créer une nouvelle traduction.
Remarque : les détails sur l'utilisation de crowdin peuvent être trouvés sur la page Administration de Crowdin.
Traduction des ateliers externes
Visitez Traduction d'un atelier externe.
FreeCAD Preferences for Translators
Starting with FreeCAD 0.20, the following variables can be manually added to the BaseApp/Preferences/General section of the user.cfg file to assist with the development of new translations:
AdditionalLanguageDomainEntries - to add entirely new languages to FreeCAD that are not currently supported by the source code, you can use this user preference to add to the list of available languages. The format of the languages is "Language Name"="code"; for example:
<FCText Name="AdditionalLanguageDomainEntries">"Esperanto"="eo";"French"="fr";</FCText>
AdditionalTranslationsDirectory - add an additional directory for FreeCAD to search for *.qm files. This location will take precedence over $userAppDataDir/translations and $resourceDir/translations. For example:
<FCText Name="AdditionalTranslationsDirectory">C:/Users/FreeCADUser/TestTranslations</FCText>
Traduire le wiki FreeCAD
Ce wiki héberge un contenu volumineux, dont l'essentiel sert à produire le manuel. Vous pouvez naviguer dans la documentation à partir de la Page principale, ou consulter la table des matières du guide utilisateur.
Pour pouvoir traduire le wiki, vous devez bien sûr obtenir les droits d'édition au wiki.
Il est recommandé d'avoir des connaissances de base du formatage de style wiki et des directives générales du wiki FreeCAD, car vous devrez ajuster le code de balisage lors des traductions. Vous trouverez cette information sur la page Les pages Wiki.
Extension de traduction Mediawiki
Après le départ du wiki de SourceForge, Yorik a installé un plugin de traduction MediaWiki qui facilite les traductions de pages. Les avantages de l'extension de traduction sont que le titre de la page peut maintenant être traduit, qu'il garde une trace des traductions, qu'il informe si la page d'origine a été mise à jour et qu'il maintient la synchronisation des traductions avec la page anglaise d'origine.
L'outil est documenté dans MediaWiki Traduire, et fait partie du MediaWiki Language Extension Bundle.
Pour commencer rapidement la préparation d'une page pour la traduction et activer le plugin, veuillez lire l'Exemple de traduction de page. Essentiellement, une paire de
<translate> ... </translate>
balises doit entourer la page entière pour activer le système de traduction, et la page doit être marquée pour traduction.
Pour voir un exemple de comment l'outil de traduction fonctionne, vous pouvez visiter la Page principale. Vous verrez qu'une barre de menu de langues est automatiquement générée en haut de page. Cliquez par exemple sur le lien français et vous serez redirigé sur Main_Page/fr. Juste sous le titre, vous pourrez lire Cette page est une version traduite de la page Main Page et la traduction est complétée à XX %. (XX étant le pourcentage de traduction réalisé). Cliquez sur le lien "Traduire" pour lancer l'utilitaire de traduction pour mettre à jour, corriger ou revoir une traduction existante.
Si vous allez sur WIKI : Page principale, vous remarquerez que vous ne pouvez plus "éditer" directement une page une fois qu'elle a été marquée pour "traduction". Vous devez passer par l'outil de traduction.
Lors de l'ajout de nouveau contenu, la page anglaise devrait être créée en premier, puis traduite dans une autre langue. Si vous désirez changer ou ajouter du contenu dans une page, la modification doit en premier se faire dans la page anglaise.
Si vous ne savez pas comment procéder, n'hésitez pas à demander de l'aide dans le sous-forum Development → Wiki ou dans le sous-forum français.
Remarques importantes
Chaque utilisateur du wiki disposant des autorisations "Éditeur" peut lancer l'utilitaire de traduction pour écrire, enregistrer et réviser les traductions.
Cependant, seuls les utilisateurs disposant des autorisations "Administrateur" peuvent marquer des pages pour traduction. Une page qui n'est pas marquée pour la traduction n'utilisera pas l'extension de traduction et ne sera pas correctement synchronisée avec les informations en anglais.
La barre latérale gauche est également traduisible, mais seuls les administrateurs peuvent modifier cet élément du site. Veuillez suivre les instructions dédiées sur la page Barre latérale locale.
La première fois que vous basculez une page vers le nouveau système de traduction, toutes les anciennes traductions "manuelles" sont perdues. Pour récupérer une traduction, vous devez enregistrer une copie hors ligne de l'ancien texte avant le changement. Vous pouvez ensuite utiliser cet ancien texte traduit pour renseigner les unités de traduction du nouveau système. Vous pouvez également ouvrir une version antérieure de l'historique et récupérer l'ancien texte de cette manière. Cela doit être fait pour chaque langue ayant une page traduite.
Traduire la documentation de FreeCAD
Conformément au consensus général, la page de référence dans le wiki est la page anglaise, qui devrait être créée en premier. Si vous souhaitez modifier ou ajouter du contenu à une page, vous devez d'abord le faire sur la page anglaise, puis reporter la modification sur la page traduite une fois la mise à jour terminée.
Anciennes instructions de traduction
Ces instructions sont pour l'historique seulement. Les traductions doivent utiliser le nouveau système avec Mediawiki Extension de traduction décrite ci-dessus. |
La première étape consiste donc à vérifier si la traduction manuelle a déjà été commencée pour votre langue (regardez dans la barre latérale gauche, sous "manuel").
Page Naming Convention
#REDIRECT [[About_FreeCAD/fr]]
{{docnav/fr|[[Online_Help_Startpage/fr|Bienvenue dans l'aide en ligne de FreeCAD]]|[[Feature_list/fr|Fonctionnalités]]}} La page "Bienvenue sur l'aide en ligne" redirige vers l'aide en ligne Startpage/fr et la page "Fonctionnalités" redirige Feature_list/fr. |
Traduire le site Web FreeCAD
La traduction du site Web FreeCAD est maintenant effectuée par le biais de Crowdin. Le fichier est nommé homepage.po.
Développement - Comment ajouter une localisation
Cette section est destinée aux développeurs qui souhaitent ajouter la localisation dans leur code.
Préparer vos modules maîtres/Freecad pour la traduction
Voici les parties du processus de traduction de FreeCAD :
- extraire les chaînes de texte du code source dans des fichiers *.ts
- télécharger les fichiers *.ts dans le Crowdin FreeCAD.
- traduire les chaînes dans Crowdin
- extraire les nouveau fichiers ou fichiers modifiés *.ts de Crowdin
- convertir les fichiers *.ts en fichiers *.qm et mettre à jour le fichier *.qrc de chaque module
- mettre à jour la branche master de FreeCAD
Toutes les étapes listées ci-dessus sont exécutées par des "scripts de traduction" qui sont lancés périodiquement par un administrateur.
Préparer votre module à la traduction est très facile. D'abord, assurez-vous de créer un répertoire "translations" dans myModule/Gui/Resources. Puis ouvrez une fenêtre de terminal (ou l'équivalent Windows/OSX) dans votre répertoire "translations", et saisissez la commande suivante :
lupdate -ts myModule.ts
Ceci crée un fichier de traduction vide. Une fois cette tâche complétée, vous devez vous assurer que les scripts de traduction sont mis à jour comme dans cette pull request.
La suite se fait automatiquement, en ce qui concerne le développeur. L'administrateur fera l'extraction des chaînes de texte, les traducteurs les traduiront, puis l'administrateur extraira les traductions et mettra à jour la branche FreeCAD/master.
Préparer votre module de tierce partie ou macro pour la traduction
Les modules de tierce partie ou macros sont traduits de façon similaire, mais vous devez vous charger d'une partie du travail. Cette discussion sur le forum (en anglais) décrit les détails.
Mise à jour : voir Traduction d'un atelier externe
Anciennes techniques de traduction des modules
La page Ancienne méthode de localisation décrit l'utilisation d'outils de traduction tels que Qt Linguist, lupdate, lrelease, pylupdate4, etc. en détail. La plupart de ces opérations ne sont plus nécessaires pour les modules FreeCAD/master, mais peuvent s'avérer utiles pour préparer et mettre à jour des modules tiers.
Automatiser les mises à jour de translations Crowdin
Actuellement, les mainteneurs de FreeCAD utilisent l’API Crowdin via Crowdin Scripts pour extraire et transférer les traductions vers Crowdin, puis vers le dépôt Github. L'API Crowdin donne aux responsables de FreeCAD la possibilité d'automatiser certains aspects du flux de traduction du projet. Pour plus d'informations, reportez-vous à la documentation de l'API Crowdin.
Pages en relation
Scripting
See also: FreeCAD Scripting Basics.
To get a dictionary with the languages the FreeCAD interface supports, use the supportedLocales
method of the FreeCADGui
module.
locales = FreeCADGui.supportedLocales()
After execution locales
will contain:
{'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'}
To get the current interface language use the getLocale
method of the same module:
locale = FreeCADGui.getLocale()
If the current language is English locale
will contain:
'English'
To get the corresponding language code you can use use:
locale = FreeCADGui.supportedLocales()[Gui.getLocale()]
If the current language is English the result will be:
'en'
To set the current interface language use the setLocale
method of the same module. You can specify the language or the language code:
FreeCADGui.setLocale('Russian')
FreeCADGui.setLocale('ru')
- Démarrer avec FreeCAD
- Installation : Téléchargements, Windows, Linux, Mac, Logiciels supplémentaires, Docker, AppImage, Ubuntu Snap
- Bases : À propos de FreeCAD, Interface, Navigation par la souris, Méthodes de sélection, Objet name, Préférences, Ateliers, Structure du document, Propriétés, Contribuer à FreeCAD, Faire un don
- Aide : Tutoriels, Tutoriels vidéo
- Ateliers : Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test