这是基于 VitePress 构建的 NextPilot Flight Control 官方网站,提供产品介绍、解决方案、用户手册与开发指南等内容。
编译好的网页托管在本仓库的 gh-pages 分支,可通过以下链接访问:
- 官方网站:https://nextpilot.org
- 文档中心:https://nextpilot.org/docs/
- 产品手册:https://nextpilot.org/docs/manual/
- 使用教程:https://nextpilot.org/docs/guide/
- 开发指南:https://nextpilot.org/docs/develop
国内网络环境下安装依赖较慢,可配置 pnpm 镜像源加速:
# 查看当前镜像源
pnpm config get registry
# 设置国内镜像源(npmmirror)
pnpm config set registry https://registry.npmmirror.com其它可选镜像:
配置后干净重装:
rm -rf node_modules pnpm-lock.yaml
pnpm install编译项目文档:
# 安装依赖
pnpm install
# 也可仅对本次安装临时使用国内镜像加速
pnpm install --registry=https://registry.npmmirror.com
# 启动本地开发服务器(默认 http://localhost:5173)
pnpm docs:dev
# 构建生产版本
pnpm docs:build
# 本地预览构建产物
pnpm docs:preview.
├── .vitepress/ # VitePress 站点配置与主题扩展
│ ├── config.mts # 站点主配置
│ ├── config/ # 配置辅助模块
│ │ ├── sidebar.mts # 自动生成侧边栏
│ │ └── headconfig.mts # head 标签(canonical / 跳转 / 统计)
│ ├── markdown/ # Markdown 扩展插件
│ │ ├── plugin-heading-tab.mts
│ │ └── plugin-markdown-tab.mts
│ └── theme/ # 自定义主题与布局组件
│ ├── CatalogLayout.vue
│ ├── CatalogLayout.data.mts
│ ├── ProductLayout.vue
│ ├── components/
│ └── index.mts
├── source/ # 内容源目录,VitePress srcDir(按语言分目录)
│ ├── zh/ # 简体中文(root locale;经 rewrites 剥掉 zh/ 段,URL 上不可见)
│ │ ├── index.md # 首页(https://nextpilot.org/)
│ │ ├── about/ # 关于我们
│ │ ├── blog/ # 技术博客
│ │ ├── discovery/ # 展示/占位栏目
│ │ ├── docs/ # 文档中心(URL 前缀 /docs/)
│ │ │ ├── 01-manual/ # 产品手册(/docs/manual/)
│ │ │ │ ├── aircraft/ # 无人机平台
│ │ │ │ ├── autopilot/ # 飞行控制
│ │ │ │ ├── datalink/ # 通信链路
│ │ │ │ ├── navigator/ # 导航传感
│ │ │ │ └── peripheral/ # 其它外设
│ │ │ ├── 02-guide/ # 使用教程(/docs/guide/)
│ │ │ ├── 03-develop/ # 开发指南(/docs/develop/)
│ │ │ └── 04-community/ # 社区支持(/docs/community/)
│ │ ├── download/ # 资源下载
│ │ ├── news/ # 新闻资讯
│ │ ├── product/ # 产品中心
│ │ │ ├── aircraft/ # 无人机平台
│ │ │ ├── autopilot/ # 飞行控制
│ │ │ ├── datalink/ # 通信链路
│ │ │ ├── navigator/ # 导航传感
│ │ │ └── peripheral/ # 其它外设
│ │ └── solution/ # 解决方案
│ └── en/ # English 内容(URL 前缀 /en/,如 https://nextpilot.org/en/)
├── public/ # 静态资源目录
│ ├── CNAME
│ ├── favicon.png
│ ├── logo.png
│ └── assets/ # 静态资源(images/ files/ scripts/)
├── build/ # 生产构建输出,自动生成
├── package.json
├── pnpm-lock.yaml
├── README.md
├── LICENSE
├── CLAUDE.md
└── ...
- 自动生成文档侧边栏与栏目导航
- 产品列表页与详情页分离布局
- 自定义产品页顶部图集和摘要区
- Markdown 二级标题自动折叠为产品页 Tabs
- 支持中英文站点配置与多语言导航
- 生成 sitemap 与站内固定路由配置
- 本站内容(文档、图片等):CC BY 4.0:开放共享、转载、修改与商用,但须保留署名来源
- NextPilot 飞行控制软件:BSD 3-Clause:自由使用、修改、再分发与商用,但须保留版权声明,不得以项目方名义背书