mkdocs Favicon + Logo

目的：为 Claude Code 文档站加 favicon + logo 关联：[B1-4]

---

1. 设计建议

3 选项：

风格	描述
简单字符	用 "C" 或 "◆" emoji
几何图标	三角形 / 圆 / 字母组合
完整 logo	项目 logo（推测）

推荐：简单字符（黑色背景 + 白色 "C"）。

---

2. 3 步集成

2.1 Step 1: 准备 favicon

# 32x32 PNG
# 内容: 黑色背景 + 白色 "C"

1 文件。

2.2 Step 2: 放到 docs/ 目录

docs/
├── favicon.png
├── index.md
└── ...

1 步。

2.3 Step 3: mkdocs.yml 配置

theme:
  favicon: favicon.png
  logo: images/logo.png

2 行。

---

3. Material 主题 logo

theme:
  name: material
  logo:
    text: Claude Code 学习手册
  favicon: favicon.png

logo + 文本。

---

4. 5 个最佳实践

1. 简单字符 —— 不要复杂 logo
2. PNG 32x32 —— favicon 标准
3. SVG 矢量 —— 任意缩放
4. dark mode 兼容 —— 2 套
5. 不要 emoji —— 终端字体渲染不一

---

5. 完整目录结构

docs/
├── favicon.png
├── logo.png
├── logo-dark.png
├── index.md
└── ...

4 文件。

---

6. 总结

favicon + logo = 简单字符 + 2 套（dark/light）。

下一步： - 看 B1-5 blog 插件