Files
notebook/mkdocs.yml
T
kurihada 155b347d3f docs: 新增 MkDocs 部署文档
涵盖 MkDocs Material 配置、构建流程、Caddy Docker 部署、完整工作流和维护指南
2026-06-04 11:46:27 +08:00

83 lines
2.5 KiB
YAML

site_name: 我的知识库
site_description: 个人知识内容存储 — 摄影、旅行、技术、3D打印
site_author: kurihada
theme:
name: material
language: zh
palette:
- media: "(prefers-color-scheme: light)"
scheme: default
primary: indigo
accent: indigo
toggle:
icon: material/brightness-7
name: 切换深色模式
- media: "(prefers-color-scheme: dark)"
scheme: slate
primary: indigo
accent: indigo
toggle:
icon: material/brightness-4
name: 切换浅色模式
features:
- navigation.instant # 即时加载(SPA 体验)
- navigation.tracking # 地址栏跟随
- navigation.tabs # 顶部标签导航
- navigation.indexes # 分类文件夹可作为可点击页面
- navigation.top # 回到顶部按钮
- search.suggest # 搜索建议
- search.highlight # 搜索高亮
- content.code.copy # 代码块复制按钮
custom_dir: docs/overrides # 自定义模板覆盖(评论系统等)
markdown_extensions:
- admonition # 提示框 !!! note
- pymdownx.details # 可折叠块
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
- pymdownx.highlight # 代码高亮
- pymdownx.inlinehilite # 行内高亮
- pymdownx.tasklist: # 任务列表
custom_checkbox: true
- toc:
permalink: true # 标题锚点链接
- tables # 表格增强
- footnotes # 脚注
- attr_list # 属性支持
plugins:
- search:
lang: zh # 中文搜索优化
extra:
social:
- icon: material/camera
link: http://localhost:2283 # Immich 入口
nav:
- 首页: index.md
- 旅行:
- 旅行/index.md
- 赛里木湖 2026: 旅行/赛里木湖2026.md
- 摄影:
- 摄影/index.md
- 技术:
- 技术/index.md
- MkDocs 部署: 技术/mkdocs部署.md
- 旁路由部署: 技术/旁路由部署.md
- Artalk 评论系统: 技术/artalk评论系统.md
- 旁路由使用:
- Linux: 技术/旁路由使用/Linux.md
- Windows: 技术/旁路由使用/Windows.md
- macOS: 技术/旁路由使用/macOS.md
- Android: 技术/旁路由使用/Android.md
- iPhone: 技术/旁路由使用/iPhone.md
- 3D打印:
- 3D打印/index.md
- 日记:
- 日记/index.md