Istruzioni di base<\/h2>\n\n
La creazione di un file SH3L consiste in:<\/p>\n\n
- \n
- scaricare una versione inglese dei file<\/a> da tradurre,<\/li>\n\n\n\n
- decomprimere il file scaricato,<\/li>\n\n\n\n
- aggiungere un suffisso di 2 lettere corrispondente alla tua lingua<\/a> ai file
.properties<\/code> che contiene,<\/li>\n\n\n\n- tradurre il testo nei file
.properties<\/code>,<\/li>\n\n\n\n- convertirli in codifica ASCII,<\/li>\n\n\n\n
- tradurre il testo della guida nei file
.html<\/code> (non obbligatorio, ma sar\u00e0 davvero utile per gli utenti),<\/li>\n\n\n\n- zippare nuovamente i file
.properties<\/code> e i file della guida in un file con estensione SH3L,<\/li>\n\n\n\n- fare doppio clic sul file SH3L per testare la traduzione in Sweet Home 3D,<\/li>\n\n\n\n
- distribuire il file SH3L.<\/li>\n<\/ol>\n\n
<\/div>\n\nIstruzioni dettagliate<\/h2>\n\n
Se non hai paura delle istruzioni di base precedenti, vai avanti con i passaggi successivi.<\/p>\n\n
<\/div>\n\nOttenere la versione inglese<\/h3>\n\n
Scarica l’archivio all’indirizzo \/SweetHome3DTranslation.zip<\/a> (versione 7.5) e decomprimilo con gli strumenti del tuo sistema.
.properties<\/code> e.html<\/code> posizionati in sottocartelle come mostrato nella figura 1.<\/p>\n\n<\/div>\n\n![\"\"](\"data:image\/svg+xml;base64,PHN2ZyB3aWR0aD0iMSIgaGVpZ2h0PSIxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==\")
Figura 1. File di traduzione <\/figcaption><\/figure>\n\n <\/div>\n\nTutti i file
.properties<\/code> e.html<\/code> contengono la versione inglese dei testi che dovrai tradurre nella tua lingua:<\/p>\n\n- \n
- i file
package.properties<\/code> descrivono etichette, menu e voci di menu visualizzati nell’interfaccia utente di Sweet Home 3D,<\/li>\n\n\n\n- i file
basic.properties<\/code> emetal.properties<\/code> descrivono le etichette standard delle finestre di dialogo,<\/li>\n\n\n\n- quelli che terminano con
Catalog.properties<\/code> descrivono i nomi dei mobili e delle texture disponibili nel software,<\/li>\n\n\n\n- i file
.html<\/code> contengono il testo della guida di Sweet Home 3D.<\/li>\n<\/ul>\n\n<\/div>\n\n\n<\/figure>\n\n\n\n<\/div>\n\n\n\nI file .properties devono essere posizionati nelle cartelle mostrate nella figura 1, altrimenti Sweet Home 3D non sar\u00e0 in grado di utilizzarli correttamente. Quindi non spostare i file fuori dalla loro cartella, non rinominare nessuna cartella (eccetto la sottodirectory en di help) e non eliminare nessuna cartella.<\/p>\n<\/div>\n\n
<\/div>\n\nRinominare i file a seconda della lingua<\/h3>\n\n
Prima di tradurre i file
.properties<\/code>, dovresti rinominare ciascuno di essi aggiungendo al loro nome un trattino basso seguito dal codice ISO a 2 caratteri corrispondente alla tua lingua. Troverai questo codice nell’ultima colonna del documento https:\/\/www.loc.gov\/standards\/iso639-2\/php\/English_list.php<\/a>.en<\/code> dihelp<\/code> con quel codice a 2 lettere.cs<\/code>. Se vuoi tradurre Sweet Home 3D in ceco, ogni nome di file dovrebbe avere il suffisso_cs<\/code> e dovresti rinominare i file come mostrato nella figura 2. <\/p>\n\n<\/div>\n\nFigura 2. File Properties con il loro suffisso di codice ISO <\/figcaption><\/figure>\n\n <\/div>\n\nTraduzione dei file properties<\/h3>\n\n
I file
.properties<\/code> sono file di testo semplice e puoi modificarli con qualsiasi editor di testo come Wordpad<\/em>, TextEdit<\/em> o emacs<\/em>. Ad esempio, il filecom\/eteks\/sweethome3d\/package.properties<\/code> in Sweet Home 3D 3.0 contiene il seguente testo: <\/p>\n\n# package.properties 10 ott. 2007\n# \n# Copyright (c) 2024 Space Mushrooms <info@sweethome3d.com>. Tutti i diritti riservati.\n# \n# Questo programma \u00e8 software libero; puoi ridistribuirlo e\/o modificarlo secondo\n# i termini della GNU General Public License pubblicata dalla Free Software\n# Foundation; sia la versione 2 della licenza, sia (a tua scelta) qualsiasi versione successiva\n# versione.\n# \n# Questo programma \u00e8 distribuito nella speranza che sia utile, ma SENZA\n# ALCUNA GARANZIA; senza nemmeno la garanzia implicita di COMMERCIABILIT\u00c0 o IDONEIT\u00c0\n# PER UN PARTICOLARE SCOPO. Vedi la GNU General Public License per maggiori\n# dettagli.\n# \n# Avresti dovuto ricevere una copia della GNU General Public License insieme a\n# questo programma; in caso contrario, scrivi a Free Software Foundation, Inc., 59 Temple\n# Place, Suite 330, Boston, MA 02111-1307 USA\n\n# Risorse per la classe HomeFramePane<\/font>\nHomeFramePane.untitled<\/font>=Senza titolo\n\n\n# Risorse per la classe MacOSXConfiguration<\/font>\nMacOSXConfiguration.WINDOW_MENU.Name<\/font>=Finestra\nMacOSXConfiguration.MINIMIZE.Name<\/font>=Riduci a icona\nMacOSXConfiguration.ZOOM.Name<\/font>=Zoom\nMacOSXConfiguration.BRING_ALL_TO_FRONT.Name<\/font>=Porta tutto in primo piano\n\n\n# Risorse per la classe SweetHome3D<\/font>\nSweetHome3D.3DError.message<\/font>=<html><\/font> Sweet Home 3D si chiuder\u00e0 ora a causa di un errore irreversibile<\/font>\n <br><\/font>nel sistema di rendering 3D. Aggiorna i driver DirectX\/OpenGL\n <br><\/font>della tua scheda grafica.<\/font> \nSweetHome3D.3DError.title<\/font>=Errore 3D\n \nSweetHome3D.confirmSaveAfter3DError.message<\/font>=<html><\/font> Sweet Home 3D deve chiudersi ora a causa di un errore irreversibile in<\/font>\n <br><\/font>sistema di rendering 3D. Vuoi salvare tutte le case modificate? \nSweetHome3D.confirmSaveAfter3DError.title<\/font>=Errore 3D\nSweetHome3D.confirmSaveAfter3DError.save<\/font>=Salva\nSweetHome3D.confirmSaveAfter3DError.doNotSave<\/font>=Non salvare<\/pre>\n\n
Un file
.properties<\/code> contiene tre tipi di righe:<\/p>\n\n- \n
- le righe che iniziano con un carattere # sono commenti (mostrati in verde nell’esempio precedente). Alcuni commenti contengono informazioni legali, altri forniscono informazioni a sviluppatori o traduttori. Mantieni queste righe invariate. <\/li>\n\n\n\n
- le righe vuote vengono utilizzate solo per separare le varie parti di un file
.properties<\/code>.<\/li>\n\n\n\n- le altre righe iniziano con del testo utilizzato da Sweet Home 3D come chiave per trovare un testo visualizzato sullo schermo (mostrato in blu nell’esempio precedente). Dopo questa chiave, ciascuna di queste righe contiene un segno di uguale (
=<\/code>) e un testo in una determinata lingua. Il tuo lavoro inizia dai segni di uguale. Non modificare il testo della chiave e sostituisci il testo inglese dopo il segno di uguale con la sua traduzione. <\/li>\n<\/ul>\n\nCasi speciali:<\/p>\n\n
- \n
- I testi che iniziano con un tag
<html><\/code><\/font> \n contengono del testo in formato HTML. Questi testi contengono altri tag \n HTML tra<<\/code><\/font> \n e><\/code><\/font> segni, come \n<br><\/code><\/font> nell’esempio \n precedente che rappresenta un ritorno a capo nel mezzo di testi lunghi. \n Non rimuovere questi tag HTML, aiutano Sweet Home 3D a presentare correttamente \n alcuni testi. Tradurre il testo tra tag HTML non \u00e8 molto difficile, \n tranne forse per il testo HTML peggiore che \u00e8 il valore della chiaveWallPanel.wallOrientationLabel.text<\/code> \n. <\/li>\n\n\n\n- Per evitare righe lunghe nell’editor di testo, alcune righe \n sono divise in due o pi\u00f9 righe e quindi separate da barre rovesciate \n
\\<\/code><\/font>, come la riga che inizia \n conSweetHome3D.3DError.message<\/code><\/font> \n nell’esempio precedente. In tal caso, non rimuovere il segno\\<\/code><\/font> \n situato alla fine di una riga perch\u00e9 indica che la riga successiva \n segue la riga corrente.<\/li>\n\n\n\n- Alcuni testi contengono sequenze di caratteri speciali che iniziano \n con un segno
<\/code>% , come%s<\/code>,%d<\/code>, \n%1$s<\/code>,%2$s<\/code>… Queste sequenze di caratteri \n verranno sostituite da un nome file, un’unit\u00e0 o un numero quando necessario, quindi \n non rimuoverle.%s<\/code><\/font> \n nel testo della seguente chiaveHomeFurniturePanel.widthLabel.text<\/code><\/font>:HomeFurniturePanel.widthLabel.text<\/font>=Larghezza (%s<\/font>):<\/pre>\n verr\u00e0 sostituito dall’unit\u00e0 attualmente in uso. Le due sequenze di caratteri \n
%1$d<\/code><\/font> e%2$d<\/code><\/font> \n che appaiono nel testo della seguente chiavePrintPreviewPanel.pageLabel.text<\/code><\/font>:PrintPreviewPanel.pageLabel.text<\/font>=Pagina %1$d<\/font>\/%2$d<\/font><\/pre>\n appariranno sullo schermo come un numero di pagina e il conteggio delle pagine, e dovresti tradurre solo la parola
Page<\/code>.<\/li>\n\n\n\n- Alcuni testi contengono anche la sequenza di caratteri speciali
\\n<\/code><\/font>, come nel seguente esempio:HomeController.saveError<\/font>=Impossibile salvare la casa in\\n<\/font>\"%s<\/font>\"<\/pre> Questa sequenza di caratteri viene visualizzata da Sweet Home 3D come un ritorno a capo per dividere una riga sullo schermo e non dovresti rimuoverla.
- Il valore della chiave
HelpController.helpIndex<\/code> indica la directory in cui \u00e8 possibile trovare i file della guida. Se traduci i file della guida .html<\/code>, dovresti sostituire la sottodirectoryen<\/code> trovata con il codice a 2 lettere della tua lingua.HelpController.helpIndex<\/font>=\/com\/eteks\/sweethome3d\/viewcontroller\/resources\/help\/cs<\/font>\/index.html<\/pre><\/li>\n<\/ul>\n\n
- \n
- Il testo delle chiavi che terminano con
.mnemonic<\/code> viene utilizzato da Sweet Home 3D per indovinare quale lettera in un’etichetta o in una voce di menu deve essere sottolineata per l’accesso da tastiera. Questa lettera mnemonica dipende dalla parola visualizzata e dovresti trovarne una univoca per ogni finestra di dialogo o menu.HomeFurniturePanel.nameLabel.text<\/font>=Nome:\nHomeFurniturePanel.nameLabel.mnemonic<\/font>=N<\/b>\nHomeFurniturePanel.nameVisibleCheckBox.text<\/font>=Visualizza nome nel piano\nHomeFurniturePanel.nameVisibleCheckBox.mnemonic<\/font>=S<\/b>\nHomeFurniturePanel.widthLabel.text<\/font>=Larghezza (%s):\nHomeFurniturePanel.widthLabel.mnemonic<\/font>=W<\/b><\/pre>\npu\u00f2 essere tradotto in francese da:
HomeFurniturePanel.nameLabel.text<\/font>=Nom :\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) :\nHomeFurniturePanel.widthLabel.mnemonic<\/font>=L<\/b><\/pre> \n<\/li>\n\n\n\n
- Usa Sweet Home 3D o la pagina di importazione dei modelli 3D<\/a> per aiutarti a tradurre i file
.properties<\/code> che terminano conCatalog.properties<\/code>.<\/li>\n<\/ul>\n\n<\/div>\n\nConversione dei file properties in codifica ASCII<\/h3>\n\n
<\/a>Se hai tradotto testi in una lingua con lettere non appartenenti alla codifica ISO-8859-1<\/a> (principalmente lingue dell’Europa centrale e orientale e lingue con un alfabeto non latino), dovrai convertire tutti i tuoi file
.properties<\/code> in una codifica ASCII supportata da Sweet Home 3D. Questa conversione pu\u00f2 essere eseguita con lo strumentonative2ascii<\/code> fornito con il JDK<\/a> o pu\u00f2 essere eseguita con il seguente modulo..properties<\/code>, crea un backup di quel file, copia\/incolla il testo da convertire nella seguente area di testo, fai clic sul pulsante Converti<\/em> e copia\/incolla il testo convertito nel suo file.properties<\/code>. <\/p>\n\n\n - Usa Sweet Home 3D o la pagina di importazione dei modelli 3D<\/a> per aiutarti a tradurre i file
- Per evitare righe lunghe nell’editor di testo, alcune righe \n sono divise in due o pi\u00f9 righe e quindi separate da barre rovesciate \n
- le altre righe iniziano con del testo utilizzato da Sweet Home 3D come chiave per trovare un testo visualizzato sullo schermo (mostrato in blu nell’esempio precedente). Dopo questa chiave, ciascuna di queste righe contiene un segno di uguale (
- i file
![\"\"](\"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\")