mirror of
https://github.com/AtomUI/AtomUI.git
synced 2026-10-27 04:09:37 +08:00
chinboy
9f6ec36645
统一文档目录的入口文件名为 `overview.md`，取代原先的 `index.md`。单 Control 目录本来就用 `overview.md`，此前只有目录级入口用 `index.md`，两套命名并存；现在全库一致。 改名覆盖 42 个入口文件：`docs/` 根、一级分类目录、Architecture 分组与跨模块系统目录、Module 目录、Control 平台与分类目录、Guide 与 Reference 子目录。`docs/AI/generated/index.md` 是手工 维护的导航页，一并改名。 生成产物 `docs/AI/generated/llms/**/index-cn.md` 保持原名，它属于 LLMs Generator 的输出契约。 同步更新 28 个正式文档与 `AGENTS.md` 中的入站链接，以及两处目录树示意图。改名后全部相对链接 可解析，LLMs Generator `verify` 通过（78 控件 / 159 文件），单 Control 四件套文件名契约未变。 新增 `docs/engineering/contributing/documentation-structure-guidelines.md` 承载入口命名、文档 拆分标准、事实所有权和链接规范。此前该规则只写在带日期的设计过程记录里，不适合作为长期来源。 `docs/superpowers/specs/2026-08-10-documentation-information-architecture-design.md` 保留原文 并加取代说明，其余结论继续有效。
38 lines
1.8 KiB
Markdown
38 lines
1.8 KiB
Markdown
# AtomUI.Localization 模块
|
|
|
|
`AtomUI.Localization` 是 AtomUI 的应用级本地化运行时项目。它提供语言身份、Catalog registry、不可变 Snapshot、
|
|
LanguageManager、Localizer 和 Avalonia 动态资源桥，不拥有 XLIFF 构建、语言包打包或主题状态。
|
|
|
|
## 职责
|
|
|
|
- 定义 `LanguageTag`、`LanguageDefinition`、`LanguageState` 和 `LanguageSnapshot`。
|
|
- 注册编译期生成的 Catalog 与 Translation Bundle descriptor。
|
|
- 构建并原子发布当前语言的完整资源快照。
|
|
- 提供 `ILanguageManager`、`ILocalizer` 和 XAML 资源扩展运行时。
|
|
- 管理 Culture、FlowDirection、回退和资源 Provider 生命周期。
|
|
|
|
## 源码目录
|
|
|
|
| 目录 | 职责 |
|
|
| --- | --- |
|
|
| `Catalog/` | Catalog schema、descriptor 和 registry |
|
|
| `Resources/` | Avalonia resource extension、provider 和 resource key |
|
|
| `Services/` | bootstrap、builder、host、manager、localizer 和日志入口 |
|
|
| `LanguageData/` | LanguageTags Generator 的固定数据输入 |
|
|
| 项目根目录 | language identity、definition、state、snapshot 和回退模型 |
|
|
|
|
## 对外关系
|
|
|
|
- `AtomUI.Core` 引用本模块并在根 Builder 中暴露本地化配置入口。
|
|
- `AtomUI.Generator` 生成 Catalog、Bundle、模块注册和应用 bootstrap。
|
|
- `AtomUI.Build.Tasks` 负责静态语言包文件与打包副作用。
|
|
- Control 包只注册自身 Catalog 和内置 Bundle，不实现独立语言状态。
|
|
|
|
## 相关文档
|
|
|
|
- [本地化系统架构](../../architecture/systems/localization/overview.md)
|
|
- [本地化运行时架构](../../architecture/systems/localization/runtime.md)
|
|
- [本地化生成与构建](../../architecture/systems/localization/generation-and-build.md)
|
|
- [公共 API](../../reference/localization/public-api.md)
|
|
- [Catalog 与 XLIFF](../../reference/localization/catalog-and-xliff.md)
|