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

# Mẫu đường dẫn

> Sử dụng các placeholder nguồn và đích một cách an toàn trong ánh xạ tệp bucket.

## Các trình giữ chỗ được hỗ trợ

* `{{source}}`: ngôn ngữ nguồn
* `{{target}}`: ngôn ngữ mục tiêu
* `{{localeDir}}`: để trống đối với đầu ra ngôn ngữ nguồn, nếu không thì ngôn ngữ đích

## Các ví dụ

### Các tệp ngôn ngữ JSON

```jsonc theme={null}
{
  "from": "packages/ui/lang/{{source}}.json",
  "to": "apps/web/lang/{{target}}.json"
}
```

### Mẫu ngôn ngữ với token `[locale]`

```jsonc theme={null}
{
  "from": "lang/en.json",
  "to": "lang/[locale].json"
}
```

### Ánh xạ đệ quy Mintlify với globs

```jsonc theme={null}
{
  "from": "docs/**/*.mdx",
  "to": "docs/{{localeDir}}/**/*.mdx"
}
```

Điều này giữ nguyên cấu trúc tệp nguồn và ghi các tệp đã dịch vào cùng các đường dẫn tương đối trong mỗi thư mục ngôn ngữ.

Với `source=en` và các mục tiêu `fr`, `es`, và `zh`:

* `target=en` phân giải `docs/{{localeDir}}/index.mdx` thành `docs/index.mdx`
* `target=fr` phân giải `docs/{{localeDir}}/index.mdx` thành `docs/fr/index.mdx`
* `target=es` phân giải `docs/{{localeDir}}/index.mdx` thành `docs/es/index.mdx`
* `target=zh` phân giải `docs/{{localeDir}}/index.mdx` thành `docs/zh/index.mdx`

Sử dụng mẫu này khi các trang nguồn tiếng Anh của bạn nằm trực tiếp dưới `docs/` và các trang đã dịch nên được ghi vào các thư mục theo ngôn ngữ.

## Các mẫu tốt

* Giữ cây nguồn và cây đích riêng biệt.
* Sử dụng tên bucket ổn định theo miền (`ui`, `marketing`, `emails`).
* Giữ một trách nhiệm cho mỗi ánh xạ tệp.

## Các phản mẫu

* Đang ghi các đường dẫn `to` trở lại các thư mục nguồn.
* Tái sử dụng cùng một đường dẫn đầu ra cho nhiều bucket.
* Trộn các mã định danh locale với thay thế chuỗi thủ công bên ngoài các mẫu.

## Kiểm tra nhanh

Trước khi chạy:

1. xác nhận `from` được phân giải cho ngôn ngữ nguồn,
2. xác nhận `to` có thể được tạo cho mỗi ngôn ngữ đích,
3. chạy `hyperlocalise run --dry-run` để kiểm tra các tác vụ đã lên kế hoạch.