Astro Starlight

Astro Starlight 是一个基于 Astro 网络框架构建的文档主题。它提供了一个现成的结构，用于创建快速、易访问且易于维护的文档网站。与其他文档工具不同，Starlight 向浏览器发送的 JavaScript 最少，从而实现更快的加载时间和更佳的性能。

该工具支持以 Markdown、MDX 和 Markdoc 格式编写内容，赋予您创建文档的灵活性。它包括自动导航生成、由 Pagefind 提供支持的内置搜索，以及适用于所有设备的响应式设计。Starlight 还开箱即用地支持多语言，适合全球文档项目。该主题通过配置文件高度可定制，使您能够匹配品牌风格，同时保持设置的简便性。

开始使用 Astro Starlight 非常简单，只需几个步骤：

• 通过在终端运行 npm create astro@latest -- --template starlight 命令行安装 Starlight。此操作会自动完成所有设置。

• 安装完成后，使用 npm run dev 启动开发服务器，在浏览器中本地预览您的文档网站。

• 通过在 src/content/docs/ 目录中创建 Markdown 或 MDX 文件来添加新的文档页面。每个文件都会自动成为一个页面。

• 在 astro.config.mjs 文件中配置您的网站设置。在这里，您可以设置网站标题、添加社交媒体链接以及自定义导航侧边栏。

• 通过在 docs 目录内创建文件夹来组织页面。Starlight 会根据您的文件结构自动生成导航。

• 准备发布时，运行 npm run build 构建您的网站，并部署到任何静态托管服务，如 Netlify、Vercel 或 GitHub Pages。

• 快速静态网站生成，使用最少的JavaScript

• 内置Pagefind搜索功能

• 全面支持国际化

• 自动生成导航

• 包含暗黑和明亮主题

• 支持Markdown、MDX和Markdoc

• 多框架集成（React、Vue、Svelte）

• 注重无障碍设计

• 移动端响应式布局

• 可自定义主题和颜色

• 编辑页面链接

• 社交媒体集成

• SEO优化