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

# Các lỗi thường gặp

> Khắc phục các lỗi thiết lập, cấu hình, nhà cung cấp và đồng bộ thường gặp.

## `i18n.yml already exists; use --force to overwrite`

Nguyên nhân: đang chạy `init` trong khi cấu hình đã tồn tại.

Sửa lỗi:

```bash theme={null}
hyperlocalise init --force
```

## `storage config is required`

Nguyên nhân: lệnh `sync` được dùng mà không có cấu hình `storage` cấp cao nhất.

Sửa: thêm `storage.adapter` và `storage.config` trong `i18n.yml`.

## `unsupported output format`

Nguyên nhân: giá trị `--output` không đúng.

Bản sửa lỗi:

* `status`: chỉ `csv`
* `sync`: `text` hoặc `json`

## `unsupported file extension` trong `run`

Nguyên nhân: tệp nguồn hoặc tệp đích được ánh xạ sử dụng một phần mở rộng không được trình phân tích cú pháp cục bộ hỗ trợ.

Sửa lỗi:

* chọn một trong: `.json`, `.jsonc`, `.yaml`, `.yml`, `.js`, `.jsx`, `.mjs`, `.cjs`, `.ts`, `.tsx`, `.mts`, `.cts`, `.properties`, `.xml`, `.resx`, `.arb`, `.xlf`, `.xlif`, `.xliff`, `.po`, `.html`, `.liquid`, `.md`, `.mdx`, `.strings`, `.stringsdict`, `.xcstrings`, `.csv`, `.ftl`
* sử dụng một trong các: `.json`, `.jsonc`, `.yaml`, `.yml`, `.properties`, `.xml`, `.resx`, `.arb`, `.xlf`, `.xlif`, `.xliff`, `.po`, `.html`, `.liquid`, `.md`, `.mdx`, `.strings`, `.stringsdict`, `.xcstrings`, `.csv`, `.ftl`

Đối với `.xcstrings`, hãy đảm bảo danh mục có một đối tượng `strings` và либо một bản địa hóa ngôn ngữ nguồn cho các mục biến thể/thay thế hoặc các khóa danh mục đơn giản có thể được dùng làm văn bản nguồn.

## Lỗi xác thực của nhà cung cấp

Nguyên nhân: thiếu/không hợp lệ env token.

Sửa: xuất lại token trong cùng phiên shell và chạy lại.