Bắt đầu nhanh

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_API_KEY="your-openai-api-key"

OpenAI:

export OPENAI_API_KEY="your-openai-api-key"

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"

# Example: https://<resource>.openai.azure.com/openai/v1
AZURE_OPENAI_BASE_URL="https://<resource>.openai.azure.com/openai/v1"
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"

GEMINI_BASE_URL="https://generativelanguage.googleapis.com/v1beta/openai"
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"

ANTHROPIC_BASE_URL="https://api.anthropic.com/v1"
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"

LM_STUDIO_BASE_URL="http://127.0.0.1:1234/v1"
LM_STUDIO_API_KEY="lm-studio"

Ollama:

export OLLAMA_BASE_URL="http://127.0.0.1:11434/v1"
export OLLAMA_API_KEY="ollama"

OLLAMA_BASE_URL="http://127.0.0.1:11434/v1"
OLLAMA_API_KEY="ollama"

Groq:

export GROQ_BASE_URL="https://api.groq.com/openai/v1"
export GROQ_API_KEY="your-groq-api-key"

GROQ_BASE_URL="https://api.groq.com/openai/v1"
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.

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).

Getting Started

Configuration

Commands

Workflows

Providers

TMS Adapters

Troubleshooting

Reference & Concepts

Contributing

Mục tiêu

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

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

3. Chạy thử trước

4. Thực hiện tạo

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

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

Tiếp theo

​Mục tiêu

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

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

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

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

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

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

​Tiếp theo

Mục tiêu

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

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

3. Chạy thử trước

4. Thực hiện tạo

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

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

Tiếp theo