Chuyển đến nội dung chính

​
Tổng quan về tệp

i18n.jsonc kiểm soát ngôn ngữ địa phương, ánh xạ tệp, hồ sơ mô hình và lựa chọn quy tắc.

​
Các ngôn ngữ vùng

  • locales.source: ngôn ngữ nguồn.
  • locales.targets: danh sách các địa phương mục tiêu.
  • tùy chọn locales.fallbacks: thứ tự dự phòng theo từng ngôn ngữ địa phương.

​
Xô

buckets ánh xạ các tệp nguồn đến các mẫu đầu ra mục tiêu. Mỗi ánh xạ tệp sử dụng:
  • from: mẫu đường dẫn nguồn
  • to: mẫu đường dẫn đích
Sử dụng {{source}}, {{target}}, và {{localeDir}} trong các mẫu. {{localeDir}} kết quả là một đoạn trống khi mục tiêu bằng nguồn, và là ngôn ngữ mục tiêu trong các trường hợp khác.

​
Mẫu ánh xạ file CSV

Sử dụng ánh xạ tệp bucket để mô hình hóa quy trình làm việc CSV. Mỗi-các tập tin ngôn ngữ: 
{
  "from": "translations/en.csv",
  "to": "translations/[locale].csv"
}
Chia sẻ đa dạng-tệp ngôn ngữ: 
{
  "from": "translations/catalog.csv",
  "to": "translations/catalog.csv"
}
Cho nhiều người dùng chia sẻ-các tệp CSV địa phương, giữ lại một cột khóa và một cột địa phương mục tiêu mà run có thể cập nhật một cách nhất quán.

​
Nhóm

groups.<name> xác định những gì cần xử lý cùng nhau.
  • targets: tập con của locales.targets
  • buckets: danh sách tên các bucket

​
Hồ sơ LLM

llm.profiles.<name> trường:
  • provider: openai, azure_openai, anthropic, gemini, bedrock, lmstudio, groq, hoặc ollama
  • model: id mô hình nhà cung cấp
  • prompt: mẫu nhắc dịch
Biến số nhắc nhở:
  • {{source}}
  • {{target}}
  • {{input}}

​
Quy tắc

llm.rules chọn hồ sơ cho mỗi nhóm.
  • priority: cao hơn thắng
  • group: tên nhóm
  • profile: tên hồ sơ

​
Cấu hình khởi động

hyperlocalise init
Sau đó chỉnh sửa phần đã tạo ra i18n.jsonc cho dự án của bạn.

​
Mẹo xác thực

  • Giữ mục tiêu nhóm bên trong locales.targets.
  • Giữ các nhóm bucket thẳng hàng với buckets phím.
  • Giữ tên hồ sơ nhất quán giữa profiles và rules.