Cómo usar Poedit: La guía completa (2026)

Si alguna vez has abierto un archivo .po en un editor de texto plano, ya conoces la sensación. Cientos de pares msgid y msgstr, indicadores fuzzy esparcidos por todas partes, y a un error de teclado de romper todo el catálogo. Hay una forma mejor, y durante más de una década la respuesta estándar ha sido la misma aplicación de escritorio: Poedit.

Este tutorial de Poedit te guiará por todo, desde la instalación de la aplicación hasta la compilación de tu primer archivo .mo. Ya sea que estés traduciendo un tema de WordPress, un plugin o tu propio proyecto basado en Gettext, Poedit te ofrece un editor visual limpio que oculta el formato de archivo sin procesar y te permite concentrarte en el trabajo de traducción real.

Al final de esta guía, comprenderás la interfaz de Poedit, sabrás cómo iniciar una traducción desde una plantilla .pot, usar la Memoria de Traducción para acelerar el proceso y reconocerás exactamente dónde esta herramienta de escritorio gratuita deja de ser eficiente, para que sepas cuándo optar por un flujo de trabajo en la nube.

¿Qué es Poedit y cómo se instala?

Poedit es un editor de escritorio gratuito y multiplataforma para archivos de traducción Gettext (.po, .pot y el .mo compilado). Funciona en macOS, Windows y Linux, y es el punto de partida más recomendado para cualquiera que edite catálogos de traducción a mano.

La instalación es sencilla. Dirígete al sitio web oficial de Poedit y descarga el instalador para tu sistema operativo, o usa un gestor de paquetes.

# macOS (Homebrew)
brew install --cask poedit

# Debian / Ubuntu
sudo apt install poedit

# Windows (winget)
winget install Poedit.Poedit

La versión gratuita cubre completamente la experiencia de edición principal. Existe una versión de pago Poedit Pro que añade escaneo de código fuente y pre-traducción, que cubriremos más adelante. Por ahora, la descarga gratuita es todo lo que necesitas para abrir y editar cualquier catálogo.

Si deseas una visión más amplia del panorama de la edición antes de comprometerte, nuestra recopilación de las mejores herramientas gratuitas para editar y traducir archivos PO en Mac y Windows compara Poedit con las principales alternativas.

Entendiendo la interfaz de Poedit

Cuando abres un archivo .po (Archivo y luego Abrir, o simplemente arrastra el archivo a la ventana), Poedit presenta un diseño de tres zonas que se ajusta directamente a la estructura subyacente de Gettext.

Los paneles de origen y traducción

El área principal es una lista de dos columnas. La columna izquierda muestra la cadena de origen (msgid) exactamente como la escribió el desarrollador en el código. La columna derecha muestra tu traducción (msgstr). Al hacer clic en cualquier fila, esta se carga en el panel de edición inferior, donde escribes el texto traducido.

Considera esta entrada sin procesar dentro del archivo:

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

En Poedit, esa misma entrada aparece como una sola fila: el origen a la izquierda, una celda de traducción vacía a la derecha. Nunca tocas la sintaxis sin procesar. Simplemente escribes en el panel inferior y Poedit escribe el msgstr por ti.

Indicadores Fuzzy y colores de estado

Poedit codifica las filas por color para que puedas ver el estado del catálogo de un vistazo. Las cadenas no traducidas destacan, y las cadenas fuzzy, entradas marcadas con #, fuzzy en el archivo porque el origen cambió o la traducción se auto-emparejó, aparecen en un color distinto (normalmente naranja o amarillo). Las cadenas fuzzy son esencialmente indicadores de "necesita revisión". WordPress no las mostrará en el sitio en vivo, por lo que eliminarlas es importante. Puedes alternar el estado fuzzy en cualquier fila con un solo atajo una vez que hayas confirmado que la traducción es correcta.

Una barra de estado en la parte inferior muestra tu progreso: cadenas totales, cuántas están traducidas y cuántas permanecen fuzzy o sin traducir.

El panel de edición inferior también muestra contexto útil. Muestra el comentario de referencia de origen, la línea de código donde se usa la cadena (por ejemplo, #: includes/checkout.php:142), y cualquier nota de desarrollador dejada en el archivo. Estos comentarios son invaluables cuando una cadena corta como "Order" podría ser un sustantivo o un verbo; la referencia de origen te indica a qué archivo y característica pertenece, para que la traduzcas correctamente la primera vez. Dedicar unos segundos a leer ese contexto es la diferencia entre un catálogo preciso y uno lleno de frases incómodas y fuera de lugar.

¿Cómo se inicia una nueva traducción desde un archivo POT?

Un archivo .pot es una plantilla que contiene cada cadena de origen con traducciones vacías. Para empezar un idioma completamente nuevo, creas un .po a partir de esa plantilla en lugar de editar el .pot directamente.

En Poedit, elige Archivo y luego Nuevo desde Archivo POT/PO, selecciona el .pot del tema o plugin (normalmente dentro de su carpeta /languages), y elige tu idioma de destino. Poedit luego te pide el idioma y genera un catálogo nuevo con la convención de nombre de archivo correcta, por ejemplo, de_DE.po para alemán.

Configurando el catálogo y la cabecera Plural-Forms

Cada archivo .po lleva un bloque de cabecera, y el campo más importante para la corrección es Plural-Forms. Esta expresión le dice a Gettext cuántas variantes plurales necesita un idioma y cuál elegir para un recuento dado.

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

El inglés usa dos formas. Idiomas como el polaco y el ruso necesitan tres o más, y configurar esta cabecera incorrectamente produce recuentos gramaticalmente incorrectos. Poedit establece un valor predeterminado sensato cuando eliges el idioma, pero puedes revisarlo y editarlo en Catálogo y luego Propiedades. Si deseas una comprensión más profunda de por qué esta cabecera es tan fácil de equivocar, consulta nuestra guía sobre plurales de Gettext y pluralización compleja.

Las Propiedades del Catálogo también te permiten establecer el nombre del proyecto, el nombre y correo electrónico del traductor, el equipo de idiomas y el conjunto de caracteres. El conjunto de caracteres casi siempre debe ser UTF-8; cualquier otra opción corre el riesgo de dañar caracteres acentuados y escrituras no latinas. Poedit usa UTF-8 por defecto para los archivos nuevos, pero si heredas un catálogo más antiguo, vale la pena confirmarlo. Configurar correctamente la cabecera al principio te evita tener que rehacer el trabajo más tarde.

Una vez configurado, simplemente trabajas por la lista, traduciendo cada fila. Poedit guarda automáticamente tu posición, por lo que puedes cerrar la aplicación a mitad del catálogo y retomar exactamente donde lo dejaste. Para catálogos largos, los atajos de teclado para saltar a la siguiente cadena sin traducir o a la siguiente cadena fuzzy te mantienen en movimiento sin necesidad de desplazarte, que es donde se pierde la mayor parte del tiempo en la edición manual.

Memoria de Traducción y la división entre gratis y Pro

Una de las características más útiles de Poedit es la Memoria de Traducción (MT). A medida que traduces, Poedit recuerda cada par de origen y traducción. La próxima vez que aparezca una cadena de origen idéntica o similar, en el mismo archivo o en un proyecto diferente, Poedit te sugerirá tu traducción anterior automáticamente. Durante meses de trabajo, esto se convierte en una base de datos personal que acelera drásticamente las cadenas de interfaz de usuario repetitivas como "Guardar", "Cancelar" y "Añadir al carrito".

Las sugerencias de MT aparecen en el panel de edición y puedes aceptarlas con una pulsación de tecla. Ten en cuenta que las entradas rellenadas por MT a menudo se marcan como fuzzy por defecto, por lo que debes revisarlas antes de eliminar la bandera.

¿Qué añade Poedit Pro?

El editor gratuito maneja la traducción manual por completo. Poedit Pro (una actualización de pago) añade dos características destacadas:

• Escaneo de código fuente: Pro puede escanear tu código fuente PHP o JavaScript, encontrar cada llamada a Gettext __() y _e(), y extraer un .pot nuevo o actualizar un catálogo existente, sin necesidad de línea de comandos.
• Pre-traducción: Pro ofrece pre-traducción automática para todo el catálogo, pero funciona con un modelo de pago basado en créditos. Compras créditos, y los catálogos grandes los consumen rápidamente.

Para un solo idioma y un catálogo modesto, Pro es conveniente. La limitación honesta es la escala. Los créditos de pre-traducción se acumulan, y el flujo de trabajo sigue siendo fundamentalmente un archivo, un idioma, una sesión de escritorio a la vez.

También vale la pena aclarar qué hace y qué no hace la Memoria de Traducción. La MT solo sugiere traducciones que tú (o una base de datos de equipo compartida) hayas producido antes. Para un proyecto completamente nuevo sin historial, la memoria está vacía, por lo que no ofrece nada hasta que ya hayas traducido una parte significativa a mano. La MT acelera las cadenas repetitivas y recurrentes; no traduce contenido totalmente nuevo. Esa distinción importa cuando estimas cuánto tiempo llevará un catálogo nuevo, porque el primer idioma siempre es el más lento, y cada idioma subsiguiente comienza desde cero a menos que sus cadenas se superpongan.

Guardando tu trabajo y compilando archivos MO

¿Por qué WordPress necesita un archivo .mo si solo editaste un .po? Porque WordPress lee el .mo binario compilado en tiempo de ejecución, no el .po legible por humanos. La buena noticia es que Poedit maneja esto automáticamente.

Cuando pulsas Guardar, Poedit escribe el .po y, por defecto, compila el .mo correspondiente en la misma carpeta.

# 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

Si al guardar no se produce un .mo, verifica Preferencias y luego General y confirma que la opción "Compilar automáticamente archivo MO al guardar" esté habilitada. Un .mo faltante o desactualizado es una de las razones más comunes por las que una traducción terminada nunca aparece en el sitio en vivo. Si te encuentras con ese problema, nuestra guía de solución de problemas para traducciones que no aparecen en WordPress cubre la lista de verificación completa.

Cuando Poedit no es suficiente: escalando más allá del escritorio

Poedit es excelente para lo que es: un editor preciso, manual y de un solo archivo. La fricción aparece en el momento en que tus necesidades crecen. Traducir un plugin a doce idiomas significa doce sesiones separadas. Un catálogo de 10 MB con miles de cadenas significa horas de escritura o gastar créditos de pre-traducción. Y las ediciones manuales siempre conllevan el riesgo de equivocar un marcador de posición como %s o %1$s y romper silenciosamente la salida.

Aquí es exactamente donde un flujo de trabajo en la nube toma el relevo. SimplePoTranslate procesa tu catálogo a través de IA con conciencia de contexto con Bloqueo de Sintaxis, que congela cada %s, %1$s, {name} y etiqueta HTML para que la estructura nunca se rompa durante la traducción. El Procesamiento Inteligente por Lotes maneja archivos de más de 10 MB sin división manual, y obtienes el resultado en un ZIP listo para implementar que contiene .po, .mo, .json, .php y .xliff a la vez, todo en la nube sin instalación de escritorio y sin sobrecarga.

Usa Poedit para el ajuste fino y la revisión, el trabajo que mejor hace. Usa la nube cuando necesites velocidad masiva en muchos idiomas sin sacrificar la seguridad de los marcadores de posición.

¿Listo para traducir catálogos enteros a docenas de idiomas sin perder horas en el editor de escritorio? Prueba SimplePoTranslate gratis — no se requiere tarjeta de crédito. El nivel gratuito te permite traducir tu primer archivo .po en minutos, con Bloqueo de Sintaxis en cada cadena.