Bắt đầu nhanh

Dịch tệp locale đầu tiên của bạn trong 60 giây.

1. Thiết lập tệp locale của bạn

Tạo một tệp locale gốc. Rosetta hỗ trợ JSON, TOML và YAML:

locales/en.json

{
  "hero": {
    "title": "Welcome to our platform",
    "subtitle": "Build something amazing"
  },
  "nav": {
    "home": "Home",
    "about": "About",
    "contact": "Contact"
  }
}

2. Thiết lập API Key của bạn

Chọn một nhà cung cấp và thiết lập key:

# Option A: OpenRouter (200+ models, recommended)
export OPENROUTER_API_KEY=sk-or-v1-...

# Option B: Gemini (free tier — zero cost to start)
export GEMINI_API_KEY=AI...

Nhận Gemini key miễn phí tại aistudio.google.com/apikey. Nhận OpenRouter key tại openrouter.ai.

3. Chạy Sync

npx i18n-rosetta sync

:::tip Sử dụng Gemini? Nếu bạn chọn Option B (Gemini), hãy thêm --method gemini:

npx i18n-rosetta sync --method gemini

:::

Rosetta sẽ:

1. Tự động phát hiện locales/en.json là tệp gốc
2. Tìm (hoặc yêu cầu nhập) các ngôn ngữ đích
3. Dịch tất cả các key
4. Ghi ra locales/fr.json, locales/ja.json, v.v.
5. Tạo .i18n-rosetta.lock để theo dõi những gì đã được dịch

4. Kiểm tra kết quả

cat locales/fr.json

{
  "hero": {
    "title": "Bienvenue sur notre plateforme",
    "subtitle": "Construisez quelque chose d'incroyable"
  },
  "nav": {
    "home": "Accueil",
    "about": "À propos",
    "contact": "Contact"
  }
}

Điều gì xảy ra tiếp theo?

Khi bạn thay đổi một chuỗi gốc, rosetta sẽ phát hiện sự thay đổi thông qua việc theo dõi SHA-256 hash và chỉ dịch lại key đó trong lần sync tiếp theo:

locales/en.json (updated)

{
  "hero": {
    "title": "Welcome to Acme Platform",  // ← changed
    "subtitle": "Build something amazing"  // ← unchanged, skipped
  }
}

npx i18n-rosetta sync
# Only "hero.title" is re-translated across all locales

Tùy chọn: Tạo tệp Config

Để kiểm soát nhiều hơn, hãy tạo một tệp config:

npx i18n-rosetta init                         # guided wizard
npx i18n-rosetta init --yes --langs fr,de,ja  # quick setup with specific targets

Trình hướng dẫn sẽ đưa bạn qua các register presets của từng ngôn ngữ — các hướng dẫn về giọng điệu/mức độ trang trọng được xây dựng sẵn và tinh chỉnh cho hệ thống ngôn ngữ đó. Tiếng Pháp có các preset T-V (vouvoiement vs tutoiement), tiếng Hàn có các mức độ giao tiếp (해요체 vs 합쇼체 vs 해체), tiếng Nhật có các tùy chọn keigo (です/ます vs 丁寧語).

Hoặc tạo một config thủ công với các preset key:

i18n-rosetta.config.json

{
  "version": 3,
  "inputLocale": "en",
  "localesDir": "./locales",
  "languages": {
    "fr": "casual-tu",
    "ko": "polite-haeyo",
    "ja": "polite"
  },
  "model": "google/gemini-2.5-flash"
}

Chạy npx i18n-rosetta init để duyệt qua các preset có sẵn cho từng ngôn ngữ.

Tùy chọn: Watch Mode

Tự động dịch khi tệp gốc của bạn thay đổi:

npx i18n-rosetta watch

Các bước tiếp theo

• Cấu hình — Tài liệu tham khảo đầy đủ về config
• Phương pháp dịch — Chọn phương pháp phù hợp
• Tích hợp Framework — Hugo, next-intl, react-i18next
• CI/CD — Tự động hóa việc dịch thuật trong pipeline của bạn