EmDash Starter — 入门模板主题

概述

Starter 主题是 EmDash 的最小化入门模板，代码量精简但涵盖了构建 EmDash 站点所需的全部模式。它是学习 EmDash 开发的最佳起点，也是创建自定义主题的理想基础。

包含内容

基础布局组件（含 EmDash 必需的 Head 和 Body 注入）、首页、文章列表页、文章详情页、分类归档页、单独页面模板和 404 页面。每个文件都有详细的注释说明。

最佳实践示范

展示了 EmDash 开发的关键模式：正确使用 getEmDashCollection 和 getEmDashEntry 查询内容、使用 Astro.cache.set(cacheHint) 处理缓存、使用 Image 组件渲染图片字段、使用 PortableText 渲染富文本等。

样式方案

使用原生 CSS 编写，不依赖任何 CSS 框架。样式文件结构清晰，变量集中管理，方便替换为你偏好的 CSS 方案（Tailwind、UnoCSS 等）。

种子文件模板

附带完整的 seed.json 模板，定义了文章、页面两个集合以及分类和标签两个分类法。包含示例内容和详细的字段注释，可直接作为新项目的起点。

快速上手

运行 npm create emdash@latest -- --template starter 即可基于此模板创建新项目。生成的项目已预配置好数据库、存储和开发服务器，直接运行 npx emdash dev 即可开始开发。