Isi / audit / terjemahkan kamus

npx intlayer fill

Perintah ini menganalisis file deklarasi konten Anda untuk potensi masalah seperti terjemahan yang hilang, ketidakkonsistenan struktural, atau ketidakcocokan tipe. Jika ditemukan masalah, intlayer fill akan mengusulkan atau menerapkan pembaruan untuk menjaga kamus Anda tetap konsisten dan lengkap.

Poin-poin penting:

• Membagi file JSON besar menjadi potongan-potongan untuk tetap berada dalam batas jendela konteks model AI.
• Mencoba ulang terjemahan jika format output tidak benar.
• Menggabungkan konteks spesifik aplikasi dan file untuk meningkatkan akurasi terjemahan.
• Mempertahankan terjemahan yang ada dengan tidak menimpa mereka.
• Memproses file, potongan, dan locale secara paralel menggunakan sistem antrian untuk meningkatkan kecepatan.

Alias:

• npx intlayer dictionaries fill
• npx intlayer dictionary fill
• npx intlayer dic fill

Contoh output:

npx intlayer fillPreparing Intlayer (v7.5.14)Done 76ms@intlayer/ai found - Run process locallyProvider: (default) - Model: (default) - API Key: ✓Affected dictionary keys for processing: app, comp-test, hello-world, lang-switcher - [comp-test]      No locales to fill, Skipping comp-test.content.json - [app]            Processing app.content.tsx - [app]            Filling missing metadata for app.content.tsx - [hello-world]    Processing test.content.ts - [hello-world]   [French (fr)]      Preparing test.content.ts - [hello-world]   [Spanish (es)]     Preparing test.content.ts - [lang-switcher]  Processing langSwitcher.content.ts - [lang-switcher]  Filling missing metadata for langSwitcher.content.ts - [hello-world]    Translation completed successfully for test.content.ts - [lang-switcher] [Spanish (es)]     Preparing langSwitcher.content.ts - [app]           [French (fr)]      Preparing app.content.tsx - [app]           [Spanish (es)]     Preparing app.content.tsx - [hello-world]    Content declaration written to test.content.ts - [app]            Translation completed successfully for app.content.tsx - [app]            Content declaration written to app.content.tsx - [lang-switcher]  Translation completed successfully for langSwitcher.content.ts - [lang-switcher]  Content declaration written to langSwitcher.content.ts

Argumen:

Opsi daftar file:

• -f, --file [files...]: Daftar file deklarasi konten spesifik untuk diaudit. Jika tidak diberikan, semua file *.content.{ts,js,mjs,cjs,tsx,jsx,json} yang ditemukan berdasarkan pengaturan file konfigurasi Anda akan diaudit.

  Contoh: npx intlayer dictionary fill -f src/home/app.content.ts

• -k, --keys [keys...]: Memfilter kamus berdasarkan kunci. Jika tidak diberikan, semua kamus akan diaudit.

  Contoh: npx intlayer dictionary fill -k key1 key2

• --key [keys...]: Memfilter kamus berdasarkan kunci (alias dari --keys).

  Contoh: npx intlayer dictionary fill --key key1 key2

• --excluded-keys [excludedKeys...]: Memfilter kamus dengan mengecualikan berdasarkan kunci. Jika tidak diberikan, semua kamus akan diaudit.

  Contoh: npx intlayer dictionary fill --excluded-keys key1 key2

• --excluded-key [excludedKeys...]: Memfilter kamus dengan mengecualikan berdasarkan kunci (alias dari --excluded-keys).

  Contoh: npx intlayer dictionary fill --excluded-key key1 key2

• --path-filter [pathFilters...]: Memfilter kamus berdasarkan pola glob untuk jalur file.

  Contoh: npx intlayer dictionary fill --path-filter "src/home/**"

Opsi output entri:

• --source-locale [sourceLocale]: Locale sumber untuk diterjemahkan. Jika tidak ditentukan, locale default dari konfigurasi Anda akan digunakan.

• --output-locales [outputLocales...]: Locale target untuk diterjemahkan. Jika tidak ditentukan, semua locale dari konfigurasi Anda akan digunakan kecuali locale sumber.

• --mode [mode]: Mode terjemahan: complete, review. Default adalah complete. complete akan mengisi semua konten yang hilang, review akan mengisi konten yang hilang dan meninjau kunci yang sudah ada.

Opsi Git:

• --git-diff: Hanya jalankan pada kamus yang mencakup perubahan dari basis (default origin/main) ke cabang saat ini (default: HEAD).
• --git-diff-base: Tentukan referensi basis untuk git diff (default origin/main).
• --git-diff-current: Tentukan referensi saat ini untuk git diff (default: HEAD).
• --uncommitted: Sertakan perubahan yang belum dikomit.
• --unpushed: Sertakan perubahan yang belum dipush.

• --untracked: Sertakan file yang tidak terlacak.

  Contoh: npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD

  Contoh: npx intlayer doc translate --uncommitted --unpushed --untracked

Opsi AI:

• --model [model]: Model AI yang digunakan untuk terjemahan (misalnya, gpt-3.5-turbo).
• --provider [provider]: Penyedia AI yang digunakan untuk terjemahan.
• --temperature [temperature]: Pengaturan temperature untuk model AI.
• --api-key [apiKey]: Berikan API key Anda sendiri untuk layanan AI.
• --custom-prompt [prompt]: Berikan prompt khusus untuk instruksi terjemahan Anda.
• --application-context [applicationContext]: Berikan konteks tambahan untuk terjemahan AI.

• --data-serialization [dataSerialization]: Format serialisasi data yang digunakan untuk fitur AI Intlayer. Opsi: json (standar, andal), toon (lebih sedikit token, kurang konsisten).

  Contoh: npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "Aplikasi saya adalah toko kucing"

  Opsi variabel lingkungan:

• --env: Tentukan lingkungan (misalnya, development, production).

• --env-file [envFile]: Berikan file lingkungan khusus untuk memuat variabel dari file tersebut.

  Contoh: npx intlayer fill --env-file .env.production.local

  Contoh: npx intlayer fill --env production

Opsi konfigurasi:

• --base-dir: Tentukan direktori dasar untuk proyek.

  Contoh: npx intlayer fill --base-dir ./src

• --no-cache: Nonaktifkan cache.

  Contoh: npx intlayer build --no-cache

Opsi persiapan:

• --build: Bangun kamus sebelum melakukan push untuk memastikan konten terbaru. True akan memaksa build, false akan melewati build, undefined akan mengizinkan penggunaan cache dari build.

• --skip-metadata: Lewati pengisian metadata yang hilang (deskripsi, judul, tag) untuk kamus.

Opsi log:

• --verbose: Aktifkan logging verbose untuk debugging. (default true saat menggunakan CLI)

Contoh:

npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo

Perintah ini akan menerjemahkan konten dari bahasa Inggris ke bahasa Prancis dan Spanyol untuk semua file deklarasi konten di direktori src/home/ menggunakan model GPT-3.5 Turbo.