rename: kb → notebook,更新所有文档引用和 Caddy 挂载路径
This commit is contained in:
+8
-8
@@ -8,7 +8,7 @@
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
Repo["~/kb Git 仓库"]
|
||||
Repo["~/notebook Git 仓库"]
|
||||
Build["mkdocs build"]
|
||||
Site["kb/site/ 静态文件"]
|
||||
Caddy["Caddy Docker<br/>caddy:alpine"]
|
||||
@@ -49,7 +49,7 @@ markdown_extensions:
|
||||
### 1.2 目录结构
|
||||
|
||||
```
|
||||
~/kb/
|
||||
~/notebook/
|
||||
├── mkdocs.yml # 站点配置
|
||||
├── docs/ # Markdown 源文件
|
||||
│ ├── index.md
|
||||
@@ -72,7 +72,7 @@ markdown_extensions:
|
||||
### 2.1 本地构建
|
||||
|
||||
```bash
|
||||
cd ~/kb && mkdocs build
|
||||
cd ~/notebook && mkdocs build
|
||||
```
|
||||
|
||||
输出到 `site/` 目录,耗时 < 1 秒。
|
||||
@@ -88,7 +88,7 @@ mkdocs serve -a 0.0.0.0:8000
|
||||
### 2.3 Git 工作流
|
||||
|
||||
```bash
|
||||
cd ~/kb
|
||||
cd ~/notebook
|
||||
mkdocs build # 构建
|
||||
git add -A
|
||||
git commit -m "描述改动" # 提交 Markdown 源码
|
||||
@@ -126,7 +126,7 @@ services:
|
||||
volumes:
|
||||
- ./Caddyfile:/etc/caddy/Caddyfile:ro
|
||||
- ./data:/data # TLS 证书存储
|
||||
- /home/kurihada/kb/site:/srv/mkdocs:ro # kb 静态文件
|
||||
- /home/kurihada/notebook/site:/srv/mkdocs:ro # kb 静态文件
|
||||
|
||||
networks:
|
||||
nginx:
|
||||
@@ -139,7 +139,7 @@ networks:
|
||||
cd ~/docker/caddy && docker compose up -d
|
||||
```
|
||||
|
||||
启动前确认 `~/kb/site/` 目录存在(需先执行过 `mkdocs build`),否则 bind mount 会创建一个空目录导致 404。
|
||||
启动前确认 `~/notebook/site/` 目录存在(需先执行过 `mkdocs build`),否则 bind mount 会创建一个空目录导致 404。
|
||||
|
||||
### 3.4 Caddyfile 中 kb 的配置
|
||||
|
||||
@@ -192,7 +192,7 @@ docker exec caddy caddy reload --config /etc/caddy/Caddyfile # 零停机
|
||||
4. (无需重启 Caddy) # site/ 通过 bind mount 实时生效
|
||||
```
|
||||
|
||||
> 因为 Caddy 通过 `bind mount` 直接读取 `~/kb/site/`,`mkdocs build` 后变更即时生效,无需重启任何服务。
|
||||
> 因为 Caddy 通过 `bind mount` 直接读取 `~/notebook/site/`,`mkdocs build` 后变更即时生效,无需重启任何服务。
|
||||
|
||||
---
|
||||
|
||||
@@ -208,7 +208,7 @@ mkdocs build # 确认构建无报错
|
||||
### 检查构建状态
|
||||
|
||||
```bash
|
||||
cd ~/kb && mkdocs build --verbose
|
||||
cd ~/notebook && mkdocs build --verbose
|
||||
```
|
||||
|
||||
### DNS 与 TLS
|
||||
|
||||
Reference in New Issue
Block a user