Como Usar o Poedit: O Guia Completo (2026)

Se você já abriu um arquivo .po em um editor de texto simples, você já conhece a sensação. Centenas de pares msgid e msgstr, flags 'fuzzy' espalhadas por toda parte, e um erro de digitação pode quebrar todo o catálogo. Existe uma maneira melhor, e há mais de uma década a resposta padrão tem sido o mesmo aplicativo de desktop: Poedit.

Este tutorial de Poedit aborda tudo, desde a instalação do aplicativo até a compilação do seu primeiro arquivo .mo. Seja você traduzindo um tema WordPress, um plugin ou seu próprio projeto baseado em Gettext, o Poedit oferece um editor visual limpo que oculta o formato de arquivo bruto e permite que você se concentre no trabalho de tradução real.

Ao final deste guia, você entenderá a interface do Poedit, saberá como iniciar uma tradução a partir de um modelo .pot, usar a Memória de Tradução para agilizar as coisas e reconhecerá exatamente onde a ferramenta de desktop gratuita deixa de ser eficiente, para que você saiba quando optar por um fluxo de trabalho na nuvem.

O Que é o Poedit e Como Instalá-lo?

Poedit é um editor de desktop gratuito e multiplataforma para arquivos de tradução Gettext (.po, .pot e o .mo compilado). Ele funciona em macOS, Windows e Linux, e é o ponto de partida mais amplamente recomendado para qualquer pessoa que edite catálogos de tradução manualmente.

A instalação é simples. Acesse o site oficial do Poedit e baixe o instalador para o seu sistema operacional, ou use um gerenciador de pacotes.

# macOS (Homebrew)
brew install --cask poedit

# Debian / Ubuntu
sudo apt install poedit

# Windows (winget)
winget install Poedit.Poedit

A versão gratuita cobre completamente a experiência de edição principal. Existe uma versão paga Poedit Pro que adiciona varredura de código-fonte e pré-tradução, que abordaremos mais tarde. Por enquanto, o download gratuito é tudo o que você precisa para abrir e editar qualquer catálogo.

Se você quiser uma visão mais ampla do cenário de edição antes de se comprometer, nosso resumo das melhores ferramentas gratuitas para editar e traduzir arquivos PO no Mac e Windows compara o Poedit com as principais alternativas.

Entendendo a Interface do Poedit

Ao abrir um arquivo .po (Arquivo e então Abrir, ou simplesmente arrastar o arquivo para a janela), o Poedit apresenta um layout de três zonas que se mapeia diretamente para a estrutura subjacente do Gettext.

Os Painéis de Origem e Tradução

A área principal é uma lista de duas colunas. A coluna da esquerda mostra a string de origem (msgid) exatamente como o desenvolvedor a escreveu no código. A coluna da direita mostra sua tradução (msgstr). Clicar em qualquer linha a carrega para o painel de edição na parte inferior, onde você digita o texto traduzido.

Considere esta entrada bruta dentro do arquivo:

#: includes/checkout.php:142
msgid "Your order has been placed."
msgstr ""

No Poedit, essa mesma entrada aparece como uma única linha: origem à esquerda, uma célula de tradução vazia à direita. Você nunca toca na sintaxe bruta. Você apenas digita no painel inferior e o Poedit escreve o msgstr para você.

Flags Fuzzy e Cores de Status

O Poedit codifica as linhas por cor para que você possa ver a saúde do catálogo rapidamente. Strings não traduzidas se destacam, e strings fuzzy, entradas marcadas com #, fuzzy no arquivo porque a origem mudou ou a tradução foi automaticamente correspondida, aparecem em uma cor distinta (geralmente laranja ou amarelo). Strings fuzzy são essencialmente flags de "precisa de revisão". O WordPress não as exibirá no site ativo, então limpá-las é importante. Você pode alternar o estado fuzzy em qualquer linha com um único atalho depois de confirmar que a tradução está correta.

Uma barra de status na parte inferior mostra seu progresso: total de strings, quantas foram traduzidas e quantas permanecem fuzzy ou não traduzidas.

O painel de edição inferior também exibe um contexto útil. Ele mostra o comentário de referência da origem, a linha de código onde a string é usada (por exemplo, #: includes/checkout.php:142) e quaisquer notas de desenvolvedor deixadas no arquivo. Esses comentários são inestimáveis quando uma string curta como "Order" poderia ser um substantivo ou um verbo, a referência da origem informa a qual arquivo e recurso ela pertence, para que você a traduza corretamente na primeira vez. Dedicar alguns segundos para ler esse contexto é a diferença entre um catálogo preciso e um cheio de frases estranhas e fora de contexto.

Como Iniciar uma Nova Tradução a Partir de um Arquivo POT?

Um arquivo .pot é um modelo que contém todas as strings de origem com traduções vazias. Para começar um novo idioma, você cria um .po a partir desse modelo, em vez de editar o .pot diretamente.

No Poedit, escolha Arquivo e então Novo a partir de Arquivo POT/PO, selecione o .pot do tema ou plugin (geralmente dentro da pasta /languages), e escolha seu idioma de destino. O Poedit então pede o idioma e gera um novo catálogo com a convenção de nome de arquivo correta, por exemplo, de_DE.po para alemão.

Configurando o Catálogo e o Cabeçalho Plural-Forms

Todo arquivo .po contém um bloco de cabeçalho, e o campo mais importante para a correção é Plural-Forms. Esta expressão informa ao Gettext quantas variantes de plural um idioma precisa e qual escolher para uma determinada contagem.

"Plural-Forms: nplurals=2; plural=(n != 1);\n"

O inglês usa duas formas. Idiomas como polonês e russo precisam de três ou mais, e errar este cabeçalho produz contagens gramaticalmente incorretas. O Poedit define um padrão sensato quando você escolhe o idioma, mas você pode revisá-lo e editá-lo em Catálogo e então Propriedades. Se você quiser uma compreensão mais profunda do porquê este cabeçalho é tão fácil de errar, consulte nosso guia sobre plurais Gettext e pluralização complexa.

As Propriedades do Catálogo também permitem que você defina o nome do projeto, o nome e e-mail do tradutor, a equipe de idioma e o conjunto de caracteres. O conjunto de caracteres deve ser quase sempre UTF-8; qualquer outra coisa corre o risco de corromper caracteres acentuados e scripts não latinos. O Poedit usa UTF-8 por padrão para novos arquivos, mas se você herdar um catálogo mais antigo, vale a pena confirmar. Acertar o cabeçalho logo no início evita que você refaça o trabalho mais tarde.

Uma vez configurado, você simplesmente trabalha na lista, traduzindo cada linha. O Poedit salva automaticamente sua posição, para que você possa fechar o aplicativo no meio do catálogo e continuar exatamente de onde parou. Para catálogos longos, os atalhos de teclado para pular para a próxima string não traduzida ou próxima string fuzzy mantêm você em movimento sem rolar, que é onde a maior parte do tempo é perdida na edição manual.

Memória de Tradução e a Divisão Gratuito vs Pro

Uma das características mais úteis do Poedit é a Memória de Tradução (TM). À medida que você traduz, o Poedit lembra cada par de origem e tradução. Da próxima vez que uma string de origem idêntica ou semelhante aparecer, no mesmo arquivo ou em um projeto diferente, o Poedit sugere sua tradução anterior automaticamente. Ao longo de meses de trabalho, isso se transforma em um banco de dados pessoal que acelera drasticamente strings de UI repetitivas como "Salvar", "Cancelar" e "Adicionar ao carrinho".

As sugestões de TM aparecem no painel de edição, e você pode aceitá-las com um atalho de teclado. Observe que as entradas preenchidas por TM são frequentemente marcadas como fuzzy por padrão, então você deve revisá-las antes de limpar a flag.

O Que o Poedit Pro Adiciona?

O editor gratuito lida completamente com a tradução manual. O Poedit Pro (uma atualização paga) adiciona duas funcionalidades principais:

• Varredura de código-fonte: O Pro pode escanear seu código-fonte PHP ou JavaScript, encontrar todas as chamadas Gettext __() e _e(), e extrair um novo .pot ou atualizar um catálogo existente, sem necessidade de linha de comando.
• Pré-tradução: O Pro oferece pré-tradução automática para todo o catálogo, mas funciona com um modelo pago e baseado em créditos. Você compra créditos, e catálogos grandes os consomem rapidamente.

Para um único idioma e um catálogo modesto, o Pro é conveniente. A limitação honesta é a escala. Os créditos de pré-tradução se acumulam, e o fluxo de trabalho ainda é fundamentalmente um arquivo, um idioma, uma sessão de desktop por vez.

Também vale a pena ser claro sobre o que a Memória de Tradução faz e não faz. A TM apenas sugere traduções que você (ou um banco de dados de equipe compartilhado) produziu anteriormente. Para um projeto totalmente novo, sem histórico, a memória está vazia, então ela não oferece nada até que você já tenha traduzido uma parte significativa manualmente. A TM acelera strings repetitivas e recorrentes; ela não traduz conteúdo totalmente novo. Essa distinção é importante ao estimar quanto tempo levará um catálogo novo, porque o primeiro idioma é sempre o mais lento, e cada idioma subsequente começa do zero, a menos que suas strings se sobreponham.

Salvando Seu Trabalho e Compilando Arquivos MO

Por que o WordPress precisa de um arquivo .mo quando você editou apenas um .po? Porque o WordPress lê o .mo binário compilado em tempo de execução, e não o .po legível por humanos. A boa notícia é que o Poedit lida com isso automaticamente.

Ao pressionar Salvar, o Poedit escreve o .po e, por padrão, compila o .mo correspondente na mesma pasta.

# After saving in Poedit you get both files:
wp-content/languages/themes/
  storefront-de_DE.po   # editable source
  storefront-de_DE.mo   # compiled binary WordPress loads

Se salvar não produzir um .mo, verifique Preferências e então Geral e confirme se "Compilar arquivo MO automaticamente ao salvar" está ativado. Um .mo ausente ou desatualizado é uma das razões mais comuns para uma tradução finalizada nunca aparecer no site ativo. Se você se deparar com esse problema, nosso guia de solução de problemas para traduções que não aparecem no WordPress cobre a lista completa.

Quando o Poedit Não é Suficiente: Indo Além do Desktop

O Poedit é excelente para o que se propõe: um editor preciso, manual e de arquivo único. O atrito aparece no momento em que suas necessidades crescem. Traduzir um plugin para doze idiomas significa doze sessões separadas. Um catálogo de 10MB com milhares de strings significa horas de digitação ou o esgotamento de créditos de pré-tradução. E as edições manuais sempre carregam o risco de errar um placeholder como %s ou %1$s e quebrar silenciosamente a saída.

É exatamente aqui que um fluxo de trabalho na nuvem assume o controle. O SimplePoTranslate processa seu catálogo através de uma IA ciente do contexto com Syntax Locking, que congela cada %s, %1$s, {name} e tag HTML para que a estrutura nunca possa ser quebrada durante a tradução. O Smart Batching lida com arquivos de mais de 10MB sem divisão manual, e você recebe o resultado de volta como um ZIP pronto para implantação contendo .po, .mo, .json, .php e .xliff de uma só vez, tudo na nuvem, sem instalação de desktop e sem inchaço.

Use o Poedit para ajuste fino e revisão, a tarefa que ele faz melhor. Use a nuvem quando precisar de velocidade em massa em muitos idiomas sem comprometer a segurança dos placeholders.

Pronto para traduzir catálogos inteiros para dezenas de idiomas sem gastar horas no editor de desktop? Experimente o SimplePoTranslate gratuitamente — nenhum cartão de crédito é necessário. O plano gratuito permite que você traduza seu primeiro arquivo .po em minutos, com Syntax Locking em cada string.