Hogyan használd a Poedit-et: A teljes útmutató (2026)

Ha valaha is megnyitottál egy .po fájlt egy egyszerű szövegszerkesztőben, már tudod, milyen érzés. Több száz msgid és msgstr pár, mindenhol szétszórt fuzzy jelzők, és egy rossz billentyűleütés választ el attól, hogy az egész katalógus tönkremenjen. Van jobb módja, és több mint egy évtizede a standard válasz ugyanaz az asztali alkalmazás: a Poedit.

Ez a Poedit oktatóanyag végigvezet mindenen, az alkalmazás telepítésétől az első .mo fájl fordításáig. Akár egy WordPress témát, egy plugint, vagy a saját Gettext-alapú projektedet fordítod, a Poedit egy tiszta vizuális szerkesztőt biztosít, amely elrejti a nyers fájlformátumot, és lehetővé teszi, hogy a tényleges fordítási munkára koncentrálj.

Ezen útmutató végére megérted a Poedit felületét, tudni fogod, hogyan indíts el egy fordítást egy .pot sablonból, hogyan használd a Fordítási Memóriát (Translation Memory) a munka felgyorsítására, és pontosan felismered, hol válik a ingyenes asztali eszköz hatástalanná, így tudni fogod, mikor kell helyette felhőalapú munkafolyamathoz nyúlni.

Mi az a Poedit és hogyan kell telepíteni?

A Poedit egy ingyenes, többplatformos asztali szerkesztő a Gettext fordítási fájlokhoz (.po, .pot, és a fordított .mo). Fut macOS, Windows és Linux rendszereken, és ez a legszélesebb körben ajánlott kiindulópont bárki számára, aki manuálisan szerkeszt fordítási katalógusokat.

A telepítés egyszerű. Látogass el a hivatalos Poedit weboldalra, és töltsd le az operációs rendszerednek megfelelő telepítőt, vagy használj csomagkezelőt.

# macOS (Homebrew)
brew install --cask poedit

# Debian / Ubuntu
sudo apt install poedit

# Windows (winget)
winget install Poedit.Poedit

Az ingyenes verzió teljes mértékben lefedi az alapvető szerkesztési élményt. Létezik egy fizetős Poedit Pro szint, amely forráskód-elemzést és előfordítást ad hozzá, ezekről később még szót ejtünk. Egyelőre az ingyenes letöltés minden, amire szükséged van bármely katalógus megnyitásához és szerkesztéséhez.

Ha szélesebb képet szeretnél a szerkesztési lehetőségekről, mielőtt elköteleznéd magad, a legjobb ingyenes PO fájl szerkesztő és fordító eszközök Mac-re és Windows-ra című összefoglalónk összehasonlítja a Poedit-et a főbb alternatívákkal.

A Poedit felületének megértése

Amikor megnyitsz egy .po fájlt (Fájl, majd Megnyitás, vagy egyszerűen húzd a fájlt az ablakra), a Poedit egy háromzónás elrendezést mutat, amely közvetlenül leképezi az alapul szolgáló Gettext struktúrát.

A Forrás és Fordítás panelek

A fő terület egy kétoszlopos lista. A bal oldali oszlop a forrás stringet (msgid) mutatja pontosan úgy, ahogy a fejlesztő a kódban megírta. A jobb oldali oszlop a te fordításodat (msgstr) mutatja. Bármely sorra kattintva betölti azt az alsó szerkesztőpanelbe, ahol beírhatod a lefordított szöveget.

Tekintsük ezt a nyers bejegyzést a fájlban:

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

A Poedit-ben ugyanaz a bejegyzés egyetlen sorban jelenik meg: a forrás balra, egy üres fordítási cella jobbra. Soha nem érinted a nyers szintaxist. Csak beírod az alsó panelbe, és a Poedit megírja a msgstr-t helyetted.

Fuzzy jelzők és állapot színek

A Poedit színkóddal jelöli a sorokat, így egy pillantással láthatod a katalógus állapotát. A lefordítatlan stringek kiemelkednek, és a fuzzy stringek, a fájlban #, fuzzy jelzéssel ellátott bejegyzések, mert a forrás megváltozott, vagy a fordítás automatikusan illesztésre került, különálló színben jelennek meg (általában narancssárga vagy sárga). A fuzzy stringek lényegében "átnézésre szoruló" jelzők. A WordPress nem fogja megjeleníteni őket az élő oldalon, ezért a tisztázásuk fontos. A fuzzy állapotot bármely soron egyetlen billentyűparanccsal átkapcsolhatod, miután megerősítetted, hogy a fordítás helyes.

Az alsó állapotsor mutatja az előrehaladást: összes string, hány van lefordítva, és hány marad fuzzy vagy lefordítatlan.

Az alsó szerkesztőpanel hasznos kontextust is mutat. Megjeleníti a forráshivatkozás kommentjét, a kódsort, ahol a stringet használják (például #: includes/checkout.php:142), és a fájlban hagyott fejlesztői megjegyzéseket. Ezek a kommentek felbecsülhetetlenek, amikor egy rövid string, mint az "Order", lehet főnév vagy ige, a forráshivatkozás megmondja, melyik fájlhoz és funkcióhoz tartozik, így elsőre helyesen fordítod le. Néhány másodperc eltöltése a kontextus elolvasásával az a különbség egy pontos katalógus és egy furcsa, oda nem illő szófordulatokkal teli katalógus között.

Hogyan indíts el egy új fordítást egy POT fájlból?

A .pot fájl egy sablon, amely minden forrás stringet üres fordításokkal tartalmaz. Egy vadonatúj nyelv megkezdéséhez egy .po fájlt hozol létre ebből a sablonból, ahelyett, hogy közvetlenül a .pot fájlt szerkesztenéd.

A Poedit-ben válaszd a Fájl menüből az Új POT/PO Fájlból lehetőséget, válaszd ki a téma vagy plugin .pot fájlját (általában a /languages mappájában található), és válaszd ki a célnyelvet. A Poedit ezután megkérdezi a nyelvet, és létrehoz egy friss katalógust a helyes fájlnév konvencióval, például de_DE.po a német nyelvhez.

A katalógus és a Plural-Forms fejléc konfigurálása

Minden .po fájl tartalmaz egy fejléc blokkot, és a helyesség szempontjából a legfontosabb mező a Plural-Forms. Ez a kifejezés megmondja a Gettext-nek, hány többes számú variánsra van szüksége egy nyelvnek, és melyiket válassza egy adott számhoz.

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

Az angol két formát használ. Az olyan nyelvek, mint a lengyel és az orosz, háromra vagy többre van szükségük, és ha ez a fejléc hibás, nyelvtanilag hibás számokat eredményez. A Poedit alapértelmezett értéket állít be, amikor kiválasztod a nyelvet, de a Katalógus, majd Tulajdonságok alatt áttekintheted és szerkesztheted. Ha mélyebben meg szeretnéd érteni, miért olyan könnyű elrontani ezt a fejlécet, olvasd el útmutatónkat a Gettext többes számokról és a komplex többes szám képzésről.

A Katalógus Tulajdonságai lehetővé teszik a projekt nevének, a fordító nevének és e-mail címének, a nyelvi csapatnak és a karakterkészletnek a beállítását is. A karakterkészletnek szinte mindig UTF-8-nak kell lennie; bármi más kockáztatja az ékezetes karakterek és a nem latin írásjelek elrontását. A Poedit alapértelmezés szerint UTF-8-at használ az új fájlokhoz, de ha egy régebbi katalógust örökölsz, érdemes ellenőrizni. A fejléc helyes beállítása a kezdeteknél megkímél attól, hogy később újra elvégezd a munkát.

Miután konfiguráltad, egyszerűen végigmész a listán, lefordítva minden sort. A Poedit automatikusan menti a pozíciódat, így a katalógus közepén bezárhatod az alkalmazást, és pontosan ott folytathatod, ahol abbahagytad. Hosszú katalógusok esetén a billentyűparancsok, amelyek a következő lefordítatlan vagy a következő fuzzy stringre ugranak, folyamatosan mozgásban tartanak görgetés nélkül, ami a manuális szerkesztés során elveszített idő nagy részét teszi ki.

Fordítási memória és az ingyenes vs. Pro közötti különbség

A Poedit egyik leghasznosabb funkciója a Fordítási Memória (TM). Fordítás közben a Poedit megjegyzi az összes forrás- és fordításpárt. Amikor legközelebb egy azonos vagy hasonló forrás string jelenik meg, ugyanabban a fájlban vagy egy másik projektben, a Poedit automatikusan javasolja a korábbi fordításodat. Hónapok munkája során ez egy személyes adatbázissá épül, amely drámaian felgyorsítja az ismétlődő felhasználói felületi stringek, mint a "Mentés", "Mégse" és "Kosárba tesz" fordítását.

A TM javaslatok a szerkesztőpanelen jelennek meg, és billentyűparanccsal elfogadhatók. Vedd figyelembe, hogy a TM-mel kitöltött bejegyzéseket gyakran alapértelmezés szerint fuzzy-ként jelölik, ezért felül kell vizsgálni őket, mielőtt törölnéd a jelzőt.

Mit ad hozzá a Poedit Pro?

Az ingyenes szerkesztő teljes mértékben kezeli a manuális fordítást. A Poedit Pro (egy fizetős frissítés) két kiemelkedő funkciót ad hozzá:

• Forráskód-elemzés: A Pro képes szkennelni a PHP vagy JavaScript forráskódodat, megtalálni az összes __() és _e() Gettext hívást, és kivonni egy friss .pot fájlt, vagy frissíteni egy meglévő katalógust, parancssor nélkül.
• Előfordítás: A Pro gépi előfordítást kínál a teljes katalógushoz, de ez egy fizetős, kredit alapú modellen működik. Krediteket vásárolsz, és a nagy katalógusok gyorsan elfogyasztják azokat.

Egyetlen nyelv és egy szerény katalógus esetén a Pro kényelmes. Az őszinte korlát a méret. Az előfordítási kreditek összeadódnak, és a munkafolyamat alapvetően továbbra is egy fájl, egy nyelv, egy asztali munkamenet egyszerre.

Érdemes azt is tisztázni, hogy mit tesz és mit nem a Fordítási Memória. A TM csak olyan fordításokat javasol, amelyeket te (vagy egy megosztott csapatadatbázis) korábban készítettél. Egy vadonatúj, előzmények nélküli projekt esetén a memória üres, így semmit sem kínál, amíg manuálisan nem fordítottál le egy jelentős részt. A TM felgyorsítja az ismétlődő és visszatérő stringeket; nem fordít teljesen új tartalmat. Ez a különbség számít, amikor megbecsülöd, mennyi ideig tart egy friss katalógus elkészítése, mert az első nyelv mindig a leglassabb, és minden következő nyelv tiszta lappal indul, kivéve, ha a stringek átfedik egymást.

Munkád mentése és MO fájlok fordítása

Miért van szüksége a WordPress-nek egy .mo fájlra, ha csak egy .po fájlt szerkesztettél? Mert a WordPress futásidőben a fordított bináris .mo fájlt olvassa, nem az emberi olvasásra alkalmas .po fájlt. A jó hír az, hogy a Poedit ezt automatikusan kezeli.

Amikor megnyomod a Mentés gombot, a Poedit megírja a .po fájlt, és alapértelmezés szerint fordítja a hozzá illő .mo fájlt ugyanabba a mappába.

# 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

Ha a mentés nem hoz létre .mo fájlt, ellenőrizd a Beállításokat, majd az Általános részt, és győződj meg róla, hogy az "MO fájl automatikus fordítása mentéskor" engedélyezve van. Egy hiányzó vagy elavult .mo fájl az egyik leggyakoribb ok, amiért egy elkészült fordítás soha nem jelenik meg az élő oldalon. Ha ebbe a problémába ütközöl, útmutatónk a WordPress-ben meg nem jelenő fordítások hibaelhárításához tartalmazza a teljes ellenőrzőlistát.

Amikor a Poedit nem elég: A desktopon túli skálázás

A Poedit kiváló arra, amire való: precíz, manuális, egyedi fájlszerkesztő. A súrlódás abban a pillanatban jelentkezik, amikor az igényeid növekednek. Egy plugin tizenkét nyelvre történő fordítása tizenkét külön munkamenetet jelent. Egy 10 MB-os, több ezer stringet tartalmazó katalógus órákig tartó gépelést vagy az előfordítási kreditek elégetését jelenti. A manuális szerkesztések pedig mindig magukban hordozzák annak kockázatát, hogy elrontunk egy helyőrzőt, mint például %s vagy %1$s, és csendben tönkretesszük a kimenetet.

Pontosan itt veszi át az uralmat egy felhőalapú munkafolyamat. A SimplePoTranslate kontextustudatos mesterséges intelligencia segítségével futtatja a katalógusodat szintaxis-zárolással (Syntax Locking), amely "befagyaszt" minden %s, %1$s, {name} és HTML taget, így a struktúra soha nem sérülhet a fordítás során. A Smart Batching kezeli a 10 MB-nál nagyobb fájlokat kézi felosztás nélkül, és az eredményt egy azonnal telepíthető ZIP fájlban kapod vissza, amely .po, .mo, .json, .php és .xliff fájlokat tartalmaz egyszerre, mindezt a felhőben, asztali telepítés és "felfúvódás" nélkül.

Használd a Poedit-et a finomhangolásra és az áttekintésre, arra a feladatra, amiben a legjobb. Használd a felhőt, amikor sok nyelven gyorsan kell tömeges fordítást végezned anélkül, hogy feladnád a helyőrzők biztonságát.

Készen állsz arra, hogy teljes katalógusokat fordíts le több tucat nyelvre anélkül, hogy órákat égetnél el az asztali szerkesztőben? Próbáld ki a SimplePoTranslate-et ingyen — nincs szükség hitelkártyára. Az ingyenes szinttel percek alatt lefordíthatod az első .po fájlodat, minden stringen Szintaxis-zárolással.