Ekstensi VS Code Resmi

Ikhtisar

Intlayer adalah ekstensi resmi Visual Studio Code untuk Intlayer, yang dirancang untuk meningkatkan pengalaman pengembang saat bekerja dengan konten yang dilokalisasi dalam proyek Anda.

Tautan ekstensi: https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension

Fitur

• Navigasi Instan – Melompat dengan cepat ke file konten yang benar saat mengklik kunci useIntlayer.
• Isi Kamus – Mengisi kamus dengan konten dari proyek Anda.

• Akses Mudah ke Perintah Intlayer – Membangun, mendorong, menarik, mengisi, menguji kamus konten dengan mudah.

• Generator Deklarasi Konten – Membuat file konten kamus dalam berbagai format (.ts, .esm, .cjs, .json).

• Uji Kamus – Uji kamus untuk terjemahan yang hilang.

• Perbarui kamus Anda – Perbarui kamus Anda dengan konten terbaru dari proyek Anda.

• Tab Intlayer (Activity Bar) – Jelajahi dan cari kamus dari tab samping khusus dengan toolbar dan aksi konteks (Build, Pull, Push, Fill, Refresh, Test, Create File).

Penggunaan

Navigasi Cepat

1. Buka proyek yang menggunakan react-intlayer.

2. Temukan pemanggilan useIntlayer(), seperti:

   const content = useIntlayer("app");

3. Command-click (⌘+Click di macOS) atau Ctrl+Click (di Windows/Linux) pada kunci (misalnya, "app").
4. VS Code akan secara otomatis membuka file kamus yang sesuai, misalnya, src/app.content.ts.

Tab Intlayer (Activity Bar)

Gunakan tab samping untuk menjelajahi dan mengelola kamus:

• Buka ikon Intlayer di Activity Bar.
• Di Search, ketik untuk memfilter kamus dan entri secara real time.
• Di Dictionaries, jelajahi environment, kamus, dan file. Gunakan toolbar untuk Build, Pull, Push, Fill, Refresh, Test, dan Create Dictionary File. Klik kanan untuk aksi konteks (Pull/Push pada kamus, Fill pada file). File editor saat ini akan otomatis terlihat di pohon saat berlaku.

Mengakses perintah

Anda dapat mengakses perintah dari Command Palette.

Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)

• Build Dictionaries
• Push Dictionaries
• Pull Dictionaries
• Fill Dictionaries
• Test Dictionaries
• Create Dictionary File

Memuat Variabel Lingkungan

Intlayer menyarankan untuk menyimpan kunci API AI Anda, serta client ID dan secret Intlayer dalam variabel lingkungan.

Ekstensi dapat memuat variabel lingkungan dari workspace Anda untuk menjalankan perintah Intlayer dengan konteks yang benar.

• Urutan pemuatan (berdasarkan prioritas): .env.<env>.local → .env.<env> → .env.local → .env
• Non-destruktif: nilai process.env yang sudah ada tidak akan ditimpa.
• Lingkup: file diselesaikan dari direktori dasar yang dikonfigurasi (default ke root workspace).

Memilih environment aktif

• Command Palette: buka palette dan jalankan Intlayer: Select Environment, lalu pilih environment (misalnya, development, staging, production). Ekstensi akan mencoba memuat file pertama yang tersedia dalam daftar prioritas di atas dan menampilkan notifikasi seperti “Loaded env from .env..local”.
• Settings: buka Settings → Extensions → Intlayer, dan atur:
  • Environment: nama environment yang digunakan untuk menyelesaikan file .env.<env>*.
  • (Opsional) Env File: jalur eksplisit ke file .env. Jika disediakan, ini akan memiliki prioritas lebih tinggi daripada daftar yang diinferensikan.

Monorepos dan direktori kustom

Jika file .env Anda berada di luar root workspace, atur Base Directory di Settings → Extensions → Intlayer. Loader akan mencari file .env relatif terhadap direktori tersebut.