曾经使用 Docusaurus 构建过个人网站,包括 Langchain 官网也是基于 Docusaurus 构建的。但总觉得审美不在点上,也缺少我所需要的 steps,cards 等样式,且没有自带搜索功能,于是切换到了 Astro 框架。
MacOS 可以考虑通过 brew 安装 nvm,然后使用 nvm 安装指定版本的 nodejs。
进入项目目录,运行以下命令在本地启动开发服务器:
使用 Astro 构建的项目目录清晰且结构化,关键文件和目录的作用如下所示
astro.config.mjs
— Astro 配置文件;包括 Starlight 集成和配置。src/content/config.ts
— 内容集合配置文件;将 Starlight 的 frontmatter 模式添加到你的项目中。src/content/docs/
— 内容文件。Starlight 将此目录中的每个 .md
、.mdx
或 .mdoc
文件转换为站点上的一个页面。src/content/i18n/
(可选) — 支持国际化的翻译数据。src/
— 项目的其他源代码和文档(组件、样式、图像等)。public/
— 静态资源(字体、网站图标、PDF 等)不会被 Astro 处理。