Tłumaczenie aplikacji webowej różni się od tłumaczenia dokumentu w jednym kluczowym aspekcie: tekst jest osadzony w kodzie. Zlecenie tłumaczenia plików .json, .xliff czy .po bez przygotowania technicznego to prosta droga do zepsutego interfejsu. Dobrze przeprowadzona lokalizacja aplikacji webowej łączy pracę tłumacza, inżyniera lokalizacji i testera – i dzieje się to równolegle z cyklem wydań oprogramowania.
W skrócie
- Tekst w aplikacji webowej jest wyodrębniany z kodu do plików zasobów (.json, .xliff, .po) – tłumacz pracuje na plikach, nie na zrzutach ekranu
- Kod nie wchodzi w zakres wyceny – płacisz tylko za słowa przeznaczone do tłumaczenia
- Kluczowe wyzwania to: wydłużenie tekstu, brak kontekstu UI i synchronizacja z harmonogramem wydań
- Pseudolokalizacja pozwala wykryć błędy układu przed właściwym tłumaczeniem
Spis treści
- Jak wygląda tekst w aplikacji webowej?
- Jakie formaty plików obsługuje agencja tłumaczeniowa?
- Czym jest ekspansja tekstu i dlaczego niszczy UI?
- Jak zapewnić tłumaczowi kontekst interfejsu?
- Jak zsynchronizować tłumaczenia z cyklem wydań?
- FAQ
- Podsumowanie
Jak wygląda tekst w aplikacji webowej?
Aplikacje webowe nie trzymają tłumaczonych treści w kodzie źródłowym. Frameworki takie jak React, Angular czy Vue.js wyodrębniają je do osobnych plików zasobów – to tzw. internacjonalizacja (i18n). Deweloper definiuje klucze („button.save”: „Zapisz”), a aplikacja w czasie działania dobiera odpowiedni plik językowy.
Praktyczne znaczenie dla zleceniodawcy jest jedno: agencja tłumaczeniowa nie widzi całej aplikacji – dostaje plik z parami klucz–wartość. Dobre przygotowanie projektu po stronie klienta polega na dostarczeniu pliku z pełnym zestawem stringów do tłumaczenia, bez kodu, skryptów ani zmiennych interpolacyjnych, które mogłyby przypadkowo trafić do tłumaczenia.
Jakie formaty plików obsługuje agencja tłumaczeniowa?
Najczęściej spotykane formaty w projektach webowych:
| Format | Typowe zastosowanie |
| .json | React, Angular, Vue.js, Node.js |
| .xliff/.xlf | Standard wymiany między narzędziami CAT |
| .po/.pot | Gettext, PHP, starsze CMS-y |
| .arb | Flutter / aplikacje wieloplatformowe |
| .strings | iOS (przy projektach cross-platform) |
Narzędzia CAT (memoQ, Trados, Phrase) otwierają wszystkie powyższe formaty bez konieczności ręcznego rozpakowywania kodu. Co ważne: kod nie jest wliczany do wyceny – płacisz wyłącznie za słowa przeznaczone do tłumaczenia. Zmienne interpolacyjne ({username}, %d pliki) są blokowane w narzędziu CAT i trafiają do tłumacza jako nienaruszalne symbole zastępcze (placeholdery).
Czym jest ekspansja tekstu i dlaczego niszczy UI?
Ekspansja tekstu to jeden z najczęściej pomijanych problemów w lokalizacji aplikacji webowych. Języki europejskie zajmują więcej miejsca niż angielski:
| Język | Przeciętna ekspansja względem EN |
| Niemiecki | +25–35% |
| Polski | +20–30% |
| Fiński | +25–40% |
| Japoński | –10–20% (kontrakcja) |
Przycisk Save w angielskim interfejsie ma 4 znaki. Zapisz to 6 znaków, Speichern – 9. Jeśli designer zaprojektował przycisk o stałej szerokości, tekst w niemieckiej wersji zostanie obcięty lub naruszy układ (layout).
Rozwiązaniem jest pseudolokalizacja – przed właściwym tłumaczeniem deweloperzy generują sztuczną wersję językową, która wydłuża wszystkie stringi o 30–40% i zastępuje znaki ASCII odpowiednikami Unicode (Ŝävë). Pozwala to wykryć błędy UI bez angażowania tłumacza. Studio Gambit oferuje wsparcie inżynierów lokalizacji na tym etapie – tak żeby layout był gotowy, zanim trafi do nas właściwy projekt.
Jak zapewnić tłumaczowi kontekst interfejsu?
Tłumacz pracuje na pliku z kluczami – bez kontekstu może przetłumaczyć Close jako „Zamknij” (okno) zamiast „Zakończ” (sesję), albo View jako „Widok” zamiast „Wyświetl”. Konsekwencja: niespójny interfejs i konieczność rewizji po wdrożeniu.
Trzy sposoby na zapewnienie kontekstu:
- Screenshoty przypisane do kluczy – większość platform TMS (Phrase, Lokalise) obsługuje funkcję screenshots-in-context, gdzie każdy klucz ma podgląd ekranu.
- Komentarze w pliku – standardowy mechanizm w formacie XLIFF; deweloper może dodać notatkę max. 20 znaków, przycisk w prawym górnym rogu.
- Glosariusz projektowy – lista terminów specyficznych dla produktu z zatwierdzonymi odpowiednikami. Przy aktualizacjach oszczędza czas i zapewnia spójność terminologiczną.
Kontekst konwersacyjny chatbotów i asystentów głosowych jest jeszcze bardziej wymagający niż w statycznym UI.
Jak zsynchronizować tłumaczenia z cyklem wydań?
Największy problem operacyjny przy lokalizacji aplikacji webowych to string freeze – moment, w którym deweloperzy zamrażają treści do tłumaczenia i nie wprowadzają już zmian aż do momentu zakończenia projektu. Bez tego tłumacze pracują na materiale, który zmienia się w trakcie realizacji.
W praktyce warto ustalić z agencją:
- Datę string freeze – minimum 5–7 dni roboczych przed planowanym wydaniem w przypadku standardowego projektu, 2–3 dni przy trybie ekspresowym
- Procedurę obsługi hotfixów – jeśli zmianie ulegnie krytyczny string po zamrożeniu, dobra agencja obsłuży aktualizację poza głównym projektem, bez konieczności przerabiania całości
- Format pliku docelowego – czy agencja zwraca przetłumaczony plik w tym samym formacie i strukturze co oryginał (warunek konieczny dla automatycznego wdrożenia przez CI/CD)
Nasze usługi lokalizacji oprogramowania obejmują pełne wsparcie inżynieryjne: od przyjęcia pliku w formacie klienta, przez obsługę narzędzi CAT, aż po zwrot gotowego do wdrożenia zasobu – z certyfikatami ISO 9001 i ISO 27001 gwarantującymi bezpieczeństwo kodu źródłowego.
FAQ
Czy agencja tłumaczeniowa może pracować bezpośrednio w moim repozytorium GitHub?
Tak, za pośrednictwem integracji z platformami TMS takimi jak Phrase lub Lokalise, które synchronizują pliki bezpośrednio z repozytorium. Eliminuje to ręczne przesyłanie plików i redukuje ryzyko błędu przy wykonywaniu operacji merge.
Czy kod w pliku JSON zostanie przetłumaczony przez pomyłkę?
Nie – narzędzia CAT blokują klucze, zmienne interpolacyjne i znaczniki HTML. Tłumacz widzi tylko wartości przeznaczone do tłumaczenia.
Ile trwa tłumaczenie aplikacji webowej na jeden język?
Przy typowym projekcie SaaS (2000–5000 słów) czas realizacji wynosi 2–4 dni robocze. Przy trybie ekspresowym – nawet 24 godziny, bez dopłat.
Co to jest lokalizacja, a co tłumaczenie oprogramowania?
Tłumaczenie to przekład tekstu. Lokalizacja obejmuje dodatkowo: adaptację formatów daty i waluty, dostosowanie kierunku tekstu (RTL dla arabskiego lub hebrajskiego), zmianę elementów graficznych i weryfikację zgodności z lokalnymi przepisami.
Jak wyceniane jest tłumaczenie pliku JSON z powtarzającymi się stringami?
Powtórzenia i fuzzy matches są rozliczane z rabatem – standardowo 0–30% ceny pełnego tłumaczenia, w zależności od procentu zgodności. Pamięć tłumaczeniowa (TM) z poprzednich projektów redukuje koszty kolejnych wydań.
Czy tłumaczenia muszą przejść testy językowe po wdrożeniu?
Tak, szczególnie w językach z ekspansją tekstu i przy RTL. LQA (Linguistic Quality Assurance) polega na przeglądaniu przetłumaczonej aplikacji w środowisku testowym i wychwytywaniu błędów układu i tłumaczenia w kontekście rzeczywistego UI.
Co się dzieje, gdy deweloper doda nowe stringi po oddaniu tłumaczenia?
Nowe stringi trafiają do agencji jako oddzielne zlecenie uzupełniające. Dobre praktyki zalecają oznaczanie nowych kluczy w pliku, by ułatwić identyfikację zmian między wersjami.
Czy Studio Gambit obsługuje tłumaczenia na języki z pismem od prawej do lewej (RTL)?
Tak – arabski, hebrajski i perski wymagają nie tylko tłumaczenia, ale też dostosowania układu przez inżynierów lokalizacji. Studio Gambit zapewnia pełne wsparcie techniczne w tym zakresie.
Podsumowanie
Tłumaczenie aplikacji webowej to projekt inżynieryjno-językowy. Kluczowe elementy sukcesu to: dobrze przygotowane pliki zasobów, kontekst UI dla tłumacza, obsługa ekspansji tekstu przez zespół deweloperski oraz synchronizacja z harmonogramem wydań. Agencja z własnym zapleczem inżynierów lokalizacji skróci czas wdrożenia i wyeliminuje kosztowne rewizje po wydaniu.
Bibliografia
- W3C Internationalization Activity – Internationalization (I18N): enabling access to a Web for All, 2024
- W3C Internationalization Glossary, opubl. 17.10.2024
- W3C – About W3C Internationalization (i18n), 2025
- Nimdzi Insights – The 2025 Nimdzi 100: Language Services Market Report, 10.04.2025
- Nimdzi Insights – 2025 Language Technology Radar Report, 03.10.2025
- OASIS XLIFF Technical Committee
- ISO 17100:2015 – Translation services – Requirements
Autor
AI Lead w Studiu Gambit. Recenzuje i nadzoruje treści techniczne dotyczące tłumaczenia wspomaganego przez AI, technologii językowych i lokalizacji dla przedsiębiorstw. Odpowiada za firmowe systemy tłumaczenia AI i ich integracje.


