Terima notifikasi tentang rilis Intlayer yang akan datang
    Dibuat:2025-05-20Terakhir diperbarui:2025-08-13

    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

    intlayer.config.ts
    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

    intlayer.config.ts
    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;
    .husky/pre-push
    npx intlayer build                          # Untuk memastikan kamus sudah diperbaruinpx intlayer fill --unpushed --mode fill    # Hanya mengisi konten yang hilang, tidak memperbarui yang sudah ada
    Untuk 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:
    .husky/pre-push
    # 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 fill

    Menggunakan 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.

    .github/workflows/intlayer-translate.yml
    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 "action@github.com"          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-diff memfilter kamus yang mencakup perubahan dari basis (default origin/main) ke cabang saat ini (default: HEAD).
    Untuk informasi lebih lanjut tentang perintah Intlayer CLI dan penggunaannya, lihat dokumentasi CLI.
    Terima notifikasi tentang rilis Intlayer yang akan datang