快速开始

此站点是一个面向 awesome-design-md 上游目录的静态 Astro 画廊壳层。英文保持无前缀默认路由，站点壳层已扩展到与 HagiCode Desktop 一致的语言范围。

已包含

• Astro 6 静态输出与少量 React islands 交互控件。
• 与 Desktop 对齐的路由前缀：zh-CN、zh-Hant、ja-JP、ko-KR、de-DE、fr-FR、es-ES、pt-BR、ru-RU。
• 位于 src/i18n/locales 的 hagi18n YAML 源文件，以及位于 src/i18n/generated 的运行时生成资源。
• vendor/awesome-design-md 下的上游画廊内容仍然属于内容源，不进入 hagi18n UI 源树。

i18n 维护流程

• 在 src/i18n/locales/<locale>/*.yml 中维护第一方 UI 文案与语言元数据。
• 生成运行时资源前，先运行 npm run i18n:audit 或 npm run i18n:doctor。
• 通过 npm run i18n:generate 刷新 src/i18n/generated/site-locale-resources.ts。
• 通过 npm run i18n:check 串联 audit、doctor、生成与资源陈旧校验。

壳层样式来源

• 运行时页头与壳层样式应修改 public/global.css，因为 BaseLayout.astro 直接链接 /global.css。
• 除非布局导入路径发生变化，否则将 src/styles/global.css 视为参考副本。

建议先做

• 修改 YAML 语言源，而不是回到手写 localeCopy 对象。
• 生产构建前先把 SITE_URL 指向真实部署域名。
• 按需调整 src/components 与 src/pages 中的画廊壳层结构。
• YAML 变更后同步提交生成后的运行时资源。

命令

npm install
git submodule update --init --recursive
npm run i18n:check
npm run test
npm run typecheck
SITE_URL=https://your-domain.example npm run build