Instru\u00e7\u00f5es b\u00e1sicas<\/h2>\n\n
Criar um arquivo SH3L consiste em:<\/p>\n\n
- \n
- baixar uma vers\u00e3o em ingl\u00eas dos arquivos<\/a> para traduzir,<\/li>\n\n\n\n
- descompactar o arquivo baixado,<\/li>\n\n\n\n
- adicionar um sufixo de 2 letras correspondente ao seu idioma<\/a> aos arquivos
.properties<\/code> que ele cont\u00e9m,<\/li>\n\n\n\n- traduzir o texto nos arquivos
.properties<\/code>,<\/li>\n\n\n\n- convert\u00ea-los para a codifica\u00e7\u00e3o ASCII,<\/li>\n\n\n\n
- traduzir o texto de ajuda nos arquivos
.html<\/code> (n\u00e3o obrigat\u00f3rio, mas ser\u00e1 muito \u00fatil para os usu\u00e1rios),<\/li>\n\n\n\n- compactar os arquivos
.properties<\/code> e os arquivos de ajuda de volta em um arquivo com uma extens\u00e3o SH3L,<\/li>\n\n\n\n- clicar duas vezes no arquivo SH3L para testar sua tradu\u00e7\u00e3o no Sweet Home 3D,<\/li>\n\n\n\n
- distribuir seu arquivo SH3L.<\/li>\n<\/ol>\n\n
<\/div>\n\nInstru\u00e7\u00f5es detalhadas<\/h2>\n\n
Se voc\u00ea n\u00e3o tem receio das instru\u00e7\u00f5es b\u00e1sicas anteriores, siga em frente com as pr\u00f3ximas etapas.<\/p>\n\n
<\/div>\n\nObtendo a vers\u00e3o em ingl\u00eas<\/h3>\n\n
Baixe o arquivo em \/SweetHome3DTranslation.zip<\/a> (vers\u00e3o 7.5) e descompacte-o com as ferramentas do seu sistema.
.properties<\/code> e.html<\/code> colocados em subpastas, conforme mostrado na figura 1.<\/p>\n\n<\/div>\n\n![\"\"](\"data:image\/svg+xml;base64,PHN2ZyB3aWR0aD0iMSIgaGVpZ2h0PSIxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==\")
Figura 1. Arquivos de tradu\u00e7\u00e3o <\/figcaption><\/figure>\n\n <\/div>\n\nTodos os arquivos
.properties<\/code> e.html<\/code> cont\u00eam a vers\u00e3o em ingl\u00eas dos textos que voc\u00ea ter\u00e1 que traduzir para o seu idioma:<\/p>\n\n- \n
- os arquivos
package.properties<\/code> descrevem r\u00f3tulos, menus e itens de menu mostrados na interface do usu\u00e1rio do Sweet Home 3D,<\/li>\n\n\n\n- os arquivos
basic.properties<\/code> emetal.properties<\/code> descrevem os r\u00f3tulos de di\u00e1logo padr\u00e3o,<\/li>\n\n\n\n- aqueles que terminam com
Catalog.properties<\/code> descrevem os nomes dos m\u00f3veis e as texturas dispon\u00edveis no software,<\/li>\n\n\n\n- os arquivos
.html<\/code> cont\u00eam o texto da ajuda do Sweet Home 3D.<\/li>\n<\/ul>\n\n<\/div>\n\n\n<\/figure>\n\n\n\n<\/div>\n\n\n\nOs arquivos .properties devem ser colocados nas pastas mostradas na figura 1. caso contr\u00e1rio, o Sweet Home 3D n\u00e3o poder\u00e1 us\u00e1-los corretamente. Portanto, n\u00e3o mova os arquivos para fora de sua pasta, n\u00e3o renomeie nenhuma pasta (exceto o subdiret\u00f3rio en de help) e n\u00e3o exclua nenhuma pasta.<\/p>\n<\/div>\n\n
<\/div>\n\nRenomeando arquivos dependendo do seu idioma<\/h3>\n\n
Antes de traduzir os arquivos
.properties<\/code>, voc\u00ea deve renomear cada um deles adicionando ao seu nome um sublinhado seguido pelo c\u00f3digo ISO de 2 caracteres correspondente ao seu idioma. Voc\u00ea encontrar\u00e1 este c\u00f3digo na \u00faltima coluna do documento https:\/\/www.loc.gov\/standards\/iso639-2\/php\/English_list.php<\/a>.en<\/code> dehelp<\/code> com esse c\u00f3digo de 2 letras tamb\u00e9m.cs<\/code>. Se voc\u00ea quiser traduzir o Sweet Home 3D para tcheco, cada nome de arquivo deve ser sufixado por_cs<\/code>, e voc\u00ea deve renomear os arquivos como mostrado na figura 2. <\/p>\n\n<\/div>\n\nFigura 2. Arquivos de propriedades com seu sufixo de c\u00f3digo ISO <\/figcaption><\/figure>\n\n <\/div>\n\nTraduzindo arquivos de propriedades<\/h3>\n\n
Os arquivos
.properties<\/code> s\u00e3o arquivos de texto simples e voc\u00ea pode edit\u00e1-los com qualquer editor de texto como Wordpad<\/em>, TextEdit<\/em> ou emacs<\/em>. Por exemplo, o arquivocom\/eteks\/sweethome3d\/package.properties<\/code> no Sweet Home 3D 3.0 cont\u00e9m o seguinte texto: <\/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. Veja a Licen\u00e7a P\u00fablica Geral GNU para mais\n# detalhes.\n# \n# Voc\u00ea deveria ter recebido uma c\u00f3pia da Licen\u00e7a P\u00fablica Geral GNU junto com\n# este programa; se n\u00e3o, escreva para a Free Software Foundation, Inc., 59 Temple\n# Place, Suite 330, Boston, MA 02111-1307 USA\n\n# Recursos para a classe HomeFramePane<\/font>\nHomeFramePane.untitled<\/font>=Sem t\u00edtulo\n\n\n# Recursos para a classe MacOSXConfiguration<\/font>\nMacOSXConfiguration.WINDOW_MENU.Name<\/font>=Janela\nMacOSXConfiguration.MINIMIZE.Name<\/font>=Minimizar\nMacOSXConfiguration.ZOOM.Name<\/font>=Zoom\nMacOSXConfiguration.BRING_ALL_TO_FRONT.Name<\/font>=Trazer tudo para a frente\n\n\n# Recursos para a classe SweetHome3D<\/font>\nSweetHome3D.3DError.message<\/font>=<html><\/font> O Sweet Home 3D ser\u00e1 encerrado agora devido a um erro fatal<\/font>\n <br><\/font>no sistema de renderiza\u00e7\u00e3o 3D. Por favor, atualize os drivers DirectX\/OpenGL\n <br><\/font>da sua placa de v\u00eddeo.<\/font> \nSweetHome3D.3DError.title<\/font>=Erro 3D\n \nSweetHome3D.confirmSaveAfter3DError.message<\/font>=<html><\/font> O Sweet Home 3D deve ser encerrado agora devido a um erro fatal em<\/font>\n <br><\/font>sistema de renderiza\u00e7\u00e3o 3D. Voc\u00ea quer salvar todas as casas modificadas? \nSweetHome3D.confirmSaveAfter3DError.title<\/font>=Erro 3D\nSweetHome3D.confirmSaveAfter3DError.save<\/font>=Salvar\nSweetHome3D.confirmSaveAfter3DError.doNotSave<\/font>=N\u00e3o salvar<\/pre>\n\n
Um arquivo
.properties<\/code> cont\u00e9m tr\u00eas tipos de linhas:<\/p>\n\n- \n
- as linhas que come\u00e7am com um caractere # s\u00e3o coment\u00e1rios (mostrados em verde no exemplo anterior). Alguns coment\u00e1rios cont\u00eam informa\u00e7\u00f5es legais, alguns d\u00e3o informa\u00e7\u00f5es para desenvolvedores ou para tradutores. Mantenha estas linhas inalteradas. <\/li>\n\n\n\n
- linhas vazias s\u00e3o usadas apenas para separar as v\u00e1rias partes de um arquivo
.properties<\/code>.<\/li>\n\n\n\n- as outras linhas come\u00e7am com algum texto usado pelo Sweet Home 3D como uma chave para encontrar um texto exibido na tela (mostrado em azul no exemplo anterior). Seguindo esta chave, cada uma destas linhas cont\u00e9m um sinal de igual (
=<\/code>) e um texto em um determinado idioma. Seu trabalho come\u00e7a a partir dos sinais de igual. N\u00e3o altere o texto da chave e substitua o texto em ingl\u00eas ap\u00f3s o sinal de igual pela sua tradu\u00e7\u00e3o. <\/li>\n<\/ul>\n\nCasos especiais:<\/p>\n\n
- \n
- Os textos que come\u00e7am com uma
<html><\/code><\/font> \n tag cont\u00eam algum texto em formato HTML. Estes textos cont\u00eam algumas outras tags \n HTML entre<<\/code><\/font> \n e><\/code><\/font> sinais, como \n<br><\/code><\/font> no exemplo \n anterior, que representa um retorno de carro no meio de textos longos. \n N\u00e3o remova estas tags HTML, elas ajudam o Sweet Home 3D a apresentar corretamente \n alguns textos. Traduzir texto entre tags HTML n\u00e3o \u00e9 muito dif\u00edcil, \n exceto talvez para o pior texto HTML que \u00e9 o valor da chaveWallPanel.wallOrientationLabel.text<\/code> \n. <\/li>\n\n\n\n- Para evitar linhas longas no editor de texto, algumas linhas \n s\u00e3o divididas em duas ou mais linhas e, em seguida, separadas por barras invertidas \n
\\<\/code><\/font>, como a linha que come\u00e7a \n porSweetHome3D.3DError.message<\/code><\/font> \n no exemplo anterior. Nesse caso, n\u00e3o remova o\\<\/code><\/font> \n sinal localizado no final de uma linha porque indica que a pr\u00f3xima linha \n segue a linha atual.<\/li>\n\n\n\n- Alguns textos cont\u00eam uma sequ\u00eancia de caracteres especiais come\u00e7ando \n com um sinal
<\/code>% , como%s<\/code>,%d<\/code>, \n%1$s<\/code>,%2$s<\/code>… Estas sequ\u00eancias de caracteres \n ser\u00e3o substitu\u00eddas por um nome de arquivo, uma unidade ou um n\u00famero quando necess\u00e1rio, ent\u00e3o \n n\u00e3o as remova.%s<\/code><\/font> \n no texto da seguinte chaveHomeFurniturePanel.widthLabel.text<\/code><\/font>:HomeFurniturePanel.widthLabel.text<\/font>=Largura (%s<\/font>):<\/pre>\n ser\u00e1 substitu\u00eddo pela unidade atualmente em uso. As duas sequ\u00eancias de caracteres \n
%1$d<\/code><\/font> e%2$d<\/code><\/font> \n que aparecem no texto da seguinte chavePrintPreviewPanel.pageLabel.text<\/code><\/font>:PrintPreviewPanel.pageLabel.text<\/font>=P\u00e1gina %1$d<\/font>\/%2$d<\/font><\/pre>\n aparecer\u00e1 na tela como um n\u00famero de p\u00e1gina e a contagem de p\u00e1ginas, e voc\u00ea \n deve traduzir apenas a palavra
Page<\/code>.<\/li>\n\n\n\n- Alguns textos tamb\u00e9m cont\u00eam a sequ\u00eancia de caracteres especiais
\\n<\/code><\/font>, como no exemplo a seguir:HomeController.saveError<\/font>=N\u00e3o \u00e9 poss\u00edvel salvar a casa em\n<\/font>\"%s<\/font>\"<\/pre> Esta sequ\u00eancia de caracteres \u00e9 exibida pelo Sweet Home 3D como um retorno de carro para dividir uma linha na tela, e voc\u00ea n\u00e3o deve remov\u00ea-los.
- O valor da chave
HelpController.helpIndex<\/code> indica o diret\u00f3rio onde os arquivos de ajuda podem ser encontrados. Se voc\u00ea traduzir os arquivos de ajuda .html<\/code>, voc\u00ea deve substituir o subdiret\u00f3rioen<\/code> encontrado pelo c\u00f3digo de 2 letras do seu idioma.HelpController.helpIndex<\/font>=\/com\/eteks\/sweethome3d\/viewcontroller\/resources\/help\/cs<\/font>\/index.html<\/pre><\/li>\n<\/ul>\n\n
- \n
- O texto das chaves que terminam com
.mnemonic<\/code> s\u00e3o usados pelo Sweet Home 3D para adivinhar qual letra em um r\u00f3tulo ou um item de menu deve ser sublinhada para acesso pelo teclado. Esta letra mnem\u00f4nica depende da palavra exibida e voc\u00ea deve encontrar uma \u00fanica por caixa de di\u00e1logo ou menu.HomeFurniturePanel.nameLabel.text<\/font>=Nome:\nHomeFurniturePanel.nameLabel.mnemonic<\/font>=N<\/b>\nHomeFurniturePanel.nameVisibleCheckBox.text<\/font>=Exibir nome no plano\nHomeFurniturePanel.nameVisibleCheckBox.mnemonic<\/font>=S<\/b>\nHomeFurniturePanel.widthLabel.text<\/font>=Largura (%s):\nHomeFurniturePanel.widthLabel.mnemonic<\/font>=W<\/b><\/pre>\npode ser traduzido em franc\u00eas por:
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
- Use o Sweet Home 3D ou a p\u00e1gina de importa\u00e7\u00e3o de modelos 3D<\/a> para ajud\u00e1-lo a traduzir os arquivos
.properties<\/code> que terminam comCatalog.properties<\/code>.<\/li>\n<\/ul>\n\n<\/div>\n\nConvertendo arquivos de propriedades para codifica\u00e7\u00e3o ASCII<\/h3>\n\n
<\/a>Se voc\u00ea traduziu textos para um idioma com letras que n\u00e3o pertencem \u00e0 codifica\u00e7\u00e3o ISO-8859-1<\/a> (principalmente idiomas da Europa Central e Oriental e idiomas com um alfabeto n\u00e3o latino), voc\u00ea ter\u00e1 que converter todos os seus arquivos
.properties<\/code> para uma codifica\u00e7\u00e3o ASCII suportada pelo Sweet Home 3D. Esta convers\u00e3o pode ser feita com a ferramentanative2ascii<\/code> fornecida com o JDK<\/a> ou pode ser realizada com o seguinte formul\u00e1rio..properties<\/code>, crie um backup desse arquivo, copie\/cole o texto para converter na seguinte \u00e1rea de texto, clique no bot\u00e3o Converter<\/em> e copie\/cole o texto convertido de volta em seu arquivo.properties<\/code>. <\/p>\n\n\n - Use o Sweet Home 3D ou a p\u00e1gina de importa\u00e7\u00e3o de modelos 3D<\/a> para ajud\u00e1-lo a traduzir os arquivos
- Para evitar linhas longas no editor de texto, algumas linhas \n s\u00e3o divididas em duas ou mais linhas e, em seguida, separadas por barras invertidas \n
- as outras linhas come\u00e7am com algum texto usado pelo Sweet Home 3D como uma chave para encontrar um texto exibido na tela (mostrado em azul no exemplo anterior). Seguindo esta chave, cada uma destas linhas cont\u00e9m um sinal de igual (
- os arquivos
![\"\"](\"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\")