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

​
Mục tiêu

Tạo một i18n.yml, chạy lập kế hoạch dịch thuật một cách an toàn, tạo đầu ra và xem lại trạng thái.

​
1. Khởi tạo cấu hình

hyperlocalise init
Điều này sẽ ghi i18n.yml vào thư mục hiện tại của bạn.

​
2. Cấu hình thông tin xác thực nhà cung cấp

hyperlocalise tự động đọc thông tin xác thực từ .env và .env.local trong thư mục dự án hiện tại của bạn. Các biến shell đã xuất vẫn được ưu tiên. Ví dụ: 
export OPENAI_API_KEY="your-openai-api-key"
OpenAI: 
export OPENAI_API_KEY="your-openai-api-key"
Azure OpenAI: 
# Example: https://<resource>.openai.azure.com/openai/v1
export AZURE_OPENAI_BASE_URL="https://<resource>.openai.azure.com/openai/v1"
export AZURE_OPENAI_API_KEY="your-azure-openai-api-key"
Gemini: 
export GEMINI_BASE_URL="https://generativelanguage.googleapis.com/v1beta/openai"
export GEMINI_API_KEY="your-gemini-api-key"
Anthropic: 
export ANTHROPIC_BASE_URL="https://api.anthropic.com/v1"
export ANTHROPIC_API_KEY="your-anthropic-api-key"
LM Studio: 
export LM_STUDIO_BASE_URL="http://127.0.0.1:1234/v1"
export LM_STUDIO_API_KEY="lm-studio"
Ollama: 
export OLLAMA_BASE_URL="http://127.0.0.1:11434/v1"
export OLLAMA_API_KEY="ollama"
Groq: 
export GROQ_BASE_URL="https://api.groq.com/openai/v1"
export GROQ_API_KEY="your-groq-api-key"

​
3. Chạy thử trước

hyperlocalise run --dry-run
Kiểm tra planned_total, executable_total, và tasks đã được liệt kê.

​
4. Thực hiện tạo

hyperlocalise run
Bản này ghi các bản dịch và cập nhật .hyperlocalise.lock.json. Để biết chi tiết, xem Hợp đồng lockfile.

​
5. Trạng thái xem xét

hyperlocalise status --output csv
Sử dụng needs_review hàng để xác định các mục vẫn cần con người biên tập.

​
6. Đánh giá chất lượng bản dịch khi cần thiết

hyperlocalise eval run --eval-set ./eval-set.json --output ./eval-report.json
Dùng điều này khi so sánh các lựa chọn prompt/profile/provider hoặc trước khi triển khai các bản cập nhật dịch lớn.

​
Tiếp theo

  • Tinh chỉnh cấu hình trong i18n config.
  • Đồng bộ với TMS của bạn bằng sync push và sync pull.
  • Kiểm tra kỳ vọng về mức độ trưởng thành trong ma trận ổn định](/reference/stability-matrix).