Instructions de base<\/h2>\n\n
La cr\u00e9ation d’un fichier SH3L consiste \u00e0\u00a0:<\/p>\n\n
- \n
- t\u00e9l\u00e9charger une version anglaise des fichiers<\/a> \u00e0 traduire,<\/li>\n\n\n\n
- d\u00e9compresser le fichier t\u00e9l\u00e9charg\u00e9,<\/li>\n\n\n\n
- ajouter un suffixe de 2 lettres correspondant \u00e0 votre langue<\/a> aux fichiers
.properties<\/code> qu’il contient,<\/li>\n\n\n\n- traduire le texte dans les fichiers
.properties<\/code>,<\/li>\n\n\n\n- les convertir en codage ASCII,<\/li>\n\n\n\n
- traduire le texte d’aide dans les fichiers
.html<\/code> (non obligatoire, mais tr\u00e8s utile pour les utilisateurs),<\/li>\n\n\n\n- recompresser les fichiers
.properties<\/code> et les fichiers d’aide dans un fichier avec une extension SH3L,<\/li>\n\n\n\n- double-cliquer sur le fichier SH3L pour tester votre traduction dans Sweet Home 3D,<\/li>\n\n\n\n
- distribuer votre fichier SH3L.<\/li>\n<\/ol>\n\n
<\/div>\n\nInstructions d\u00e9taill\u00e9es<\/h2>\n\n
Si les instructions de base pr\u00e9c\u00e9dentes ne vous font pas peur, passez aux \u00e9tapes suivantes.<\/p>\n\n
<\/div>\n\nObtenir la version anglaise<\/h3>\n\n
T\u00e9l\u00e9chargez l’archive \u00e0 l’adresse \/SweetHome3DTranslation.zip<\/a> (version 7.5) et d\u00e9compressez-la avec les outils de votre syst\u00e8me.
.properties<\/code> et.html<\/code> plac\u00e9s dans des sous-dossiers comme indiqu\u00e9 dans la figure 1.<\/p>\n\n<\/div>\n\n![\"\"](\"data:image\/svg+xml;base64,PHN2ZyB3aWR0aD0iMSIgaGVpZ2h0PSIxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==\")
Figure 1. Fichiers de traduction <\/figcaption><\/figure>\n\n <\/div>\n\nTous les fichiers
.properties<\/code> et.html<\/code> contiennent la version anglaise des textes que vous devrez traduire dans votre langue\u00a0:<\/p>\n\n- \n
- les fichiers
package.properties<\/code> d\u00e9crivent les \u00e9tiquettes, les menus et les \u00e9l\u00e9ments de menu affich\u00e9s dans l’interface utilisateur de Sweet Home 3D,<\/li>\n\n\n\n- les fichiers
basic.properties<\/code> etmetal.properties<\/code> d\u00e9crivent les \u00e9tiquettes de dialogue standard,<\/li>\n\n\n\n- ceux qui se terminent par
Catalog.properties<\/code> d\u00e9crivent les noms des meubles et des textures disponibles dans le logiciel,<\/li>\n\n\n\n- les fichiers
.html<\/code> contiennent le texte de l’aide de Sweet Home 3D.<\/li>\n<\/ul>\n\n<\/div>\n\n\n<\/figure>\n\n\n\n<\/div>\n\n\n\nLes fichiers .properties doivent \u00eatre plac\u00e9s dans les dossiers indiqu\u00e9s dans la figure 1, sinon Sweet Home 3D ne pourra pas les utiliser correctement. Ne d\u00e9placez donc pas les fichiers hors de leur dossier, ne renommez aucun dossier (sauf le sous-r\u00e9pertoire en de help) et ne supprimez aucun dossier.<\/p>\n<\/div>\n\n
<\/div>\n\nRenommer les fichiers en fonction de votre langue<\/h3>\n\n
Avant de traduire les fichiers
.properties<\/code>, vous devez renommer chacun d’eux en ajoutant \u00e0 leur nom un trait de soulignement suivi du code ISO \u00e0 2 caract\u00e8res correspondant \u00e0 votre langue. Vous trouverez ce code dans la derni\u00e8re colonne du documenthttps:\/\/www.loc.gov\/standards\/iso639-2\/php\/English_list.php<\/g>. <\/x> de <\/x> avec ce code \u00e0 2 lettres. <\/x>. Si vous voulez traduire Sweet Home 3D en tch\u00e8que, chaque nom de fichier doit \u00eatre suffix\u00e9 par _cs<\/code>, et vous devez renommer les fichiers comme indiqu\u00e9 dans la figure 2. <\/p>\n\n<\/div>\n\nFigure 2. Fichiers de propri\u00e9t\u00e9s avec leur suffixe de code ISO <\/figcaption><\/figure>\n\n <\/div>\n\nTraduction des fichiers de propri\u00e9t\u00e9s<\/h3>\n\n
Les fichiers
.properties<\/code> sont des fichiers de texte brut et vous pouvez les modifier avec n’importe quel \u00e9diteur de texte comme Wordpad<\/em>, TextEdit<\/em> ou emacs<\/em>. Par exemple, le fichiercom\/eteks\/sweethome3d\/package.properties<\/code> dans Sweet Home 3D 3.0 contient le texte suivant\u00a0: <\/p>\n\n# package.properties 10 oct. 2007\n# \n# Copyright (c) 2024 Space Mushrooms <info@sweethome3d.com>. All Rights Reserved.\n# \n# This program is free software; you can redistribute it and\/or modify it under\n# the terms of the GNU General Public License as published by the Free Software\n# Foundation; either version 2 of the License, or (at your option) any later\n# version.\n# \n# This program is distributed in the hope that it will be useful, but WITHOUT\n# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS\n# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more\n# details.\n# \n# You should have received a copy of the GNU General Public License along with\n# this program; if not, write to the Free Software Foundation, Inc., 59 Temple\n# Place, Suite 330, Boston, MA 02111-1307 USA\n\n# Resources for HomeFramePane class<\/font>\nHomeFramePane.untitled<\/font>=Sans titre\n\n\n# Resources for MacOSXConfiguration class<\/font>\nMacOSXConfiguration.WINDOW_MENU.Name<\/font>=Fen\u00eatre\nMacOSXConfiguration.MINIMIZE.Name<\/font>=R\u00e9duire\nMacOSXConfiguration.ZOOM.Name<\/font>=Zoom\nMacOSXConfiguration.BRING_ALL_TO_FRONT.Name<\/font>=Tout ramener au premier plan\n\n\n# Resources for SweetHome3D class<\/font>\nSweetHome3D.3DError.message<\/font>=<html><\/font> Sweet Home 3D va maintenant se fermer en raison d'une erreur fatale<\/font>\n <br><\/font>dans le syst\u00e8me de rendu 3D. Veuillez mettre \u00e0 jour les pilotes DirectX\/OpenGL\n <br><\/font>de votre carte graphique.<\/font> \nSweetHome3D.3DError.title<\/font>=Erreur 3D\n \nSweetHome3D.confirmSaveAfter3DError.message<\/font>=<html><\/font> Sweet Home 3D doit maintenant se fermer en raison d'une erreur fatale dans<\/font>\n <br><\/font>le syst\u00e8me de rendu 3D. Voulez-vous enregistrer toutes les maisons modifi\u00e9es\u00a0? \nSweetHome3D.confirmSaveAfter3DError.title<\/font>=Erreur 3D\nSweetHome3D.confirmSaveAfter3DError.save<\/font>=Enregistrer\nSweetHome3D.confirmSaveAfter3DError.doNotSave<\/font>=Ne pas enregistrer<\/pre>\n\n
Un fichier
.properties<\/code> contient trois types de lignes\u00a0:<\/p>\n\n- \n
- les lignes qui commencent par un caract\u00e8re # sont des commentaires (affich\u00e9s en vert dans l’exemple pr\u00e9c\u00e9dent). Certains commentaires contiennent des informations l\u00e9gales, d’autres donnent des informations aux d\u00e9veloppeurs ou aux traducteurs. Gardez ces lignes inchang\u00e9es. <\/li>\n\n\n\n
- les lignes vides sont juste utilis\u00e9es pour s\u00e9parer les diff\u00e9rentes parties d’un fichier
.properties<\/code>.<\/li>\n\n\n\n- les autres lignes commencent par un texte utilis\u00e9 par Sweet Home 3D comme cl\u00e9 pour trouver un texte affich\u00e9 \u00e0 l’\u00e9cran (affich\u00e9 en bleu dans l’exemple pr\u00e9c\u00e9dent). Apr\u00e8s cette cl\u00e9, chacune de ces lignes contient un signe \u00e9gal (
=<\/code>) et un texte dans une langue donn\u00e9e. Votre travail commence \u00e0 partir des signes \u00e9gaux. Ne modifiez pas le texte de la cl\u00e9 et remplacez le texte anglais apr\u00e8s le signe \u00e9gal par sa traduction. <\/li>\n<\/ul>\n\nCas particuliers\u00a0:<\/p>\n\n
- \n
- Les textes commen\u00e7ant par une balise \u00ab\u00a0
<html><\/code><\/font> \n \u00bb contiennent du texte au format HTML. Ces textes contiennent d’autres balises HTML \n entre les signes \u00ab\u00a0<<\/code><\/font> \n \u00bb et \u00ab\u00a0><\/code><\/font> \u00bb, comme \u00ab\u00a0 \n<br><\/code><\/font> \u00bb dans l’exemple \n pr\u00e9c\u00e9dent, qui repr\u00e9sente un retour chariot au milieu de longs textes. \n Ne supprimez pas ces balises HTML, elles aident Sweet Home 3D \u00e0 pr\u00e9senter correctement \n certains textes. Traduire du texte entre des balises HTML n’est pas tr\u00e8s difficile, \n sauf peut-\u00eatre pour le pire texte HTML qui est la valeur de la cl\u00e9WallPanel.wallOrientationLabel.text<\/code> \n. <\/li>\n\n\n\n- Pour \u00e9viter les longues lignes dans l’\u00e9diteur de texte, certaines lignes \n sont divis\u00e9es en deux ou plusieurs lignes et ensuite s\u00e9par\u00e9es par des barres obliques inverses \u00ab\u00a0 \n
\\<\/code><\/font>\u00bb, comme la ligne commen\u00e7ant \n par \u00ab\u00a0SweetHome3D.3DError.message<\/code><\/font> \n \u00bb dans l’exemple pr\u00e9c\u00e9dent. Dans ce cas, ne supprimez pas le signe \u00ab\u00a0\\<\/code><\/font> \n \u00bb situ\u00e9 \u00e0 la fin d’une ligne, car il indique que la ligne suivante \n suit la ligne actuelle.<\/li>\n\n\n\n- Certains textes contiennent une s\u00e9quence de caract\u00e8res sp\u00e9ciaux commen\u00e7ant \n par un signe
<\/code>% , comme%s<\/code>,%d<\/code>, \n%1$s<\/code>,%2$s<\/code>… Ces s\u00e9quences de caract\u00e8res \n seront remplac\u00e9es par un nom de fichier, une unit\u00e9 ou un nombre si n\u00e9cessaire, alors \n ne les supprimez pas.%s<\/code><\/font> \n \u00bb dans le texte de la cl\u00e9 suivante \u00ab\u00a0HomeFurniturePanel.widthLabel.text<\/code><\/font>:HomeFurniturePanel.widthLabel.text<\/font>=Largeur (%s<\/font>):<\/pre>\n \u00bb sera remplac\u00e9e par l’unit\u00e9 actuellement utilis\u00e9e. Les deux s\u00e9quences de caract\u00e8res \u00ab\u00a0 \n
%1$d<\/code><\/font> \u00bb et \u00ab\u00a0%2$d<\/code><\/font> \n \u00bb qui apparaissent dans le texte de la cl\u00e9 suivante \u00ab\u00a0PrintPreviewPanel.pageLabel.text<\/code><\/font>:PrintPreviewPanel.pageLabel.text<\/font>=Page %1$d<\/font>\/%2$d<\/font><\/pre>\n \u00bb appara\u00eetront \u00e0 l’\u00e9cran comme un num\u00e9ro de page et le nombre de pages, et vous \n ne devriez traduire que le mot
Page<\/code>.<\/li>\n\n\n\n- Certains textes contiennent \u00e9galement la s\u00e9quence de caract\u00e8res sp\u00e9ciaux \u00ab\u00a0
\\n<\/code><\/font>\u00bb, comme dans l’exemple suivant\u00a0: \u00ab\u00a0HomeController.saveError<\/font>=Impossible d'enregistrer la maison dans\\n<\/font>\"%s<\/font>\"<\/pre> \u00bb. Cette s\u00e9quence de caract\u00e8res est affich\u00e9e par Sweet Home 3D comme un retour chariot pour diviser une ligne \u00e0 l’\u00e9cran, et vous ne devriez pas les supprimer.
- La valeur de la cl\u00e9
HelpController.helpIndex<\/code> indique le r\u00e9pertoire o\u00f9 les fichiers d’aide peuvent \u00eatre trouv\u00e9s. Si vous traduisez les fichiers d’aide .html<\/code>, vous devriez remplacer le sous-r\u00e9pertoireen<\/code> trouv\u00e9 par le code \u00e0 2 lettres de votre langue.HelpController.helpIndex<\/font>=\/com\/eteks\/sweethome3d\/viewcontroller\/resources\/help\/cs<\/font>\/index.html<\/pre><\/li>\n<\/ul>\n\n
- \n
- Le texte des cl\u00e9s qui se terminent par
.mnemonic<\/code> est utilis\u00e9 par Sweet Home 3D pour deviner quelle lettre dans une \u00e9tiquette ou un \u00e9l\u00e9ment de menu doit \u00eatre soulign\u00e9e pour l’acc\u00e8s au clavier. Cette lettre mn\u00e9monique d\u00e9pend du mot affich\u00e9 et vous devriez en trouver une unique par bo\u00eete de dialogue ou menu.HomeFurniturePanel.nameLabel.text<\/font>=Nom\u00a0:\nHomeFurniturePanel.nameLabel.mnemonic<\/font>=N<\/b>\nHomeFurniturePanel.nameVisibleCheckBox.text<\/font>=Afficher le nom dans le plan\nHomeFurniturePanel.nameVisibleCheckBox.mnemonic<\/font>=S<\/b>\nHomeFurniturePanel.widthLabel.text<\/font>=Largeur (%s)\u00a0:\nHomeFurniturePanel.widthLabel.mnemonic<\/font>=W<\/b><\/pre>\npeut \u00eatre traduit en fran\u00e7ais par\u00a0:
HomeFurniturePanel.nameLabel.text<\/font>=Nom\u00a0:\nHomeFurniturePanel.nameLabel.mnemonic<\/font>=N<\/b>\nHomeFurniturePanel.nameVisibleCheckBox.text<\/font>=Afficher le nom dans le plan\nHomeFurniturePanel.nameVisibleCheckBox.mnemonic<\/font>=S<\/b>\nHomeFurniturePanel.widthLabel.text<\/font>=Largeur (%s)\u00a0:\nHomeFurniturePanel.widthLabel.mnemonic<\/font>=L<\/b><\/pre> \n<\/li>\n\n\n\n
- Utilisez Sweet Home 3D ou la page d’importation de mod\u00e8les 3D<\/a> pour vous aider \u00e0 traduire les fichiers
.properties<\/code> se terminant parCatalog.properties<\/code>.<\/li>\n<\/ul>\n\n<\/div>\n\nConversion des fichiers de propri\u00e9t\u00e9s en codage ASCII<\/h3>\n\n
<\/a>Si vous avez traduit des textes dans une langue dont les lettres n’appartiennent pas au codage ISO-8859-1<\/a> (principalement les langues d’Europe centrale et orientale et les langues avec un alphabet non latin), vous devrez convertir tous vos fichiers
.properties<\/code> en un codage ASCII pris en charge par Sweet Home 3D. Cette conversion peut \u00eatre effectu\u00e9e avec l’outilnative2ascii<\/code> fourni avec le JDK<\/a> ou peut \u00eatre effectu\u00e9e avec le formulaire suivant..properties<\/code>, cr\u00e9ez une sauvegarde de ce fichier, copiez\/collez le texte \u00e0 convertir dans la zone de texte suivante, cliquez sur le bouton Convertir<\/em> et copiez\/collez le texte converti dans son fichier.properties<\/code>. <\/p>\n\n\n - Utilisez Sweet Home 3D ou la page d’importation de mod\u00e8les 3D<\/a> pour vous aider \u00e0 traduire les fichiers
- Pour \u00e9viter les longues lignes dans l’\u00e9diteur de texte, certaines lignes \n sont divis\u00e9es en deux ou plusieurs lignes et ensuite s\u00e9par\u00e9es par des barres obliques inverses \u00ab\u00a0 \n
- les autres lignes commencent par un texte utilis\u00e9 par Sweet Home 3D comme cl\u00e9 pour trouver un texte affich\u00e9 \u00e0 l’\u00e9cran (affich\u00e9 en bleu dans l’exemple pr\u00e9c\u00e9dent). Apr\u00e8s cette cl\u00e9, chacune de ces lignes contient un signe \u00e9gal (
- les fichiers
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/Frame-327-26-972x1024.png\")
![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/11\/Frame-281.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.sweethome3d.com\/wp-content\/uploads\/2025\/12\/Frame-327-27-972x1024.png\")