快速开始
Squidoc 是一个静态优先的文档平台,内置插件系统、主题系统和面向 SEO 的默认配置。你可以编写 Markdown,通过 docs.config.ts 配置项目,并发布快速的静态站点。
项目结构
文档文章放在 docs/,可选 Astro 页面放在 pages/,docs.config.ts 连接站点元数据、导航、插件和主题。
扩展
插件可以添加搜索、SEO、代码块、版本管理、国际化和生成文件。主题控制布局、导航和插件插槽。
验证
部署前运行 npm run check、npm run build 和 npm run preview。
快速开始
此页面与英文文档保持对应,确保所有支持的语言在当前版本中拥有相同的文档覆盖范围。
参考示例
npm create squidoc@latest my-docs
cd my-docs
npm run dev
---
title: API Guide
description: Learn how to use the API.
---
# API Guide
Write your documentation here.
nav: [
{ title: "Getting Started", path: "/getting-started" },
{ title: "API Guide", path: "/api-guide" },
];
npm run check
npm run build
npm run preview