Objetivo: Este POP descreve os passos necessários para traduzir automaticamente um arquivo POT do WordPress em vários idiomas usando o Potrans e a API do Google Translate.
Materiais necessários:
- Servidor PHP (local ou remoto)
- Chave API do Google Translate
- Credenciais do Google Cloud
- ID do projeto do Google Cloud
- Potrans instalado
Procedimento:
- Certifique-se de que o PHP esteja instalado e funcionando corretamente em seu servidor.
- Obtenha uma chave API do Google Translate seguindo as instruções fornecidas anteriormente.
- Obtenha suas credenciais do Google Cloud e o ID do projeto do Google Cloud.
- Instale o Potrans em seu servidor seguindo as instruções fornecidas anteriormente.
- Use o comando
google
do Potrans para traduzir automaticamente um arquivo POT para o idioma desejado. Por exemplo, para traduzir um arquivo POT do inglês para o português do Brasil, use o seguinte comando:
php bin/potrans google --from en --to pt-br --credentials caminho/para/credenciais.json --project ID_DO_PROJETO caminho/para/arquivo/original.pot caminho/para/arquivo/traduzido.po
Lembre-se de substituir caminho/para/credenciais.json
pelo caminho para o arquivo de credenciais do Google Cloud, ID_DO_PROJETO
pelo ID do projeto do Google Cloud, caminho/para/arquivo/original.pot
pelo caminho para o arquivo POT original e caminho/para/arquivo/traduzido.po
pelo caminho para o arquivo PO traduzido.
- Verifique se a tradução foi bem-sucedida abrindo o arquivo PO traduzido e verificando se as strings de texto foram traduzidas corretamente.
Espero que este POP seja útil para você traduzir automaticamente arquivos POT do WordPress usando o Potrans e a API do Google Translate.
Como começar com o Potrans
Para começar a usar o Potrans para traduzir automaticamente arquivos POT do WordPress, você precisará seguir os seguintes passos :
- Obtenha uma chave API do Google Translate.
- Certifique-se de que o PHP esteja instalado em seu servidor Linux.
- Use o GIT para clonar o projeto Potrans:
git clone https://github.com/OzzyCzech/potrans.git
- Navegue até o diretório do Potrans:
cd potrans
- Instale as dependências do Potrans usando o Composer:
composer install
- Para traduzir um arquivo POT, use o seguinte comando:
php bin/potrans -k SUA_CHAVE_API -i /caminho/para/arquivo/original.pot -o /caminho/para/arquivo/traduzido.po -f idioma_original -t idioma_alvo
Lembre-se de substituir SUA_CHAVE_API
pela sua chave API do Google Translate e ajustar os caminhos e nomes de arquivo e os códigos de idioma conforme necessário.
Espero que essas informações sejam úteis para você começar a usar o Potrans para traduzir automaticamente arquivos POT do WordPress.
Como obtermos uma chave API do Google Translate
Para obter uma chave API do Google Translate, você precisará seguir os seguintes passos:
- Acesse o Google Cloud Console.
- Clique no menu de projetos no canto superior direito e selecione ou crie um novo projeto.
- No menu de navegação à esquerda, clique em APIs e serviços e, em seguida, em Painel.
- Clique em Ativar APIs e serviços e pesquise por “Cloud Translation API”.
- Clique na API e, em seguida, em Ativar.
- Clique em Criar credenciais e selecione Chave de API.
Sua nova chave de API será exibida na tela. Certifique-se de restringir o uso da chave de API a somente os endereços IP, aplicativos ou sites que precisam acessá-la.
O uso da API do Google Translate é cobrado com base no volume de uso. Você pode encontrar mais informações sobre os preços na página de preços do Cloud Translation.
Espero que essas informações sejam úteis para você obter uma chave API do Google Translate.
Obtendo credenciais JSON de tradução do Google
- Abra o site do Console do Google Cloud
- Crie um novo projeto (ou selecione um existente)
- Pesquise a API de tradução e ative-a
- Acesse IAM e administrador > Contas de serviço e clique em + Criar conta de serviço
- Escolha o nome da conta de serviço e o ID da conta de serviço e clique para criar e continuar
- Conceda a esta conta de serviço acesso ao projeto e adicione os seguintes papéis Cloud Translation API Editor , AutoML Editor
- Crie novas chaves e baixe o arquivo JSON de credenciais
Como utilizar o Potrans em ambiente local no Windows utilizando o xampp
Sim, é possível usar o Potrans em um ambiente local no Windows com o XAMPP. O XAMPP é uma distribuição do Apache que inclui o PHP, portanto, você pode usar o Potrans com ele. No entanto, você precisará instalar manualmente algumas dependências adicionais, como o GIT e o Composer.
Para instalar o GIT no Windows, você pode baixar o instalador do site oficial do GIT e seguir as instruções de instalação.
Para instalar o Composer no Windows, você pode baixar o instalador do site oficial do Composer e seguir as instruções de instalação.
Depois de instalar o GIT e o Composer, você pode seguir as instruções que forneci anteriormente para clonar e instalar o Potrans e usá-lo para traduzir automaticamente arquivos POT do WordPress.
Espero que essas informações sejam úteis para você usar o Potrans em um ambiente local no Windows com o XAMPP.
Como poderemos executar nosso script na linha de comando
De acordo com a sintaxe de linha de comando que você forneceu para o comando google
do Potrans, você pode especificar o idioma de origem e destino usando as opções --from
e --to
, respectivamente. Por exemplo, para traduzir um arquivo POT do inglês para o português do Brasil, você pode usar o seguinte comando:
php bin/potrans google --from en --to pt-br caminho/para/arquivo/original.pot caminho/para/arquivo/traduzido.po
Lembre-se de substituir caminho/para/arquivo/original.pot
pelo caminho para o arquivo POT original e caminho/para/arquivo/traduzido.po
pelo caminho para o arquivo PO traduzido.
Além disso, você precisará fornecer suas credenciais do Google Cloud usando a opção --credentials
e especificar o ID do projeto do Google Cloud usando a opção --project
. Por exemplo:
php bin/potrans google --from en --to pt-br --credentials caminho/para/credenciais.json --project ID_DO_PROJETO caminho/para/arquivo/original.pot caminho/para/arquivo/traduzido.po
Lembre-se de substituir caminho/para/credenciais.json
pelo caminho para o arquivo de credenciais do Google Cloud e ID_DO_PROJETO
pelo ID do projeto do Google Cloud.
Espero que essas informações ajudem você a usar o Potrans para traduzir automaticamente arquivos POT do WordPress.
Links uteis:
Repositório no GitHub do POTRANS
XAMPP Apache + MariaDB + PHP + Perl
Site oficial do Git para instalar no Windows
Baixar o Composer para rodar no Windows
Poedit utilitário para traduzir e revisar suas traduções
Ferramenta online alternativa paga para fazer a tradução “PoTranlate”
Como usar o Poedit para traduzir o WordPress (incluindo temas e plugins)