2026-01-05 10:31:24 +08:00
|
|
|
# 快速开始
|
|
|
|
|
|
|
|
|
|
## 环境要求
|
|
|
|
|
|
|
|
|
|
- Docker
|
|
|
|
|
- Docker Compose
|
|
|
|
|
|
|
|
|
|
## 启动服务
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
cd /home/renjianbo/devops/mkdocs
|
|
|
|
|
docker-compose up -d
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## 访问地址
|
|
|
|
|
|
|
|
|
|
- **本地访问**: http://localhost:8000
|
|
|
|
|
- **服务器访问**: http://101.43.95.130:8000
|
|
|
|
|
|
|
|
|
|
## 编辑文档
|
|
|
|
|
|
|
|
|
|
1. 编辑 `docs/` 目录下的 Markdown 文件
|
|
|
|
|
2. 保存后,页面会自动刷新(开发模式)
|
|
|
|
|
3. 在 `mkdocs.yml` 中配置导航结构
|
|
|
|
|
|
|
|
|
|
## 常用命令
|
|
|
|
|
|
|
|
|
|
### 启动服务
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker-compose up -d
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 停止服务
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker-compose down
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 查看日志
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker-compose logs -f
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 构建静态站点
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker-compose exec mkdocs mkdocs build
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 进入容器
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker exec -it mkdocs sh
|
|
|
|
|
```
|