Poeditin käyttö: Täydellinen opas (2026)

Jos olet joskus avannut .po-tiedoston tavallisessa tekstieditorissa, tiedät tunteen. Sadat msgid- ja msgstr-parit, joka puolella olevat epäselvät liput (fuzzy flags) ja yksi väärä näppäily, joka rikkoo koko käännöskansion. On olemassa parempi tapa, ja yli vuosikymmenen ajan vakiovastaus on ollut sama työpöytäsovellus: Poedit.

Tämä Poedit-opas käy läpi kaiken sovelluksen asentamisesta ensimmäisen .mo-tiedoston kääntämiseen. Käännätpä sitten WordPress-teemaa, lisäosaa tai omaa Gettext-pohjaista projektiasi, Poedit tarjoaa puhtaan visuaalisen editorin, joka piilottaa raa'an tiedostomuodon ja antaa sinun keskittyä varsinaiseen käännöstyöhön.

Tämän oppaan lopussa ymmärrät Poeditin käyttöliittymän, tiedät, kuinka aloittaa käännös .pot-mallista, käytät käännösmuistia nopeuttamaan asioita ja tunnistat tarkalleen, missä ilmainen työpöytätyökalu lakkaa olemasta tehokas, jotta tiedät milloin siirtyä pilvipohjaiseen työnkulkuun.

Mikä on Poedit ja kuinka se asennetaan?

Poedit on ilmainen, monialustainen työpöytäeditori Gettext-käännöstiedostoille (.po, .pot ja käännetty .mo). Se toimii macOS:ssä, Windowsissa ja Linuxissa, ja se on laajimmin suositeltu lähtökohta kaikille, jotka muokkaavat käännöskansioita käsin.

Asennus on suoraviivaista. Siirry Poeditin virallisille verkkosivuille ja lataa asennusohjelma käyttöjärjestelmällesi tai käytä pakettienhallintaa.

# macOS (Homebrew)
brew install --cask poedit

# Debian / Ubuntu
sudo apt install poedit

# Windows (winget)
winget install Poedit.Poedit

Ilmainen versio kattaa ydinmuokkauskokemuksen täysin. On olemassa maksullinen Poedit Pro -taso, joka lisää lähdekoodin skannauksen ja esikäännöksen, joita käsittelemme myöhemmin. Toistaiseksi ilmainen lataus riittää minkä tahansa käännöskansion avaamiseen ja muokkaamiseen.

Jos haluat laajemman kuvan muokkausmahdollisuuksista ennen sitoutumista, kokoelmamme parhaista ilmaisista työkaluista PO-tiedostojen muokkaamiseen ja kääntämiseen Macilla ja Windowsilla vertaa Poeditia tärkeimpiin vaihtoehtoihin.

Poeditin käyttöliittymän ymmärtäminen

Kun avaat .po-tiedoston (Tiedosto ja sitten Avaa, tai yksinkertaisesti vedä tiedosto ikkunaan), Poedit esittää kolmen alueen asettelun, joka vastaa suoraan Gettextin alla olevaa rakennetta.

Lähde- ja käännöspaneelit

Pääalue on kaksisarakkeinen luettelo. Vasemmassa sarakkeessa näkyy lähdemerkkijono (msgid) täsmälleen sellaisena kuin kehittäjä sen koodiin kirjoitti. Oikeassa sarakkeessa näkyy sinun käännöksesi (msgstr). Rivin napsauttaminen lataa sen alareunan muokkauspaneeliin, johon kirjoitat käännetyn tekstin.

Harkitse tätä raakaa merkintää tiedostossa:

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

Poeditissa sama merkintä näkyy yhtenä rivinä: lähde vasemmalla, tyhjä käännössolu oikealla. Et koskaan koske raakaan syntaksiin. Kirjoitat vain alapaneeliin, ja Poedit kirjoittaa msgstr:n puolestasi.

Epäselvät liput (Fuzzy Flags) ja tilavärit

Poedit värikoodaa rivit, jotta näet käännöskansion tilan yhdellä silmäyksellä. Kääntämättömät merkkijonot erottuvat, ja epäselvät merkkijonot, tiedostossa #, fuzzy -merkinnällä varustetut merkinnät, koska lähde muuttui tai käännös vastaa automaattisesti, näkyvät eri värillä (yleensä oranssilla tai keltaisella). Epäselvät merkkijonot ovat pohjimmiltaan "vaatii tarkistusta" -lippuja. WordPress ei näytä niitä live-sivustolla, joten niiden poistaminen on tärkeää. Voit vaihtaa epäselvän tilan millä tahansa rivillä yhdellä pikanäppäimellä, kun olet varmistanut, että käännös on oikein.

Alareunan tilapalkki näyttää edistymisesi: merkkijonojen kokonaismäärän, kuinka monta on käännetty ja kuinka monta on edelleen epäselviä tai kääntämättömiä.

Alareunan muokkauspaneeli tuo esiin myös hyödyllistä kontekstia. Se näyttää lähdeviitekommentin, koodirivin, jolla merkkijonoa käytetään (esimerkiksi #: includes/checkout.php:142), ja mahdolliset kehittäjän tiedostoon jättämät muistiinpanot. Nämä kommentit ovat korvaamattomia, kun lyhyt merkkijono, kuten "Order" (Tilaus/Tilata), voi olla substantiivi tai verbi. Lähdeviite kertoo, mihin tiedostoon ja ominaisuuteen se kuuluu, joten käännät sen oikein heti ensimmäisellä kerralla. Muutaman sekunnin käyttäminen kontekstin lukemiseen on ero tarkan käännöskansion ja hankalaa, paikaltaan irrallista sanamuotoa sisältävän käännöskansion välillä.

Kuinka aloitat uuden käännöksen POT-tiedostosta?

.pot-tiedosto on malli, joka sisältää kaikki lähdemerkkijonot tyhjillä käännöksillä. Uuden kielen aloittamiseksi luot .po-tiedoston tästä mallista sen sijaan, että muokkaisit .pot-tiedostoa suoraan.

Valitse Poeditissa Tiedosto ja sitten Uusi POT/PO-tiedostosta, valitse teeman tai lisäosan .pot-tiedosto (yleensä sen /languages-kansiossa) ja valitse kohdekieli. Poedit kysyy sitten kielen ja luo uuden käännöskansion oikealla tiedostonimikäytännöllä, esimerkiksi de_DE.po saksalle.

Käännöskansion ja monikko-muotojen otsikon määrittäminen

Jokainen .po-tiedosto sisältää otsikkolohkon, ja tärkein kenttä oikeellisuuden kannalta on Plural-Forms. Tämä ilmaisu kertoo Gettextille, kuinka monta monikkovarianttia kieli tarvitsee ja mikä niistä valitaan tietylle lukumäärälle.

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

Englanti käyttää kahta muotoa. Puolan ja Venäjän kaltaiset kielet tarvitsevat kolme tai useampia, ja tämän otsikon virheellinen asettaminen tuottaa kieliopillisesti virheellisiä lukumääriä. Poedit asettaa järkevän oletuksen, kun valitset kielen, mutta voit tarkistaa ja muokata sitä kohdasta Käännöskansio ja sitten Ominaisuudet. Jos haluat syvällisemmän ymmärryksen siitä, miksi tämä otsikko on niin helppo asettaa väärin, katso oppaamme Gettextin monikkomuodot ja monimutkainen monikkojen käsittely.

Käännöskansion ominaisuudet (Catalog Properties) mahdollistavat myös projektin nimen, kääntäjän nimen ja sähköpostin, kielitiimin ja merkistön asettamisen. Merkistön tulisi lähes aina olla UTF-8; kaikki muu riskeeraa aksentoitujen merkkien ja ei-latinalaisten skriptien vääristymisen. Poedit käyttää UTF-8-oletusarvoa uusissa tiedostoissa, mutta jos perit vanhemman käännöskansion, se kannattaa vahvistaa. Otsikon oikein asettaminen kerran alussa säästää sinut myöhemmältä uudelleentyöltä.

Kun asetus on tehty, voit yksinkertaisesti käydä luetteloa läpi ja kääntää jokaisen rivin. Poedit tallentaa automaattisesti sijaintisi, joten voit sulkea sovelluksen kesken käännöskansion muokkauksen ja jatkaa täsmälleen siitä, mihin jäit. Pitkissä käännöskansioissa pikanäppäimet seuraavaan kääntämättömään tai seuraavaan epäselvään merkkijonoon hyppäämiseen pitävät sinut liikkeessä ilman vieritystä, mikä on suurin osa ajasta, joka kuluu manuaalisessa muokkauksessa.

Käännösmuisti (Translation Memory) ja ilmainen vs. Pro-versio

Yksi Poeditin hyödyllisimmistä ominaisuuksista on käännösmuisti (TM). Kun käännät, Poedit muistaa jokaisen lähde- ja käännösparin. Seuraavan kerran, kun identtinen tai samankaltainen lähdemerkkijono ilmestyy samaan tiedostoon tai eri projektiin, Poedit ehdottaa aiempaa käännöstäsi automaattisesti. Kuukausien työn aikana tämä rakentuu henkilökohtaiseksi tietokannaksi, joka nopeuttaa dramaattisesti toistuvia käyttöliittymämerkkejä, kuten "Tallenna", "Peruuta" ja "Lisää ostoskoriin".

TM-ehdotukset ilmestyvät muokkauspaneeliin, ja voit hyväksyä ne näppäimen painalluksella. Huomaa, että TM:llä täytetyt merkinnät on usein merkitty oletuksena epäselviksi (fuzzy), joten sinun tulee tarkistaa ne ennen lipun poistamista.

Mitä Poedit Pro lisää?

Ilmainen editori hoitaa manuaalisen käännöksen täysin. Poedit Pro (maksullinen päivitys) lisää kaksi pääominaisuutta:

• Lähdekoodin skannaus: Pro voi skannata PHP- tai JavaScript-lähdekoodisi, löytää kaikki __()- ja _e() Gettext-kutsut ja poimia tuoreen .pot-tiedoston tai päivittää olemassa olevan käännöskansion ilman komentoriviä.
• Esikäännös: Pro tarjoaa konekäännöksen koko käännöskansioon, mutta se toimii maksullisella, luottopohjaisella mallilla. Ostat luottoja, ja suuret käännöskansiot kuluttavat ne nopeasti.

Yhdelle kielelle ja vaatimattomalle käännöskansiolle Pro on kätevä. Rehellinen rajoitus on skaala. Esikäännös-luotot kertyvät, ja työnkulku on edelleen pohjimmiltaan yksi tiedosto, yksi kieli, yksi työpöytäistunto kerrallaan.

On myös syytä olla selkeä siitä, mitä käännösmuisti tekee ja mitä ei. TM ehdottaa vain käännöksiä, jotka sinä (tai jaettu tiimitietokanta) olet aiemmin tuottanut. Täysin uudessa projektissa, jossa ei ole historiaa, muisti on tyhjä, joten se ei tarjoa mitään, ennen kuin olet jo kääntänyt merkityksellisen osan käsin. TM nopeuttaa toistuvia ja toistuvia merkkijonoja; se ei käännä täysin uutta sisältöä. Tällä erolla on merkitystä arvioitaessa, kuinka kauan uuden käännöskansion tekeminen kestää, koska ensimmäinen kieli on aina hitain, ja jokainen myöhempi kieli alkaa puhtaalta pöydältä, elleivät sen merkkijonot mene päällekkäin.

Työn tallentaminen ja MO-tiedostojen kääntäminen

Miksi WordPress tarvitsee .mo-tiedoston, kun olet muokannut vain .po-tiedostoa? Koska WordPress lukee käännetyn binäärisen .mo-tiedoston suorituksen aikana, ei ihmisen luettavissa olevaa .po-tiedostoa. Hyvä uutinen on, että Poedit hoitaa tämän automaattisesti.

Kun painat Tallenna, Poedit kirjoittaa .po-tiedoston ja oletusarvoisesti kääntää vastaavan .mo-tiedoston samaan kansioon.

# 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

Jos tallentaminen ei tuota .mo-tiedostoa, tarkista Asetukset ja sitten Yleiset ja varmista, että "Käännä MO-tiedosto automaattisesti tallennettaessa" on käytössä. Puuttuva tai vanhentunut .mo-tiedosto on yksi yleisimmistä syistä siihen, miksi valmis käännös ei koskaan näy live-sivustolla. Jos törmäät tähän ongelmaan, vianmääritysopas käännösten puuttumiseen WordPressissä sisältää täydellisen tarkistuslistan.

Kun Poedit ei riitä: Skaalaus työpöytäsovelluksen ulkopuolelle

Poedit on erinomainen siinä, mitä se on: tarkka, manuaalinen, yhden tiedoston editori. Kitkaa syntyy heti, kun tarpeesi kasvavat. Yhden lisäosan kääntäminen kahdelletoista kielelle tarkoittaa kahtatoista erillistä istuntoa. 10 Mt:n käännöskansio tuhansilla merkkijonoilla tarkoittaa tuntien kirjoittamista tai esikäännöskrediittien kuluttamista. Ja manuaalisissa muokkauksissa on aina riski, että paikkamerkki, kuten %s tai %1$s, menee pieleen ja rikkoo hiljaisesti ulostulon.

Tässä kohtaa pilvipohjainen työnkulku ottaa vallan. SimplePoTranslate käsittelee käännöskansiosi kontekstitietoisen tekoälyn avulla syntaksin lukituksella (Syntax Locking), joka jäädyttää jokaisen %s, %1$s, {name} ja HTML-tagin, jotta rakenne ei voi koskaan rikkoutua käännöksen aikana. Älykäs eräkäsittely (Smart Batching) käsittelee yli 10 Mt:n tiedostoja ilman manuaalista jakamista, ja saat tuloksen takaisin käyttövalmiina ZIP-tiedostona, joka sisältää .po, .mo, .json, .php ja .xliff kerralla, kaikki pilvessä ilman työpöytäasennusta ja ilman turhaa tilanviettoa.

Käytä Poeditia hienosäätöön ja tarkistukseen, siihen työhön, jonka se tekee parhaiten. Käytä pilveä, kun tarvitset massiivista nopeutta monilla kielillä tinkimättä paikkamerkkien turvallisuudesta.

Oletko valmis kääntämään kokonaisia käännöskansioita kymmenille kielille tuhlaamatta tunteja työpöytäeditorissa? Kokeile SimplePoTranslatea ilmaiseksi – luottokorttia ei tarvita. Ilmainen taso antaa sinun kääntää ensimmäisen .po-tiedostosi muutamassa minuutissa, jokaisessa merkkijonossa syntaksin lukitus päällä.