Paimon1999主题使用指南

关于主题

欢迎使用 Paimon1999 主题！这是一个功能完整的 Hexo 主题，专为现代博客设计。

功能特色

• ✨ 暗黑模式切换：右上角一键切换明亮/暗黑主题
• 🔍 实时搜索：导航栏支持搜索文章标题和内容
• 📱 响应式设计：完美适配桌面和移动设备
• 🏷️ 智能导航：菜单根据内容动态显示
• 📄 分页支持：首页文章分页显示
• 💬 评论系统：支持 Disqus 和 Gitalk
• 🎨 代码高亮：支持语法高亮和主题适配
• 🔗 SEO 优化：完整的 meta 标签和社交媒体支持

安装使用

1. 下载主题到 themes/paimon1999/
2. 在 _config.yml 中设置 theme: paimon1999
3. 运行 hexo generate 生成站点

主题配置

基础配置

1
2
3

# themes/paimon1999/_config.yml
default_theme: light  # 默认主题：light 或 dark
favicon: /images/favicon.ico  # 网站图标路径

菜单配置

1
2
3
4

menu:
  home: /
  archives: /archives
  # categories 和 tags 会根据是否有内容自动显示

侧边栏配置

1
2
3

sidebar:
  enable: true
  recent_posts: 5  # 最近文章数量

评论系统

Disqus 配置

1
2
3
4

comments:
  enable: true
  type: disqus
  disqus_shortname: your_disqus_shortname

Gitalk 配置（推荐）

1
2
3
4
5
6
7
8

comments:
  enable: true
  type: gitalk
  clientID: your_github_oauth_client_id
  clientSecret: your_github_oauth_client_secret
  repo: your_repo_name
  owner: your_github_username
  admin: your_github_username

写作提示

• 使用标准 Markdown 语法
• 代码块会自动高亮
• 支持表格、列表、链接等
• 图片建议放在 source/images/ 目录

自定义样式

主题使用 CSS 变量，你可以通过覆盖样式来自定义外观：

1
2
3
4
5

:root {
  --bg: #ffffff;
  --text: #333333;
  --accent: #ff7e5f;
}

问题排查

• 如果评论不显示，检查配置是否正确
• 搜索功能只在首页生效
• 移动端侧边栏会隐藏以节省空间

享受写作，Paimon1999 与你同行！ 🎈