从可运行站点开始
新建文档站点
从维护中的 starter template 创建完整 Dahlia 项目,然后替换示例配置和内容。
已有 Astro 项目
按可直接复制的步骤添加 integration、content collection、主题配置和第一篇文档。
完成常见任务
编写内容
使用 frontmatter、Markdown、MDX、图片、代码块、callout 和 Mermaid 图表。
配置导航
将 content entry ID 组织成 section、嵌套分组和自动生成的目录列表。
使用 MDX 组件
复制 callout、card、steps、tabs、accordion、file tree、media、embed、badge 和 icon 的可运行示例。
自定义 Dahlia
从 appearance 和 CSS tokens 开始;只有配置不够用时才覆盖外壳组件。
添加语言
将 locale 目录映射到 URL,并处理 fallback content、翻译后的导航、edit link 和搜索索引。
构建与部署
验证项目、构建静态输出、检查搜索,然后发布生成的 dist/ 目录。