init: MkDocs Material 文档站

2026-08-24 02:30:35 +00:00
commit 5718b98ffc
66 changed files with 16852 additions and 0 deletions
@@ -0,0 +1,93 @@
+site_name: 文档站
+site_description: 个人知识文档站
+site_author: wonder
+
+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     # URL 跟踪锚点
+    - navigation.tabs         # 顶部标签
+    - navigation.sections     # 节分组
+    - navigation.expand       # 默认展开侧边栏
+    - navigation.indexes      # 节首页
+    - navigation.top          # 返回顶部按钮
+    - search.suggest          # 搜索建议
+    - search.highlight        # 搜索高亮
+    - search.share            # 搜索分享
+    - content.code.copy       # 代码一键复制
+    - content.code.annotate   # 代码注释
+    - content.tabs.link       # 内容标签联动
+
+plugins:
+  - search:
+      lang:
+        - zh
+        - en
+
+markdown_extensions:
+  - abbr
+  - admonition
+  - attr_list
+  - def_list
+  - footnotes
+  - md_in_html
+  - toc:
+      permalink: true
+  - pymdownx.arithmatex:
+      generic: true
+  - pymdownx.betterem:
+      smart_enable: all
+  - pymdownx.caret
+  - pymdownx.details
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.keys
+  - pymdownx.mark
+  - pymdownx.smartsymbols
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - pymdownx.tabbed:
+      alternate_style: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - pymdownx.tilde
+
+nav:
+  - 首页: index.md
+  - 开发:
+    - dev/index.md
+    - Git 工作流: dev/git-workflow.md
+    - Docker 笔记: dev/docker-notes.md
+  - 运维:
+    - ops/index.md
+    - Linux 常用命令: ops/linux-commands.md
+    - Nginx 配置: ops/nginx-config.md
+  - 学习:
+    - learn/index.md
+    - 算法笔记: learn/algorithms.md