Para explicar resumidamente como traduzir para scripts Javascript (Gutenberg): WordPress requer Ent\u00e3o o que precisamos fazer \u00e9 primeiro adicionar as fun\u00e7\u00f5es gettext ( Lembre-se de que os arquivos \/ – do seu tema ou plug-in O primeiro passo \u00e9 agrupar todos os textos em nosso arquivo Javascript dentro das fun\u00e7\u00f5es de tradu\u00e7\u00e3o. Se voc\u00ea j\u00e1 lidou com a tradu\u00e7\u00e3o para WordPress em PHP, provavelmente est\u00e1 muito familiarizado com as fun\u00e7\u00f5es Assim como no PHP, voc\u00ea precisa fornecer um dom\u00ednio de dom\u00ednio de texto (nome\/identificador). Pode ser o que voc\u00ea quiser, mas mantenha-o curto, pois voc\u00ea provavelmente precisar\u00e1 digit\u00e1-lo com muita frequ\u00eancia. Para o meu tema, configurei meu textdomain com o dom\u00ednio Vamos come\u00e7ar a editar nosso arquivo Javascript. Primeiro precisamos desestruturar a fun\u00e7\u00e3o E ent\u00e3o \u00e9 uma quest\u00e3o de encontrar todos os nossos textos codificados no arquivo Javascript e atualiz\u00e1-los. Tenha em mente que as fun\u00e7\u00f5es Por exemplo, nosso E quanto aos adere\u00e7os, ou seja, em Enrole todos os textos para os quais voc\u00ea deseja apoiar a tradu\u00e7\u00e3o em Esta etapa varia um pouco dependendo do que voc\u00ea j\u00e1 fez e configurou para o seu tema ou plugin. Voc\u00ea pode estar escrevendo seus scripts Gutenberg em um plugin novo e vazio que n\u00e3o foi configurado para tradu\u00e7\u00e3o PHP, ou dentro de um tema que j\u00e1 tenha um dom\u00ednio de texto registrado. Voc\u00ea pode ter arquivos PO (e MO) prontos ou pode ter apenas um arquivo POT. Vou tentar o meu melhor para cobrir todas as bases.<\/p>\n Se voc\u00ea j\u00e1 tem um arquivo PO ou POT em seu projeto, provavelmente tamb\u00e9m tem a fun\u00e7\u00e3o PHP Tudo o que voc\u00ea precisa fazer \u00e9 carregar o arquivo PO para o idioma que deseja traduzir (ou gerar um a partir do arquivo POT) em, por exemplo , PoEdit<\/a>. Clique em "Atualizar do c\u00f3digo" (ou similar em outros programas) para que o programa possa verificar todos os arquivos do projeto (incluindo nossos arquivos Javascript atualizados recentemente) e atualizar o conjunto de strings para tradu\u00e7\u00e3o. As strings em nosso arquivo Javascript devem aparecer. Em seguida, voc\u00ea s\u00f3 precisa traduzi-los normalmente e salvar.<\/p>\n PS: Se voc\u00ea n\u00e3o conseguir clicar em “Atualizar do c\u00f3digo" ou redigitalizar os arquivos, o arquivo PO provavelmente n\u00e3o foi configurado corretamente. Procure dicas na pr\u00f3xima se\u00e7\u00e3o.<\/p>\n Se o seu tema ou projeto n\u00e3o foi configurado com tradu\u00e7\u00e3o, voc\u00ea precisa gerar um arquivo POT usando WP-CLI ou criar manualmente um arquivo PO.<\/p>\n Eu tenho um guia completo sobre como criar um arquivo PO no meu Tutorial de Tema para Iniciantes \u2013 parte 8<\/a>. A postagem descreve como voc\u00ea pode criar o arquivo e configur\u00e1-lo corretamente para pesquisar seus arquivos de tema e as palavras-chave para pesquisar ( Se voc\u00ea preferir criar um arquivo POT, voc\u00ea pode usar o comando wp i18n make-pot<\/a> no WP-CLI e, em seguida, criar um arquivo PO usando, por exemplo, PoEdit. Lembre-se de que voc\u00ea precisar\u00e1 gerar novamente o arquivo POT (e, em seguida, o arquivo PO) toda vez que atualizar qualquer string em seu c\u00f3digo.<\/p>\n O que voc\u00ea precisa \u00e9 de um arquivo PO que encontrou suas strings Javascript onde elas foram traduzidas. Eu recomendo colocar seus arquivos de tradu\u00e7\u00e3o em uma pasta separada em seu tema ou plugin. Quando come\u00e7armos a gerar arquivos JSON, teremos alguns arquivos para tradu\u00e7\u00e3o e ser\u00e1 bom mant\u00ea-los todos juntos em sua pr\u00f3pria pasta.<\/p>\n Como ponto de refer\u00eancia, estou colocando todos os arquivos de tradu\u00e7\u00e3o no meu arquivo O pr\u00f3ximo passo \u00e9 usar o WP-CLI para gerar arquivos JSON do nosso arquivo po. Para isso usamos o comando wp i18n make-json<\/a>.<\/p>\n Esteja ciente de que, por padr\u00e3o, este comando retirar\u00e1 as strings traduzidas do seu arquivo PO para uso na gera\u00e7\u00e3o do arquivo JSON. Isso pode ser complicado no meio do desenvolvimento do seu tema ou plugin. Porque quando voc\u00ea adiciona novas strings ou ajusta strings, voc\u00ea ter\u00e1 que redigitalizar os arquivos e traduzir todas as strings novamente (e novamente e novamente). Felizmente, h\u00e1 um sinalizador no comando para evitar isso.<\/p>\n Vamos come\u00e7ar! No seu terminal, navegue at\u00e9 o diret\u00f3rio de idioma do seu projeto. Execute o seguinte comando e consulte o seu arquivo po (como mencionado, eu tenho um Se voc\u00ea n\u00e3o tiver nenhum problema em remover as strings traduzidas do seu arquivo PO (por exemplo, se estiver fazendo sua compila\u00e7\u00e3o final), pule o O terminal deve solicitar “Sucesso” e indicar quantos arquivos JSON foram criados. Se voc\u00ea vir que ele gerou dois arquivos JSON, \u00e9 porque ele leu nosso arquivo Javascript de c\u00f3digo-fonte e o arquivo de compila\u00e7\u00e3o e gerou um para cada um. Se voc\u00ea tiver mais arquivos Javascript em seu projeto, ter\u00e1 ainda mais arquivos JSON.<\/p>\n No momento em que escrevo isso (WordPress v 5.3.2 e WP-CLI vers\u00e3o 2.4.0), os arquivos JSON s\u00e3o gerados com o c\u00f3digo do idioma e um hash \u2013 uma string enigm\u00e1tica como nomes de arquivos. Precisamos encontrar o caminho certo e renome\u00e1-lo.<\/p>\n.mo<\/code>arquivos para tradu\u00e7\u00e3o de arquivos PHP, mas para Javascript o WordPress requer um .json<\/code>arquivo. Cada arquivo Javascript precisa de um arquivo JSON para tradu\u00e7\u00e3o. O JSON deve ter um formato espec\u00edfico (o WP CLI o gerar\u00e1 para n\u00f3s) com nossas strings traduzidas. Precisamos de um arquivo JSON por idioma para o qual desejamos traduzir.<\/p>\n__()<\/code>, _e()<\/code>etc.) em nossos arquivos Javascript e gerar um arquivo PO como de costume para nosso tema ou plugin. Como envolvemos os textos em nossos arquivos de script com, por exemplo __()<\/code>,, o arquivo PO deve ser capaz de inclu\u00ed-los. Em seguida, fazemos a tradu\u00e7\u00e3o como de costume em nosso arquivo PO. E, finalmente, usamos WP CLI para extrair as strings necess\u00e1rias do arquivo PO e gerar arquivos JSON para todos os nossos arquivos Javascript.<\/p>\n.po<\/code>nunca .mo<\/code>ter\u00e3o efeito em seus arquivos Javascript – mesmo que contenham strings traduzidas de nossos arquivos Javascript.<\/p>\nImplementando a tradu\u00e7\u00e3o em Javascript<\/h2>\n
__()<\/code>, _e()<\/code>, esc_html__()<\/code>e assim por diante. O WordPress possui um pacote wp.i18n<\/code>que cont\u00e9m essas fun\u00e7\u00f5es, que funcionam exatamente como no PHP.<\/p>\nawhitepixel<\/code>. Ent\u00e3o dentro do PHP eu vou fazer __('My string', 'awhitepixel')<\/code>para traduzir strings, e vai ser exatamente igual nos arquivos Javascript.<\/p>\n__<\/code>and _e<\/code>do wp.i18n<\/code>pacote. Por causa da natureza do React, provavelmente voc\u00ea usar\u00e1 principalmente ou talvez apenas a __<\/code>fun\u00e7\u00e3o.<\/p>\nconst { __, _e } = wp.i18n;<\/code><\/pre>\n__<\/code>e _e<\/code>requerem contexto Javascript. Isso significa que quando digitamos strings como, por exemplo, valores de propriedades de objetos, usamos __()<\/code>imediatamente, mas como valores para, por exemplo, props, precisamos envolver tudo dentro { }<\/code>para significar que este \u00e9 um c\u00f3digo Javascript.<\/p>\nregisterBlockType<\/code>com suporte para tradu\u00e7\u00e3o ficar\u00e1 assim:<\/p>\nregisterBlockType('awp\/firstblock', {\n title: __('My first block', 'awhitepixel'), \n category: 'common',\n icon: 'smiley',\n description: __('Learning in progress', 'awhitepixel'),\n keywords: [__('example', 'awhitepixel'), __('test', 'awhitepixel')],\n attributes: {\n ...<\/code><\/pre>\nInspectorControls<\/code>:<\/p>\n<InspectorControls>\n <PanelBody\n title={__(\"Most awesome settings ever\", 'awhitepixel')}\n initialOpen={true}\n >\n ...\n <ToggleControl\n label={__(\"Toggle me\", 'awhitepixel')}\n checked={attributes.toggle}\n onChange={(newval) => setAttributes({ toggle: newval })}\n \/>\n ...<\/code><\/pre>\n__()<\/code>e _e()<\/code>. Se voc\u00ea seguiu este tutorial passo a passo, n\u00e3o deve ter nenhum caso em que precise usar _e()<\/code>. Quando terminar, recompile o Javascript e nos afastaremos do Javascript.<\/p>\nConfigurando arquivos po e\/ou pot<\/h2>\n
Meu tema ou plugin j\u00e1 tem um arquivo po(t)<\/h3>\n
load_theme_textdomain()<\/code>, load_child_theme_textdomain()<\/code>ou load_plugin_textdomain()<\/code>em algum lugar em seu c\u00f3digo. Certifique-se de que o dom\u00ednio registrado \u00e9 o mesmo que voc\u00ea usou em seus arquivos Javascript.<\/p>\nN\u00e3o tenho nenhum arquivo de tradu\u00e7\u00e3o<\/h3>\n
__<\/code>, _e<\/code>, etc.).<\/p>\nResultado final<\/h3>\n
theme\/assets\/lang\/<\/code>. Adicionei uma tradu\u00e7\u00e3o norueguesa para o meu tema, chamada nb_NO.po<\/code>, que cont\u00e9m as strings traduzidas do nosso arquivo Javascript de bloco personalizado.<\/p>\nGerando arquivos JSON a partir do arquivo po<\/h2>\n
nb_NO.po<\/code>arquivo pronto).<\/p>\nwp i18n make-json nb_NO.po --no-purge<\/code><\/pre>\n--no-purge<\/code>sinalizador.<\/p>\nRenomeando o arquivo JSON e carregando-o em PHP<\/h2>\n
![\"Criar](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153240-61e50a824a365.png\")
<\/a><\/p>\n![\"Criar](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-153240-61e50a83bedae.png\")
<\/a><\/p>\n