104 lines
2.2 KiB
Markdown
104 lines
2.2 KiB
Markdown
# VitePress 使用手册
|
||
|
||
基于 VitePress 构建的使用手册。
|
||
|
||
## 📖 文档预览
|
||
|
||
本手册采用 VitePress 构建，支持实时预览和静态站点生成。
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 准备package.json文件
|
||
|
||
文件夹下具备 package.json 文件
|
||
|
||
json文件结构如下：
|
||
|
||
```json
|
||
{
|
||
"name": "docs-vitepress",
|
||
"version": "1.0.0",
|
||
"description": "vitepress在线文档",
|
||
"scripts": {
|
||
"docs:dev": "vitepress dev docs",
|
||
"docs:build": "vitepress build docs",
|
||
"docs:preview": "vitepress preview docs",
|
||
"export-pdf": "press-export-pdf export docs"
|
||
},
|
||
"devDependencies": {
|
||
"vitepress": "latest",
|
||
"vitepress-export-pdf": "^1.0.0"
|
||
}
|
||
}
|
||
```
|
||
### 安装依赖
|
||
|
||
执行以下命令安装依赖：
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
### 开发预览
|
||
|
||
```bash
|
||
npm run docs:dev
|
||
```
|
||
|
||
### 构建静态站点
|
||
|
||
```bash
|
||
npm run docs:build
|
||
```
|
||
|
||
### 预览构建结果
|
||
|
||
```bash
|
||
npm run docs:preview
|
||
```
|
||
|
||
## 📁 文档结构
|
||
|
||
```
|
||
docs/
|
||
├── .vitepress/
|
||
│ └── config.mjs # VitePress 配置
|
||
├── guide/ # 文档说明
|
||
│ ├── document-guide.md
|
||
│ └── system-overview.md
|
||
├── getting-started/ # 快速入门
|
||
│ └── quick-start.md
|
||
├── basic/ # 基础配置
|
||
│ ├── data-management.md
|
||
│ └── equipment.md
|
||
├── business/ # 业务模块
|
||
│ ├── production.md
|
||
│ ├── quality.md
|
||
│ └── equipment-warehouse.md
|
||
├── integration/ # 数据集成
|
||
│ └── data-integration.md
|
||
├── analysis/ # 报表分析
|
||
│ └── reports.md
|
||
├── operation/ # 系统运维
|
||
│ ├── system-operation.md
|
||
│ └── technical-support.md
|
||
├── appendix/ # 附录
|
||
│ └── glossary.md
|
||
└── index.md # 首页
|
||
```
|
||
|
||
## 🔧 配置说明
|
||
|
||
VitePress 配置文件位于 `docs/.vitepress/config.mjs`，包含以下配置：
|
||
|
||
- 网站标题和描述
|
||
- 导航栏配置
|
||
- 侧边栏配置
|
||
- 主题配置
|
||
- Markdown 配置
|
||
|
||
## 📦 技术栈
|
||
|
||
- [VitePress](https://vitepress.dev/) - Vite 驱动的静态站点生成器
|
||
- [Vue.js](https://vuejs.org/) - 渐进式 JavaScript 框架
|
||
|