mirror of
https://github.com/AtomUI/AtomUI.git
synced 2026-10-18 14:37:19 +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` 保留原文 并加取代说明，其余结论继续有效。
1.8 KiB
1.8 KiB
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，不实现独立语言状态。