> ## Documentation Index
> Fetch the complete documentation index at: https://hyperlocalise.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Lược đồ cấu hình

> Tham chiếu ngắn gọn cho schema cấu hình i18n của hyperlocalise.

## Các khóa cấp cao nhất

* `locales`
* `buckets`
* `groups`
* `llm`
* `storage` (bắt buộc cho `sync`)
* `cache` (tùy chọn)

## `locales`

* `source` (chuỗi, bắt buộc)
* `targets` (mảng chuỗi, bắt buộc)
* `fallbacks` (đối tượng, không bắt buộc)

## `buckets`

* bản đồ từ tên bucket -> định nghĩa bucket
* `files` mảng với `from` và `to` mẫu

## `groups`

* bản đồ tên nhóm -> định nghĩa nhóm
* `targets` mảng
* `buckets` mảng

## `llm`

* `profiles` bản đồ tên hồ sơ -> nhà cung cấp/mô hình/prompt
* đối tượng tùy chọn `context_memory` với `provider` và `model` để ghi đè xây dựng ngữ cảnh
* các nhà cung cấp được hỗ trợ: `openai` | `azure_openai` | `anthropic` | `gemini` | `bedrock` | `lmstudio` | `groq` | `mistral` | `ollama`
* mảng với `rules`, `priority`, `group`, `profile`

## `storage`

* `adapter`: `poeditor` | `lilt` | `lokalise` | `crowdin` | `phrase` | `smartling`
* `config`: các trường dành riêng cho bộ chuyển đổi

## `cache`

* `enabled` boolean
* `endpoint` chuỗi
* `project_key_env` chuỗi
* `timeout_seconds` số nguyên

Để xem các ví dụ, hãy xem [i18n config](/configuration/i18n-config).

## Ghi chú quy trình CSV

Dùng `buckets.*.files[].from` và `to` để trỏ đến các tệp `.csv` khi bạn chạy các luồng bản địa hóa dựa trên CSV.

* Các tệp theo từng ngôn ngữ thường sử dụng `[locale]` trong đường dẫn `to`.
* Các tệp CSV được chia sẻ có thể tái sử dụng cùng đường dẫn `from` và `to`.

## Ghi chú quy trình làm việc Fluent

Sử dụng `buckets.*.files[].from` và `to` để trỏ tới các tệp `.ftl` cho các luồng bản địa hóa Mozilla Fluent.

* Các tệp theo từng ngôn ngữ thường sử dụng `[locale]` trong đường dẫn `to`, ví dụ `locales/[locale]/messages.ftl`.
* Các mục được hỗ trợ bao gồm thông báo, thuộc tính, giá trị nhiều dòng và các mẫu select/plural được biểu diễn dưới dạng giá trị đầy đủ.
* Các thuật ngữ Fluent không được hỗ trợ và sẽ không phân tích được thay vì được viết lại.

## Ghi chú quy trình thuộc tính Java

Sử dụng `buckets.*.files[].from` và `to` để trỏ tới các gói tài nguyên `.properties` theo từng ngôn ngữ, ví dụ `messages_{{source}}.properties` -> `messages_{{target}}.properties`.