Compare commits

3 Commits
master ... main

Author SHA1 Message Date
0aadc1ae9b Update README 2026-05-19 22:49:37 +08:00
46b44d771d Merge remote main, keep local changes 2026-05-19 22:39:50 +08:00
4a82087c0d Initial commit 2026-05-19 22:22:47 +08:00

View File

@@ -37,6 +37,10 @@ DOCS_DIR=./docs
### 2. 构建并启动服务 ### 2. 构建并启动服务
下载当前的docker-compose.yml文件放到项目根目录
运行以下命令构建并启动服务:
```bash ```bash
# 构建镜像并启动服务 # 构建镜像并启动服务
docker-compose up --build docker-compose up --build
@@ -45,6 +49,26 @@ docker-compose up --build
docker-compose up --build -d docker-compose up --build -d
``` ```
**需要创建文档服务最小目录单元**
```
hf-mes-docs-vitepress/
├── docs/ # VitePress 文档目录 **生产时使用**
│ ├── .vitepress/
│ │ ├── config.mjs # VitePress 配置
│ │ ├── vitepress-pdf.config.ts # PDF 导出配置
│ │ └── theme/
│ │ ├── index.ts # 自定义主题入口,图片放大缩小配置
│ │ └── style/
│ │ └── print.css # 打印样式用于pdf导出
│ ├── index.md # 首页
│ ├── guide/ # 指南目录(可选)
│ ├── getting-started/ # 入门目录(可选)
│ └── ... # 其他文档(可选)
├── docker-compose.yml # Docker Compose 配置
└── .env # 环境变量配置
```
### 3. 验证服务状态 ### 3. 验证服务状态
访问以下地址确认服务正常运行: 访问以下地址确认服务正常运行:
@@ -52,7 +76,7 @@ docker-compose up --build -d
- **VitePress 文档**: http://localhost:3000 - **VitePress 文档**: http://localhost:3000
- **API 健康检查**: http://localhost:3001/health - **API 健康检查**: http://localhost:3001/health
## 目录结构 ## 目录结构(全项目)
``` ```
hf-mes-docs-vitepress/ hf-mes-docs-vitepress/
@@ -65,11 +89,15 @@ hf-mes-docs-vitepress/
├── docs/ # VitePress 文档目录 **生产时使用** ├── docs/ # VitePress 文档目录 **生产时使用**
│ ├── .vitepress/ │ ├── .vitepress/
│ │ ├── config.mjs # VitePress 配置 │ │ ├── config.mjs # VitePress 配置
│ │ ── vitepress-pdf.config.ts # PDF 导出配置 │ │ ── vitepress-pdf.config.ts # PDF 导出配置
│ │ └── theme/
│ │ ├── index.ts # 自定义主题入口,图片放大缩小配置
│ │ └── style/
│ │ └── print.css # 打印样式用于pdf导出
│ ├── index.md # 首页 │ ├── index.md # 首页
│ ├── guide/ # 指南目录 │ ├── guide/ # 指南目录(可选)
│ ├── getting-started/ # 入门目录 │ ├── getting-started/ # 入门目录(可选)
│ └── ... # 其他文档 │ └── ... # 其他文档(可选)
├── docker-compose.yml # Docker Compose 配置 ├── docker-compose.yml # Docker Compose 配置
├── package.json # 项目依赖 **构建docker时使用** ├── package.json # 项目依赖 **构建docker时使用**
└── .env # 环境变量配置 └── .env # 环境变量配置