Angular Academy · Lekcja

Wyodrębnianie i tłumaczenie komunikatów

Generować i uzupełniać pliki tłumaczeń

Wyodrębnianie i tłumaczenie komunikatów to bezpłatna lekcja Angular Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Angular Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Angular Academy zawiera 4 lekcji w sumie.

Od oznaczonego tekstu do plików tłumaczeń

Po oznaczeniu tekstu za pomocą i18n Angular może zebrać wszystkie komunikaty w pliku źródłowym tłumaczeń. Tłumacze uzupełniają każdy język docelowy, a kompilacja ponownie łączy te tłumaczenia z aplikacją. Ta lekcja obejmuje wyodrębnianie tekstu i format pliku.

Uruchamianie ng extract-i18n

Polecenie CLI ng extract-i18n skanuje aplikację w poszukiwaniu oznaczonych komunikatów i zapisuje plik źródłowy tłumaczeń (domyślnie messages.xlf).

ng extract-i18n
# generates messages.xlf in the project root

Wybór formatu i ścieżki wyjściowej

Możesz wybrać format i miejsce docelowe. XLIFF (xlf) jest formatem domyślnym; obsługiwane są również XLIFF 2 oraz oparty na JSON format arb.

ng extract-i18n --format=xlf2 --output-path=src/locale

Budowa pliku XLF

Każdy oznaczony komunikat staje się elementem trans-unit zawierającym element source (oryginalny tekst) oraz pusty element target, który uzupełnia tłumacz.

<trans-unit id="homeTitle" datatype="html">
  <source>Welcome to our store</source>
  <target></target>
</trans-unit>

Tworzenie plików dla poszczególnych lokalizacji

Skopiuj messages.xlf do osobnego pliku dla każdej lokalizacji docelowej, nadając mu nazwę opartą na kodzie lokalizacji, a następnie przetłumacz elementy docelowe.

src/locale/messages.xlf       # source
src/locale/messages.fr.xlf    # French
src/locale/messages.es.xlf    # Spanish

Uzupełnianie tłumaczeń

Tłumacz zastępuje każdy pusty element target przetłumaczonym tekstem, zachowując ten sam id, aby Angular wiedział, z którym tekstem źródłowym jest on powiązany.

<trans-unit id="homeTitle">
  <source>Welcome to our store</source>
  <target>Bienvenue dans notre boutique</target>
</trans-unit>

Symbole zastępcze muszą zostać zachowane

Interpolacje pojawiają się jako znaczniki symboli zastępczych <x>. Tłumacze muszą je zachować, ale mogą zmienić ich kolejność, aby dopasować ją do gramatyki języka docelowego.

<source>Hello, <x id="INTERPOLATION" equiv-text="{{name}}"/>!</source>
<target>Bonjour, <x id="INTERPOLATION"/> !</target>

Ponowne wyodrębnianie po zmianach

Po dodaniu lub zmianie oznaczonego tekstu ponownie uruchom ng extract-i18n. Niestandardowe identyfikatory @@ zachowują istniejące tłumaczenia; automatycznie generowane identyfikatory mogą się zmienić i wymagać ponownego tłumaczenia.

Konfigurowanie lokalizacji w angular.json

Zarejestruj każdą lokalizację i jej plik tłumaczeń w konfiguracji i18n projektu, aby kompilacja wiedziała, gdzie ich szukać.

"i18n": {
  "sourceLocale": "en",
  "locales": {
    "fr": "src/locale/messages.fr.xlf",
    "es": "src/locale/messages.es.xlf"
  }
}

Obsługa brakujących tłumaczeń

Możesz określić, jak kompilacja ma traktować nieprzetłumaczone komunikaty: error przerywa kompilację, warning zapisuje ostrzeżenie i używa tekstu źródłowego, a ignore nie zgłasza niczego. Używaj error w CI, aby wykrywać braki.

"options": { "i18nMissingTranslation": "error" }

Praca z narzędziami do tłumaczeń

XLIFF jest standardem branżowym, dlatego profesjonalne platformy tłumaczeniowe (oraz narzędzia takie jak Crowdin czy Lokalise) mogą importować wyodrębniony plik i eksportować gotowe tłumaczenia z powrotem w tym samym formacie.

Szybkie sprawdzenie

Co tworzy ng extract-i18n?

Podsumowanie

Uruchom ng extract-i18n, aby zebrać oznaczony tekst w pliku źródłowym XLIFF zawierającym elementy trans-unit. Skopiuj go dla każdej lokalizacji, uzupełnij elementy target, zachowując symbole zastępcze, zarejestruj lokalizacje w angular.json i ustaw i18nMissingTranslation, aby wykrywać braki. Stabilne identyfikatory @@ chronią tłumaczenia podczas edycji.

Często zadawane pytania

Czy lekcja „Wyodrębnianie i tłumaczenie komunikatów” jest bezpłatna?

Tak — pełny tekst „Wyodrębnianie i tłumaczenie komunikatów” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Angular Academy, przejdź na CoddyKit PRO. Kurs Angular Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Wyodrębnianie i tłumaczenie komunikatów”?

Generować i uzupełniać pliki tłumaczeń Ćwiczysz Angular Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Angular Academy?

Nie wymagamy żadnego doświadczenia. Angular Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.

Ile czasu zajmuje lekcja „Wyodrębnianie i tłumaczenie komunikatów”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Angular Academy?

Tak. Każda lekcja Angular Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Angular Academy