Logo 文件说明

文件要求

Logo 文件 (logo.svg 或 logo.png)

• 推荐格式: SVG（矢量图，缩放不失真）
• 备选格式: PNG（透明背景）
• 建议尺寸:
• SVG: 任意尺寸（矢量图自动缩放）
• PNG: 128x128 或 256x256 像素
• 颜色: 建议使用单色或简洁的双色设计，以适应深色/浅色主题

Favicon 文件 (favicon.ico)

• 格式: ICO 格式
• 尺寸: 16x16, 32x32, 48x48 像素（多尺寸 ICO 文件）
• 用途: 浏览器标签页小图标

文件放置

将准备好的文件放置在此目录下：

docs/assets/images/
├── logo.svg          # 主 logo（SVG 格式推荐）
├── logo.png          # 主 logo（PNG 格式备选）
├── favicon.ico       # 浏览器标签页图标
└── README.md         # 本说明文件

配置说明

在 mkdocs.yml 中已配置：

theme:
  logo: assets/images/logo.svg      # 主 logo
  favicon: assets/images/favicon.ico # 浏览器图标

注意事项

1. 文件路径: 路径相对于 docs 目录
2. 文件名: 确保文件名与配置中的路径完全匹配
3. 格式选择: 优先使用 SVG，如果不支持再使用 PNG
4. 主题适配: Logo 会自动适应深色/浅色主题，建议使用简洁设计