Ajukan pertanyaan Anda dan dapatkan ringkasan dokumen dengan merujuk halaman ini dan penyedia AI pilihan Anda
Riwayat Versi
- "Inisialisasi riwayat"v5.5.1029/6/2025
Konten halaman ini diterjemahkan menggunakan AI.
Lihat versi terakhir dari konten aslinya dalam bahasa InggrisJika Anda memiliki ide untuk meningkatkan dokumentasi ini, silakan berkontribusi dengan mengajukan pull request di GitHub.
Tautan GitHub ke dokumentasiSalin Markdown dokumentasi ke clipboard
Menghasilkan Terjemahan Otomatis dalam Pipeline CI/CD
Intlayer memungkinkan pembuatan terjemahan secara otomatis untuk file deklarasi konten Anda. Ada beberapa cara untuk mencapainya tergantung pada alur kerja Anda.
Daftar Isi
Menggunakan CMS
Dengan Intlayer, Anda dapat mengadopsi alur kerja di mana hanya satu locale yang dideklarasikan secara lokal, sementara semua terjemahan dikelola secara remote melalui CMS. Ini memungkinkan konten dan terjemahan benar-benar terpisah dari codebase, memberikan fleksibilitas lebih bagi editor konten dan memungkinkan Live Sync (tidak perlu membangun ulang aplikasi untuk menerapkan perubahan).
Contoh Konfigurasi
Salin kode ke clipboard
import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = { internationalization: { locales: [Locales.ENGLISH, Locales.SPANISH, Locales.FRENCH], requiredLocales: [Locales.ENGLISH], // Locale opsional akan dikelola secara remote defaultLocale: Locales.ENGLISH, }, editor: { // Kredensial CMS jika Anda menggunakan CMS clientId: process.env.INTLAYER_CLIENT_ID, clientSecret: process.env.INTLAYER_CLIENT_SECRET, liveSync: true, }, ai: { applicationContext: "Ini adalah aplikasi uji", // Membantu memastikan konsistensi dalam pembuatan terjemahan },};export default config;Untuk mempelajari lebih lanjut tentang CMS, lihat dokumentasi resmi.
Menggunakan Husky
Anda dapat mengintegrasikan pembuatan terjemahan ke dalam alur kerja Git lokal Anda menggunakan Husky.
Contoh Konfigurasi
Salin kode ke clipboard
import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = { internationalization: { locales: [Locales.ENGLISH, Locales.SPANISH, Locales.FRENCH], requiredLocales: [Locales.ENGLISH], // Locale opsional ditangani secara remote defaultLocale: Locales.ENGLISH, }, editor: { clientId: process.env.INTLAYER_CLIENT_ID, clientSecret: process.env.INTLAYER_CLIENT_SECRET, }, ai: { provider: "openai", apiKey: process.env.OPENAI_API_KEY, // Gunakan API key Anda sendiri applicationContext: "Ini adalah aplikasi uji", // Membantu memastikan konsistensi dalam pembuatan terjemahan },};export default config;Salin kode ke clipboard
npx intlayer build # Untuk memastikan kamus sudah diperbaruinpx intlayer fill --unpushed --mode fill # Hanya mengisi konten yang hilang, tidak memperbarui yang sudah adaUntuk informasi lebih lanjut tentang perintah Intlayer CLI dan penggunaannya, lihat dokumentasi CLI.
Jika Anda memiliki beberapa aplikasi dalam repo Anda yang menggunakan instance intlayer terpisah, Anda dapat menggunakan argumen --base-dir seperti ini:
Salin kode ke clipboard
# Aplikasi 1npx intlayer build --base-dir ./app1npx intlayer fill --base-dir ./app1 --unpushed --mode fill# Aplikasi 2npx intlayer build --base-dir ./app2npx intlayer fill --base-dir ./app2 --unpushed --mode fillMenggunakan GitHub Actions
Intlayer menyediakan perintah CLI untuk mengisi otomatis dan meninjau konten kamus. Ini dapat diintegrasikan ke dalam alur kerja CI/CD Anda menggunakan GitHub Actions.
Salin kode ke clipboard
name: Intlayer Auto-Fill# Kondisi pemicu untuk workflow inion: pull_request: branches: - "main"permissions: contents: write pull-requests: writeconcurrency: group: "autofill-${{ github.ref }}" cancel-in-progress: truejobs: autofill: runs-on: ubuntu-latest env: # OpenAI AI_MODEL: openai AI_PROVIDER: gpt-5-mini AI_API_KEY: ${{ secrets.AI_API_KEY }} steps: # Langkah 1: Ambil kode terbaru dari repositori - name: ⬇️ Checkout repository uses: actions/checkout@v4 with: persist-credentials: true # Simpan kredensial untuk membuat PR fetch-depth: 0 # Ambil seluruh riwayat git untuk analisis diff # Langkah 2: Siapkan lingkungan Node.js - name: 🟢 Set up Node.js uses: actions/setup-node@v4 with: node-version: 20 # Gunakan Node.js 20 LTS untuk stabilitas # Langkah 3: Instal dependensi proyek - name: 📦 Instal dependensi run: npm install # Langkah 4: Instal Intlayer CLI secara global untuk manajemen terjemahan - name: 📦 Instal Intlayer run: npm install -g intlayer-cli # Langkah 5: Bangun proyek Intlayer untuk menghasilkan file terjemahan - name: ⚙️ Bangun proyek Intlayer run: npx intlayer build # Langkah 6: Gunakan AI untuk mengisi otomatis terjemahan yang hilang - name: 🤖 Isi otomatis terjemahan yang hilang run: npx intlayer fill --git-diff --mode fill --provider $AI_PROVIDER --model $AI_MODEL --api-key $AI_API_KEY # Langkah 7: Periksa jika ada perubahan dan commit perubahan tersebut - name: � Periksa perubahan id: check-changes run: | if [ -n "$(git status --porcelain)" ]; then echo "has-changes=true" >> $GITHUB_OUTPUT else echo "has-changes=false" >> $GITHUB_OUTPUT fi # Langkah 8: Commit dan push perubahan jika ada - name: 📤 Commit dan push perubahan if: steps.check-changes.outputs.has-changes == 'true' run: | git config --local user.email "[email protected]" git config --local user.name "GitHub Action" git add . git commit -m "chore: auto-fill missing translations [skip ci]" git push origin HEAD:${{ github.head_ref }}Untuk mengatur variabel lingkungan, buka GitHub → Settings → Secrets and variables → Actions dan tambahkan secret tersebut.
Sama seperti untuk Husky, dalam kasus monorepo, Anda dapat menggunakan argumen --base-dir untuk memproses setiap aplikasi secara berurutan.
Secara default, argumen--git-diffmemfilter kamus yang mencakup perubahan dari basis (defaultorigin/main) ke cabang saat ini (default:HEAD).
Untuk informasi lebih lanjut tentang perintah Intlayer CLI dan penggunaannya, lihat dokumentasi CLI.