Cum să folosești Poedit: Ghidul complet (2026)

Dacă ai deschis vreodată un fișier .po într-un editor de text simplu, știi deja sentimentul. Sute de perechi msgid și msgstr, marcaje fuzzy împrăștiate peste tot și o singură tastă greșită te poate separa de distrugerea întregului catalog. Există o cale mai bună, iar de peste un deceniu răspunsul standard a fost aceeași aplicație desktop: Poedit.

Acest tutorial Poedit parcurge totul, de la instalarea aplicației până la compilarea primului tău fișier .mo. Fie că traduci o temă WordPress, un plugin sau propriul tău proiect bazat pe Gettext, Poedit îți oferă un editor vizual curat care ascunde formatul brut al fișierului și te lasă să te concentrezi pe munca efectivă de traducere.

La sfârșitul acestui ghid vei înțelege interfața Poedit, vei ști cum să începi o traducere dintr-un șablon .pot, cum să utilizezi Memoria de Traducere pentru a accelera lucrurile și vei recunoaște exact unde instrumentul desktop gratuit nu mai este eficient, astfel încât să știi când să apelezi la un flux de lucru în cloud.

Ce este Poedit și cum îl instalezi?

Poedit este un editor desktop gratuit, multi-platformă, pentru fișierele de traducere Gettext (.po, .pot și .mo compilat). Rulează pe macOS, Windows și Linux și este punctul de plecare cel mai recomandat pentru oricine editează manual cataloage de traducere.

Instalarea este simplă. Accesează site-ul oficial Poedit și descarcă instalatorul pentru sistemul tău de operare, sau utilizează un manager de pachete.

# macOS (Homebrew)
brew install --cask poedit

# Debian / Ubuntu
sudo apt install poedit

# Windows (winget)
winget install Poedit.Poedit

Versiunea gratuită acoperă complet experiența de editare de bază. Există o variantă plătită, Poedit Pro, care adaugă scanarea codului sursă și pre-traducerea, pe care le vom aborda mai târziu. Deocamdată, descărcarea gratuită este tot ce ai nevoie pentru a deschide și edita orice catalog.

Dacă vrei o perspectivă mai largă asupra peisajului de editare înainte de a te decide, sinteza noastră a celor mai bune instrumente gratuite pentru a edita și traduce fișiere PO pe Mac și Windows compară Poedit cu principalele alternative.

Înțelegerea Interfeței Poedit

Când deschizi un fișier .po (Fișier, apoi Deschide, sau pur și simplu tragi fișierul în fereastră), Poedit prezintă o interfață cu trei zone care se mapează direct pe structura Gettext subiacentă.

Panourile Sursă și Traducere

Zona principală este o listă cu două coloane. Coloana din stânga afișează șirul sursă (msgid) exact așa cum l-a scris dezvoltatorul în cod. Coloana din dreapta afișează traducerea ta (msgstr). Dând clic pe orice rând, acesta se încarcă în panoul de editare din partea de jos, unde tastezi textul tradus.

Ia în considerare această intrare brută din fișier:

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

În Poedit, aceeași intrare apare ca un singur rând: sursa în stânga, o celulă de traducere goală în dreapta. Nu atingi niciodată sintaxa brută. Doar tastezi în panoul de jos, iar Poedit scrie msgstr pentru tine.

Marcaje Fuzzy și Culori de Stare

Poedit colorează rândurile pentru ca tu să poți vedea starea catalogului dintr-o privire. Șirurile netraduse ies în evidență, iar șirurile fuzzy, intrările marcate cu #, fuzzy în fișier deoarece sursa s-a schimbat sau traducerea a fost potrivită automat, apar într-o culoare distinctă (de obicei portocaliu sau galben). Șirurile fuzzy sunt, în esență, marcaje „necesită revizuire”. WordPress nu le va afișa pe site-ul live, așa că eliminarea lor este importantă. Poți comuta starea fuzzy pe orice rând cu o singură scurtătură odată ce ai confirmat că traducerea este corectă.

O bară de stare în partea de jos arată progresul tău: numărul total de șiruri, câte sunt traduse și câte rămân fuzzy sau netraduse.

Panoul de editare de jos afișează, de asemenea, un context util. Acesta arată comentariul de referință al sursei, linia de cod unde este utilizat șirul (de exemplu #: includes/checkout.php:142) și orice note de dezvoltator lăsate în fișier. Aceste comentarii sunt de neprețuit atunci când un șir scurt precum „Order” ar putea fi un substantiv sau un verb; referința sursei îți spune cărui fișier și funcționalitate aparține, astfel încât să îl traduci corect de prima dată. Petrecerea câtorva secunde citind acest context face diferența între un catalog precis și unul plin de formulări stângace, nepotrivite.

Cum începi o traducere nouă dintr-un fișier POT?

Un fișier .pot este un șablon care conține fiecare șir sursă cu traduceri goale. Pentru a începe o limbă complet nouă, creezi un fișier .po din acel șablon, în loc să editezi direct .pot.

În Poedit, alege Fișier, apoi Nou din fișier POT/PO, selectează fișierul .pot al temei sau pluginului (de obicei în folderul său /languages) și alege limba țintă. Poedit solicită apoi limba și generează un catalog nou cu convenția corectă de denumire a fișierului, de exemplu de_DE.po pentru germană.

Configurarea Antetului Catalogului și a Formelor Plurale

Fiecare fișier .po conține un bloc de antet, iar cel mai important câmp pentru corectitudine este Plural-Forms. Această expresie îi spune lui Gettext câte variante plurale necesită o limbă și pe care să o aleagă pentru un anumit număr.

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

Engleza utilizează două forme. Limbi precum poloneza și rusa au nevoie de trei sau mai multe, iar o greșeală în acest antet produce numere plural incorecte din punct de vedere gramatical. Poedit setează o valoare implicită rezonabilă atunci când alegi limba, dar poți să o revizuiești și să o editezi sub meniul Catalog, apoi Proprietăți. Dacă vrei o înțelegere mai profundă a motivului pentru care acest antet este atât de ușor de greșit, consultă ghidul nostru despre pluralele Gettext și pluralizarea complexă.

Proprietățile Catalogului îți permit, de asemenea, să setezi numele proiectului, numele și adresa de email a traducătorului, echipa lingvistică și setul de caractere. Setul de caractere ar trebui aproape întotdeauna să fie UTF-8; orice altceva riscă să denatureze caracterele accentuate și scripturile non-latine. Poedit folosește implicit UTF-8 pentru fișierele noi, dar dacă moștenești un catalog mai vechi, merită să confirmi. Configurarea corectă a antetului la început te scutește de refacerea muncii mai târziu.

Odată configurat, pur și simplu lucrezi pe listă, traducând fiecare rând. Poedit îți salvează automat poziția, astfel încât poți închide aplicația la jumătatea catalogului și poți relua exact de unde ai rămas. Pentru cataloagele lungi, scurtăturile de la tastatură pentru a sări la următorul șir netradus sau la următorul șir fuzzy te mențin în mișcare fără a derula, acesta fiind locul unde se pierde cel mai mult timp în editarea manuală.

Memoria de Traducere și Diferența dintre Versiunea Gratuită și cea Pro

Una dintre cele mai utile funcționalități ale Poedit este Memoria de Traducere (TM). Pe măsură ce traduci, Poedit memorează fiecare pereche sursă-traducere. Data viitoare când apare un șir sursă identic sau similar, în același fișier sau într-un proiect diferit, Poedit îți sugerează automat traducerea anterioară. Pe parcursul lunilor de muncă, aceasta se transformă într-o bază de date personală care accelerează dramatic șirurile de interfață repetitive precum „Save” (Salvare), „Cancel” (Anulare) și „Add to cart” (Adaugă în coș).

Sugestiile TM apar în panoul de editare și le poți accepta cu o tastă. Reține că intrările completate de TM sunt adesea marcate fuzzy în mod implicit, așa că ar trebui să le revizuiești înainte de a elimina marcajul.

Ce adaugă Poedit Pro?

Editorul gratuit gestionează complet traducerea manuală. Poedit Pro (o actualizare plătită) adaugă două funcționalități principale:

• Scanarea codului sursă: Versiunea Pro poate scana sursa ta PHP sau JavaScript, poate găsi fiecare apel Gettext __() și _e() și poate extrage un fișier .pot nou sau actualiza un catalog existent, fără a fi nevoie de linia de comandă.
• Pre-traducerea: Versiunea Pro oferă pre-traducere automată pentru întregul catalog, dar funcționează pe un model plătit, bazat pe credite. Cumperi credite, iar cataloagele mari le consumă rapid.

Pentru o singură limbă și un catalog modest, versiunea Pro este convenabilă. Limita reală este scalabilitatea. Creditele de pre-traducere se adună, iar fluxul de lucru este în continuare, fundamental, un fișier, o limbă, o sesiune desktop la un moment dat.

De asemenea, merită să fie clar ce face și ce nu face Memoria de Traducere. TM sugerează doar traduceri pe care tu (sau o bază de date partajată a echipei) le-ai produs anterior. Pentru un proiect nou-nouț, fără istoric, memoria este goală, deci nu oferă nimic până când nu ai tradus deja o parte semnificativă manual. TM accelerează șirurile repetitive și recurente; nu traduce conținut complet nou. Această distincție contează atunci când estimezi cât va dura un catalog nou, deoarece prima limbă este întotdeauna cea mai lentă, iar fiecare limbă ulterioară începe de la zero, cu excepția cazului în care șirurile se suprapun.

Salvarea Lucrului și Compilarea Fișierelor MO

De ce are nevoie WordPress de un fișier .mo când tu ai editat doar un fișier .po? Deoarece WordPress citește fișierul binar compilat .mo la rulare, nu fișierul .po lizibil de om. Vestea bună este că Poedit gestionează acest lucru automat.

Când apeși Salvare, Poedit scrie fișierul .po și, implicit, compilează fișierul .mo corespondent în același folder.

# 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

Dacă salvarea nu produce un fișier .mo, verifică Preferințe, apoi General și confirmă că „Compilează automat fișierul MO la salvare” este activat. Un fișier .mo lipsă sau învechit este unul dintre cele mai comune motive pentru care o traducere finalizată nu apare niciodată pe site-ul live. Dacă te confrunți cu această problemă, ghidul nostru de depanare pentru traduceri care nu apar în WordPress acoperă lista completă de verificări.

Când Poedit nu este suficient: Scalarea dincolo de desktop

Poedit este excelent pentru ceea ce este: un editor precis, manual, pentru un singur fișier. Fricțiunea apare în momentul în care nevoile tale cresc. Traducerea unui plugin în douăsprezece limbi înseamnă douăsprezece sesiuni separate. Un catalog de 10 MB cu mii de șiruri înseamnă ore de tastare sau consumarea rapidă a creditelor de pre-traducere. Iar editările manuale prezintă întotdeauna riscul de a greși un placeholder precum %s sau %1$s și de a strica silențios ieșirea.

Acesta este exact punctul în care un flux de lucru în cloud preia controlul. SimplePoTranslate rulează catalogul tău printr-un AI conștient de context cu Blocare Sintactică, care îngheață fiecare %s, %1$s, {name} și etichetă HTML, astfel încât structura să nu se poată sparge niciodată în timpul traducerii. Grouparea Inteligentă (Smart Batching) gestionează fișiere de peste 10 MB fără împărțire manuală, iar tu primești rezultatul sub forma unui ZIP gata de implementare, care conține fișiere .po, .mo, .json, .php și `.xliff deodată, totul în cloud, fără instalare desktop și fără supraîncărcare.

Utilizează Poedit pentru ajustări fine și revizuire, sarcina pe care o îndeplinește cel mai bine. Utilizează cloud-ul atunci când ai nevoie de viteză mare pentru multe limbi, fără a sacrifica siguranța placeholder-urilor.

Ești gata să traduci cataloage întregi în zeci de limbi fără să petreci ore în editorul desktop? Încearcă SimplePoTranslate gratuit — nu este necesar un card de credit. Nivelul gratuit îți permite să traduci primul tău fișier .po în câteva minute, cu Blocare Sintactică pe fiecare șir.