Angular Academy · Pelajaran

Mengekstrak dan Menerjemahkan Pesan

Buat dan isi file terjemahan.

Mengekstrak dan Menerjemahkan Pesan adalah pelajaran Angular Academy gratis di CoddyKit. Ini adalah pelajaran 2 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Angular Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Angular Academy mencakup 4 pelajaran total.

Dari Teks yang Ditandai ke Berkas Terjemahan

Setelah teks ditandai dengan i18n, Angular dapat mengumpulkan setiap pesan ke dalam berkas sumber terjemahan. Penerjemah mengisi setiap bahasa target, lalu proses build menggabungkan terjemahan tersebut kembali. Pelajaran ini membahas ekstraksi dan format berkas.

Menjalankan ng extract-i18n

Perintah CLI ng extract-i18n memindai aplikasi Anda untuk mencari pesan yang ditandai dan menulis berkas sumber terjemahan (secara default messages.xlf).

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

Memilih Format dan Lokasi Keluaran

Anda dapat memilih format dan tujuan penyimpanannya. XLIFF (xlf) adalah format default; XLIFF 2 dan arb berbasis JSON juga didukung.

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

Struktur Berkas XLF

Setiap pesan yang ditandai menjadi sebuah trans-unit dengan source (teks asli Anda) dan target kosong yang akan diisi penerjemah.

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

Membuat Berkas untuk Setiap Lokal

Salin messages.xlf menjadi satu berkas untuk setiap lokal target, beri nama berdasarkan kode lokal, lalu terjemahkan targetnya.

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

Mengisi Terjemahan

Penerjemah mengganti setiap target kosong dengan teks yang dilokalkan, sambil mempertahankan id yang sama agar Angular mengetahui sumber yang sesuai.

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

Placeholder Harus Dipertahankan

Interpolasi muncul sebagai tag placeholder <x>. Penerjemah harus mempertahankannya, tetapi boleh mengubah urutannya agar sesuai dengan tata bahasa bahasa target.

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

Mengekstrak Ulang Setelah Perubahan

Saat Anda menambahkan atau mengubah teks yang ditandai, jalankan kembali ng extract-i18n. ID kustom @@ mempertahankan terjemahan yang sudah ada; ID yang dibuat otomatis dapat berubah dan memerlukan penerjemahan ulang.

Mengonfigurasi Lokal dalam angular.json

Daftarkan setiap lokal beserta berkas terjemahannya di bawah konfigurasi i18n proyek agar build mengetahui lokasi berkas tersebut.

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

Menangani Terjemahan yang Hilang

Anda dapat menentukan cara build menangani pesan yang belum diterjemahkan: error menggagalkan build, warning mencatat log dan menggunakan teks sumber, sedangkan ignore tidak melakukan apa-apa. Gunakan error di CI untuk mendeteksi bagian yang belum diterjemahkan.

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

Menggunakan Alat Terjemahan

XLIFF merupakan standar industri, sehingga platform penerjemahan profesional (dan alat seperti Crowdin atau Lokalise) dapat mengimpor berkas hasil ekstraksi dan mengekspor terjemahan yang sudah selesai kembali dalam format yang sama.

Pemeriksaan Cepat

Apa yang dihasilkan oleh ng extract-i18n?

Ringkasan

Jalankan ng extract-i18n untuk mengumpulkan teks yang ditandai ke dalam berkas sumber XLIFF yang berisi trans-unit. Salin berkas tersebut untuk setiap lokal, isi target sambil mempertahankan placeholder, daftarkan lokal di angular.json, dan tetapkan i18nMissingTranslation untuk mendeteksi bagian yang belum diterjemahkan. ID @@ yang stabil melindungi terjemahan saat teks diedit.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Mengekstrak dan Menerjemahkan Pesan” gratis?

Ya — teks lengkap “Mengekstrak dan Menerjemahkan Pesan” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Angular Academy, upgrade ke CoddyKit PRO. Kursus Angular Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Mengekstrak dan Menerjemahkan Pesan”?

Buat dan isi file terjemahan. Kamu berlatih Angular Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Angular Academy?

Tidak diperlukan pengalaman sebelumnya. Angular Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 2 dari 4.

Berapa lama pelajaran “Mengekstrak dan Menerjemahkan Pesan” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Angular Academy ini?

Ya. Setiap pelajaran Angular Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke Angular Academy