Astro Narrow 实战指南

从内容编写和系列组织,到主题定制、多语言路由与生产部署的完整阅读路径。

这组文章按照维护 Astro Narrow 站点时的实际决策顺序组织:先建立可靠的内容写作流程,再用 typed reading path 管理长篇主题,随后处理视觉系统、多语言路径和生产部署。

每个章节都可以独立阅读,但按顺序阅读能从内容结构自然过渡到公开交付,同时避免给主题引入没有实际需求的通用抽象。

系列

章节目录

5 篇文章
  1. 01使用 Astro Content Collections 编写文章一套适用于 Astro Narrow 的文章、草稿、分类和标签编写流程。
  2. 02构建有序的系列文章使用 Astro typed references 定义阅读路径,同时保持文章、归档和 taxonomy 边界清晰。
  3. 03在不破坏深色模式的前提下定制主题颜色通过语义化 OKLCH token 和配套深色值,为 Astro Narrow 添加或调整配色主题。
  4. 04组织多语言内容与内部链接让中英文内容、路由、taxonomy 词条和 base-aware 链接保持清晰可预测。
  5. 05将 Astro Narrow 部署到 GitHub Pages正确配置 GitHub Pages、项目 base 路径和本地生产构建,避免部署后链接失效。