导航菜单

快速开始

初始化

pnpm create astro@latest docs-site
cd docs-site
pnpm install
pnpm dev

目录要点

  • src/pagesindex.astro 等页面;Markdown/MDX 也可直接放这里。
  • src/layouts:布局组件。
  • src/content:内容集合定义与内容文件(如使用 Content Collections)。

构建与部署

  • 构建:pnpm build 输出 dist/
  • 预览:pnpm preview
  • 部署:将 dist 上传到任意静态托管(CF Pages/Netlify/Vercel);若用 SSR/边缘,选择对应 adapter。

常用集成

  • 内容:@astrojs/mdx、Content Collections。
  • 组件:Vue/React/Svelte/Preact 任意混用,给交互组件加 client:* 指令。
  • 图片:@astrojs/image 优化多尺寸。

搜索