Jak używać Poedit: Kompletny przewodnik (2026)

Jeśli kiedykolwiek otwierałeś plik .po w zwykłym edytorze tekstu, znasz to uczucie. Setki par msgid i msgstr, niepewne flagi rozsiane wszędzie i jeden niewłaściwy ruch klawiatury od zepsucia całego katalogu. Jest lepszy sposób, a od ponad dekady standardową odpowiedzią jest ta sama aplikacja desktopowa: Poedit.

Ten samouczek Poedit przeprowadzi Cię przez wszystko, od instalacji aplikacji po kompilację pierwszego pliku .mo. Niezależnie od tego, czy tłumaczysz motyw WordPress, wtyczkę, czy własny projekt oparty na Gettext, Poedit zapewnia przejrzysty edytor wizualny, który ukrywa surowy format pliku i pozwala skupić się na właściwej pracy translatorskiej.

Pod koniec tego przewodnika zrozumiesz interfejs Poedit, dowiesz się, jak rozpocząć tłumaczenie z szablonu .pot, użyjesz pamięci tłumaczeniowej (Translation Memory) do przyspieszenia pracy i rozpoznasz, gdzie darmowe narzędzie desktopowe przestaje być wydajne, dzięki czemu będziesz wiedział, kiedy zamiast niego sięgnąć po workflow w chmurze.

Co to jest Poedit i jak go zainstalować?

Poedit to darmowy, wieloplatformowy edytor desktopowy dla plików tłumaczeń Gettext (.po, .pot i skompilowany .mo). Działa na macOS, Windows i Linux i jest najszerzej rekomendowanym punktem wyjścia dla każdego, kto ręcznie edytuje katalogi tłumaczeń.

Instalacja jest prosta. Przejdź na oficjalną stronę Poedit i pobierz instalator dla swojego systemu operacyjnego lub użyj menedżera pakietów.

# macOS (Homebrew)
brew install --cask poedit

# Debian / Ubuntu
sudo apt install poedit

# Windows (winget)
winget install Poedit.Poedit

Darmowa wersja w pełni obejmuje podstawowe doświadczenie edycyjne. Istnieje płatny poziom Poedit Pro, który dodaje skanowanie kodu źródłowego i wstępne tłumaczenie, o czym opowiemy później. Na razie darmowe pobieranie to wszystko, czego potrzebujesz, aby otworzyć i edytować dowolny katalog.

Jeśli chcesz uzyskać szerszy obraz środowiska edycji przed podjęciem decyzji, nasze zestawienie najlepszych darmowych narzędzi do edycji i tłumaczenia plików PO na Macu i Windowsie porównuje Poedit z głównymi alternatywami.

Zrozumienie interfejsu Poedit

Po otwarciu pliku .po (Plik, następnie Otwórz, lub po prostu przeciągając plik do okna), Poedit prezentuje układ trzystrefowy, który bezpośrednio odwzorowuje podstawową strukturę Gettext.

Panele źródłowe i tłumaczeniowe

Główny obszar to lista dwukolumnowa. Lewa kolumna pokazuje ciąg źródłowy (msgid) dokładnie tak, jak programista zapisał go w kodzie. Prawa kolumna pokazuje Twoje tłumaczenie (msgstr). Kliknięcie dowolnego wiersza ładuje go do panelu edycji na dole, gdzie wpisujesz przetłumaczony tekst.

Rozważ ten surowy wpis w pliku:

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

W Poedit ten sam wpis pojawia się jako pojedynczy wiersz: źródło po lewej, pusta komórka tłumaczenia po prawej. Nigdy nie dotykasz surowej składni. Po prostu wpisujesz tekst w dolnym panelu, a Poedit zapisuje za Ciebie msgstr.

Flagi 'Fuzzy' i kolory statusu

Poedit koduje wiersze kolorami, abyś mógł szybko ocenić stan katalogu. Nietłumaczone ciągi wyróżniają się, a niepewne (fuzzy) ciągi – wpisy oznaczone jako #, fuzzy w pliku, ponieważ źródło się zmieniło lub tłumaczenie zostało automatycznie dopasowane – pojawiają się w wyraźnym kolorze (zazwyczaj pomarańczowym lub żółtym). Ciągi fuzzy to zasadniczo flagi "wymaga przeglądu". WordPress nie wyświetli ich na stronie na żywo, więc ich usunięcie jest ważne. Możesz przełączać status fuzzy w dowolnym wierszu za pomocą jednego skrótu, gdy tylko potwierdzisz, że tłumaczenie jest poprawne.

Pasek stanu na dole pokazuje postęp: całkowitą liczbę ciągów, ile jest przetłumaczonych i ile pozostaje niepewnych (fuzzy) lub nietłumaczonych.

Dolny panel edycji również wyświetla pomocny kontekst. Pokazuje komentarz referencyjny do źródła, linię kodu, w której używany jest ciąg (na przykład #: includes/checkout.php:142), oraz wszelkie notatki programisty pozostawione w pliku. Te komentarze są nieocenione, gdy krótki ciąg, taki jak "Order", może być rzeczownikiem lub czasownikiem; odwołanie do źródła mówi Ci, do którego pliku i funkcji należy, dzięki czemu przetłumaczysz go poprawnie za pierwszym razem. Poświęcenie kilku sekund na przeczytanie tego kontekstu to różnica między dokładnym katalogiem a takim, który jest pełen niezręcznych, niepasujących sformułowań.

Jak rozpocząć nowe tłumaczenie z pliku POT?

Plik .pot to szablon zawierający każdy ciąg źródłowy z pustymi tłumaczeniami. Aby rozpocząć tworzenie nowego języka, tworzysz plik .po z tego szablonu, zamiast edytować bezpośrednio .pot.

W Poedit wybierz Plik, następnie Nowy z pliku POT/PO, wybierz plik .pot motywu lub wtyczki (zazwyczaj znajduje się w folderze /languages) i wybierz język docelowy. Poedit następnie zapyta o język i wygeneruje nowy katalog z prawidłową konwencją nazewnictwa, na przykład de_DE.po dla języka niemieckiego.

Konfiguracja katalogu i nagłówka Plural-Forms

Każdy plik .po zawiera blok nagłówka, a najważniejszym polem dla poprawności jest Plural-Forms. To wyrażenie informuje Gettext, ile wariantów liczby mnogiej potrzebuje dany język i który z nich wybrać dla danej liczby.

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

Angielski używa dwóch form. Języki takie jak polski i rosyjski potrzebują trzech lub więcej, a błędne ustawienie tego nagłówka powoduje gramatycznie niepoprawne liczby. Poedit ustawia rozsądne wartości domyślne po wybraniu języka, ale możesz je przejrzeć i edytować w zakładce Katalog, a następnie Właściwości. Jeśli chcesz głębiej zrozumieć, dlaczego ten nagłówek tak łatwo jest źle skonfigurować, zobacz nasz przewodnik na temat liczby mnogiej w Gettext i złożonej pluralizacji.

Właściwości katalogu pozwalają również ustawić nazwę projektu, imię i nazwisko oraz adres e-mail tłumacza, zespół językowy i zestaw znaków. Zestaw znaków powinien prawie zawsze być UTF-8; cokolwiek innego grozi zniekształceniem znaków akcentowanych i pism nielacińskich. Poedit domyślnie ustawia UTF-8 dla nowych plików, ale jeśli dziedziczysz starszy katalog, warto to potwierdzić. Prawidłowe ustawienie nagłówka na początku oszczędza ponownej pracy w przyszłości.

Po skonfigurowaniu po prostu pracujesz w dół listy, tłumacząc każdy wiersz. Poedit automatycznie zapisuje Twoją pozycję, więc możesz zamknąć aplikację w trakcie pracy nad katalogiem i wznowić dokładnie tam, gdzie skończyłeś. W przypadku długich katalogów, skróty klawiaturowe do przejścia do następnego nietłumaczonego lub następnego niepewnego (fuzzy) ciągu pozwalają Ci poruszać się bez przewijania, co jest miejscem, gdzie większość czasu jest tracona podczas ręcznej edycji.

Pamięć tłumaczeniowa a podział na wersję darmową i Pro

Jedną z najbardziej przydatnych funkcji Poedit jest Pamięć Tłumaczeniowa (TM). Podczas tłumaczenia Poedit zapamiętuje każdą parę źródło-tłumaczenie. Następnym razem, gdy pojawi się identyczny lub podobny ciąg źródłowy, w tym samym pliku lub w innym projekcie, Poedit automatycznie zasugeruje Twoje poprzednie tłumaczenie. Przez miesiące pracy buduje to osobistą bazę danych, która znacznie przyspiesza tłumaczenie powtarzalnych ciągów UI, takich jak "Zapisz", "Anuluj" i "Dodaj do koszyka".

Sugestie z TM pojawiają się w panelu edycji i możesz je zaakceptować za pomocą jednego naciśnięcia klawisza. Pamiętaj, że wpisy wypełnione przez TM są często domyślnie oznaczane jako niepewne (fuzzy), więc powinieneś je przejrzeć przed usunięciem flagi.

Co dodaje Poedit Pro?

Darmowy edytor w pełni obsługuje ręczne tłumaczenie. Poedit Pro (płatna aktualizacja) dodaje dwie główne funkcje:

• Skanowanie kodu źródłowego: Wersja Pro może skanować Twój kod źródłowy PHP lub JavaScript, znaleźć każde wywołanie Gettext __() i _e(), a także wyodrębnić nowy plik .pot lub zaktualizować istniejący katalog, bez konieczności używania wiersza poleceń.
• Pre-tłumaczenie: Wersja Pro oferuje maszynowe wstępne tłumaczenie całego katalogu, ale działa w oparciu o płatny model kredytowy. Kupujesz kredyty, a duże katalogi szybko je zużywają.

Dla pojedynczego języka i umiarkowanego katalogu, wersja Pro jest wygodna. Uczciwym ograniczeniem jest skala. Kredyty na wstępne tłumaczenie sumują się, a workflow nadal jest zasadniczo jeden plik, jeden język, jedna sesja desktopowa naraz.

Warto również jasno określić, co Pamięć Tłumaczeniowa robi, a czego nie. TM sugeruje tylko tłumaczenia, które Ty (lub wspólna baza danych zespołu) już wcześniej stworzyłeś. W przypadku zupełnie nowego projektu bez historii, pamięć jest pusta, więc nic nie oferuje, dopóki nie przetłumaczysz znaczącej części ręcznie. TM przyspiesza tłumaczenie powtarzających się i cyklicznych ciągów; nie tłumaczy zupełnie nowej treści. To rozróżnienie ma znaczenie, gdy szacujesz, ile czasu zajmie nowy katalog, ponieważ pierwszy język jest zawsze najwolniejszy, a każdy kolejny język zaczyna od zera, chyba że jego ciągi się pokrywają.

Zapisywanie pracy i kompilowanie plików MO

Dlaczego WordPress potrzebuje pliku .mo, skoro edytowałeś tylko .po? Ponieważ WordPress wczytuje skompilowany binarny plik .mo w czasie działania, a nie czytelny dla człowieka plik .po. Dobra wiadomość jest taka, że Poedit zajmuje się tym automatycznie.

Gdy naciśniesz Zapisz, Poedit zapisuje plik .po i, domyślnie, kompiluje pasujący plik .mo w tym samym folderze.

# 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

Jeśli zapisywanie nie tworzy pliku .mo, sprawdź Preferencje, następnie Ogólne i upewnij się, że opcja "Automatycznie kompiluj plik MO podczas zapisywania" jest włączona. Brakujący lub nieaktualny plik .mo jest jedną z najczęstszych przyczyn, dla których gotowe tłumaczenie nigdy nie pojawia się na żywej stronie. Jeśli napotkasz ten problem, nasz przewodnik rozwiązywania problemów, gdy Twoje tłumaczenia nie wyświetlają się w WordPressie zawiera pełną listę kontrolną.

Kiedy Poedit to za mało: Skalowanie poza desktop

Poedit jest doskonały w tym, co robi: jest precyzyjnym, ręcznym edytorem pojedynczych plików. Problemy pojawiają się, gdy Twoje potrzeby rosną. Tłumaczenie jednej wtyczki na dwanaście języków oznacza dwanaście oddzielnych sesji. Katalog o rozmiarze 10 MB z tysiącami ciągów to godziny pisania lub zużywanie kredytów na wstępne tłumaczenie. A ręczne edycje zawsze niosą ze sobą ryzyko pomylenia placeholderów, takich jak %s lub %1$s, i cichego zepsucia wyjścia.

To jest dokładnie moment, w którym przejmuje kontrolę workflow w chmurze. SimplePoTranslate przetwarza Twój katalog za pomocą AI świadomej kontekstu z Blokadą Składni (Syntax Locking), która zamraża każdy %s, %1$s, {name} i tag HTML, dzięki czemu struktura nigdy nie może ulec uszkodzeniu podczas tłumaczenia. Inteligentne Grupowanie (Smart Batching) obsługuje pliki o rozmiarze 10 MB i większe bez ręcznego dzielenia, a Ty otrzymujesz wynik z powrotem jako gotowy do wdrożenia ZIP zawierający .po, .mo, .json, .php i .xliff jednocześnie, wszystko w chmurze, bez instalacji desktopowej i bez zbędnego obciążenia.

Używaj Poedit do precyzyjnego dostrajania i przeglądania – do zadań, które wykonuje najlepiej. Używaj chmury, gdy potrzebujesz dużej szybkości w wielu językach, nie rezygnując z bezpieczeństwa placeholderów.

Gotowy przetłumaczyć całe katalogi na dziesiątki języków, nie tracąc godzin w edytorze desktopowym? Wypróbuj SimplePoTranslate za darmo — karta kredytowa nie jest wymagana. Darmowa wersja pozwala przetłumaczyć Twój pierwszy plik .po w ciągu kilku minut, z blokadą składni (Syntax Locking) dla każdego ciągu).