Maofeng
49 lines
1.3 KiB
Plaintext
49 lines
1.3 KiB
Plaintext
---
|
||
title: 项目配置
|
||
description: 创建应用配置并接入 Vite 插件。
|
||
order: 10
|
||
toc:
|
||
- id: configuration
|
||
title: 配置文件
|
||
- id: catalog-sources
|
||
title: 词典来源
|
||
- id: vite-plugin
|
||
title: Vite 插件
|
||
---
|
||
|
||
## 配置文件 {#configuration}
|
||
|
||
在使用方应用中创建 `i18n.config.json`：
|
||
|
||
```json
|
||
{
|
||
"sourceLocale": "en-US",
|
||
"locales": ["en-US", "zh-Hans"],
|
||
"catalogPath": "src/locales/{locale}/messages",
|
||
"catalogSources": ["@workspace/ui/locales/{locale}"],
|
||
"include": ["src", "../../packages/ui/src"],
|
||
"exclude": ["**/*.test.{ts,tsx}"]
|
||
}
|
||
```
|
||
|
||
该文件是应用唯一的持久国际化配置。CLI 命令只为子进程创建临时 Lingui 配置。
|
||
|
||
工作区只提供简体中文（`zh-Hans`）和美式英语（`en-US`）。应用词典和包词典来源应使用相同的语言键。
|
||
|
||
## 词典来源 {#catalog-sources}
|
||
|
||
词典来源按从左到右的顺序合并，应用词典始终位于最后。将可复用包词典放在前面，使产品特有翻译可以覆盖它们。
|
||
|
||
## Vite 插件 {#vite-plugin}
|
||
|
||
```ts
|
||
import { i18n } from "@workspace/i18n/vite"
|
||
import { defineConfig } from "vite"
|
||
|
||
export default defineConfig({
|
||
plugins: [i18n()],
|
||
})
|
||
```
|
||
|
||
插件会提供开发词典 API，并通过 `@workspace/i18n/catalogs` 暴露生成的加载器。
|