Come Usare Poedit: La Guida Completa (2026)

Se hai mai aperto un file .po in un editor di testo semplice, conosci già la sensazione. Centinaia di coppie msgid e msgstr, flag fuzzy sparsi ovunque, e un solo tasto sbagliato per rovinare l'intero catalogo. C'è un modo migliore, e per oltre un decennio la risposta standard è stata la stessa applicazione desktop: Poedit.

Questo tutorial su Poedit illustra ogni passaggio, dall'installazione dell'app alla compilazione del tuo primo file .mo. Che tu stia traducendo un tema WordPress, un plugin o il tuo progetto basato su Gettext, Poedit ti offre un editor visuale pulito che nasconde il formato del file originale e ti permette di concentrarti sul lavoro di traduzione effettivo.

Alla fine di questa guida comprenderai l'interfaccia di Poedit, saprai come iniziare una traduzione da un modello .pot, userai la Memoria di Traduzione per velocizzare il processo e riconoscerai esattamente dove lo strumento desktop gratuito smette di essere efficiente, così saprai quando optare per un workflow basato su cloud.

Cos'è Poedit e Come Si Installa?

Poedit è un editor desktop gratuito e multipiattaforma per i file di traduzione Gettext (.po, .pot e il compilato .mo). Funziona su macOS, Windows e Linux ed è il punto di partenza più raccomandato per chiunque modifichi cataloghi di traduzione manualmente.

L'installazione è semplice. Vai al sito web ufficiale di Poedit e scarica l'installer per il tuo sistema operativo, oppure usa un gestore di pacchetti.

# macOS (Homebrew)
brew install --cask poedit

# Debian / Ubuntu
sudo apt install poedit

# Windows (winget)
winget install Poedit.Poedit

La versione gratuita copre completamente l'esperienza di editing principale. Esiste un livello a pagamento Poedit Pro che aggiunge la scansione del codice sorgente e la pre-traduzione, che tratteremo più avanti. Per ora, il download gratuito è tutto ciò di cui hai bisogno per aprire e modificare qualsiasi catalogo.

Se desideri una visione più ampia del panorama degli editor prima di impegnarti, il nostro riepilogo dei migliori strumenti gratuiti per modificare e tradurre file PO su Mac e Windows confronta Poedit con le principali alternative.

Comprendere l'Interfaccia di Poedit

Quando apri un file .po (File quindi Apri, o semplicemente trascini il file sulla finestra), Poedit presenta un layout a tre zone che si mappa direttamente sulla struttura Gettext sottostante.

I Pannelli Origine e Traduzione

L'area principale è un elenco a due colonne. La colonna di sinistra mostra la stringa sorgente (msgid) esattamente come l'ha scritta lo sviluppatore nel codice. La colonna di destra mostra la tua traduzione (msgstr). Cliccando su una riga qualsiasi, questa viene caricata nel pannello di editing in basso, dove digiti il testo tradotto.

Considera questa voce grezza all'interno del file:

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

In Poedit, la stessa voce appare come una singola riga: l'origine a sinistra, una cella di traduzione vuota a destra. Non tocchi mai la sintassi grezza. Digiti semplicemente nel pannello inferiore e Poedit scrive il msgstr per te.

Flag Fuzzy e Colori di Stato

Poedit colora le righe in modo da poter visualizzare lo stato del catalogo a colpo d'occhio. Le stringhe non tradotte spiccano, e le stringhe fuzzy, le voci contrassegnate #, fuzzy nel file perché l'origine è cambiata o la traduzione è stata automaticamente abbinata, appaiono in un colore distinto (tipicamente arancione o giallo). Le stringhe fuzzy sono essenzialmente flag di "necessita revisione". WordPress non le visualizzerà sul sito live, quindi eliminarle è importante. Puoi attivare/disattivare lo stato fuzzy su qualsiasi riga con una singola scorciatoia una volta che hai confermato che la traduzione è corretta.

Una barra di stato in basso mostra i tuoi progressi: stringhe totali, quante sono tradotte e quante rimangono fuzzy o non tradotte.

Il pannello di editing inferiore fornisce anche un contesto utile. Mostra il commento di riferimento della sorgente, la riga di codice in cui viene utilizzata la stringa (ad esempio #: includes/checkout.php:142) e qualsiasi nota dello sviluppatore lasciata nel file. Questi commenti sono preziosi quando una stringa breve come "Order" potrebbe essere un sostantivo o un verbo, il riferimento della sorgente ti dice a quale file e funzionalità appartiene, in modo da tradurla correttamente la prima volta. Dedicare qualche secondo alla lettura di quel contesto è la differenza tra un catalogo accurato e uno pieno di frasi scomode e fuori luogo.

Come Si Inizia una Nuova Traduzione da un File POT?

Un file .pot è un modello che contiene ogni stringa sorgente con traduzioni vuote. Per iniziare una lingua completamente nuova, crei un .po da quel modello piuttosto che modificare direttamente il .pot.

In Poedit, scegli File quindi Nuovo da File POT/PO, seleziona il .pot del tema o del plugin (di solito all'interno della sua cartella /languages), e scegli la tua lingua di destinazione. Poedit quindi chiede la lingua e genera un nuovo catalogo con la corretta convenzione di denominazione del file, ad esempio de_DE.po per il tedesco.

Configurazione dell'Intestazione del Catalogo e dei Plurali

Ogni file .po contiene un blocco di intestazione, e il campo più importante per la correttezza è Plural-Forms. Questa espressione dice a Gettext quante varianti plurali una lingua necessita e quale scegliere per un dato conteggio.

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

L'inglese usa due forme. Lingue come il polacco e il russo ne necessitano tre o più, e un'errata impostazione di questa intestazione produce conteggi grammaticalmente errati. Poedit imposta un valore predefinito sensato quando scegli la lingua, ma puoi rivederlo e modificarlo sotto Catalogo quindi Proprietà. Se desideri una comprensione più approfondita del perché questa intestazione è così facile da sbagliare, consulta la nostra guida su plurali Gettext e pluralizzazione complessa.

Le Proprietà del Catalogo ti permettono anche di impostare il nome del progetto, il nome e l'e-mail del traduttore, il team della lingua e il set di caratteri. Il set di caratteri dovrebbe essere quasi sempre UTF-8; qualsiasi altra cosa rischia di rovinare i caratteri accentati e gli script non latini. Poedit imposta UTF-8 come predefinito per i nuovi file, ma se erediti un catalogo più vecchio vale la pena confermare. Impostare correttamente l'intestazione all'inizio ti evita di rifare il lavoro in seguito.

Una volta configurato, semplicemente lavori l'elenco, traducendo ogni riga. Poedit salva automaticamente la tua posizione, così puoi chiudere l'app a metà catalogo e riprendere esattamente da dove avevi interrotto. Per cataloghi lunghi, le scorciatoie da tastiera per passare alla stringa non tradotta successiva o alla stringa fuzzy successiva ti mantengono in movimento senza scorrere, il che è dove si perde la maggior parte del tempo nell'editing manuale.

Memoria di Traduzione e la Divisione Gratuita vs Pro

Una delle funzionalità più utili di Poedit è la Memoria di Traduzione (TM). Durante la traduzione, Poedit ricorda ogni coppia sorgente-traduzione. La prossima volta che appare una stringa sorgente identica o simile, nello stesso file o in un progetto diverso, Poedit suggerisce automaticamente la tua traduzione precedente. Nel corso di mesi di lavoro, questo si trasforma in un database personale che accelera notevolmente le stringhe UI ripetitive come "Salva", "Annulla" e "Aggiungi al carrello".

I suggerimenti della TM appaiono nel pannello di editing, e puoi accettarli con una combinazione di tasti. Nota che le voci riempite dalla TM sono spesso contrassegnate come fuzzy per impostazione predefinita, quindi dovresti rivederle prima di rimuovere il flag.

Cosa Aggiunge Poedit Pro?

L'editor gratuito gestisce completamente la traduzione manuale. Poedit Pro (un aggiornamento a pagamento) aggiunge due funzionalità principali:

• Scansione del codice sorgente: Pro può scansionare il tuo codice sorgente PHP o JavaScript, trovare ogni chiamata Gettext __() e _e(), ed estrarre un nuovo .pot o aggiornare un catalogo esistente, senza bisogno della riga di comando.
• Pre-traduzione: Pro offre la pre-traduzione automatica per l'intero catalogo, ma funziona con un modello a pagamento basato su crediti. Acquisti crediti, e i cataloghi di grandi dimensioni li consumano rapidamente.

Per una singola lingua e un catalogo modesto, Pro è conveniente. La limitazione onesta è la scalabilità. I crediti di pre-traduzione si sommano, e il flusso di lavoro è ancora fondamentalmente un file, una lingua, una sessione desktop alla volta.

Vale anche la pena essere chiari su ciò che la Memoria di Traduzione fa e non fa. La TM suggerisce solo traduzioni che tu (o un database di team condiviso) hai prodotto in precedenza. Per un progetto nuovo di zecca senza storia, la memoria è vuota, quindi non offre nulla finché non hai già tradotto una parte significativa a mano. La TM accelera le stringhe ripetitive e ricorrenti; non traduce contenuti completamente nuovi. Questa distinzione è importante quando si stima quanto tempo ci vorrà per un nuovo catalogo, perché la prima lingua è sempre la più lenta, e ogni lingua successiva parte da zero a meno che le sue stringhe non si sovrappongano.

Salvare il Tuo Lavoro e Compilare i File MO

Perché WordPress ha bisogno di un file .mo quando hai modificato solo un .po? Perché WordPress legge il file binario compilato .mo in fase di esecuzione, non il .po leggibile dall'uomo. La buona notizia è che Poedit gestisce questo automaticamente.

Quando premi Salva, Poedit scrive il .po e, per impostazione predefinita, compila il .mo corrispondente nella stessa cartella.

# 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 il salvataggio non produce un .mo, controlla Preferenze quindi Generale e conferma che "Compila automaticamente il file MO durante il salvataggio" sia abilitato. Un .mo mancante o obsoleto è una delle ragioni più comuni per cui una traduzione completata non appare mai sul sito live. Se ti trovi in questa situazione, la nostra guida alla risoluzione dei problemi per le traduzioni che non appaiono in WordPress copre l'elenco completo dei controlli.

Quando Poedit Non Basta: Scalare Oltre il Desktop

Poedit è eccellente per quello che è: un editor preciso, manuale, per file singoli. L'attrito appare nel momento in cui le tue esigenze crescono. Tradurre un plugin in dodici lingue significa dodici sessioni separate. Un catalogo da 10 MB con migliaia di stringhe significa ore di digitazione o esaurimento dei crediti di pre-traduzione. E le modifiche manuali comportano sempre il rischio di sbagliare un segnaposto come %s o %1$s e rompere silenziosamente l'output.

Questo è esattamente il punto in cui subentra un flusso di lavoro cloud. SimplePoTranslate elabora il tuo catalogo tramite IA sensibile al contesto con Syntax Locking, che blocca ogni %s, %1$s, {name} e tag HTML in modo che la struttura non possa mai rompersi durante la traduzione. Smart Batching gestisce file da oltre 10 MB senza divisione manuale, e ottieni il risultato sotto forma di un file ZIP pronto per il deployment contenente .po, .mo, .json, .php e .xliff tutto in una volta, tutto nel cloud senza installazione desktop e senza ingombro.

Usa Poedit per la messa a punto e la revisione, il lavoro che svolge al meglio. Usa il cloud quando hai bisogno di velocità in massa su molte lingue senza sacrificare la sicurezza dei segnaposto.

Pronto a tradurre interi cataloghi in decine di lingue senza bruciare ore nell'editor desktop? Prova SimplePoTranslate gratuitamente — nessuna carta di credito richiesta. Il livello gratuito ti permette di tradurre il tuo primo file .po in pochi minuti, con Syntax Locking su ogni stringa.