HEXO-THEME-HUHU

1 介绍

简单、突出文字，是开发的初衷
一个在 Hexo 博客上开发的主题，主题会持续更新
近日服务器搬迁完成，腾出时间来完善一下博客文档

2 安装

git clone https://github.com/shixiaohu2206/hexo-theme-huhu.git themes/hexo-theme-huhu

在项目根目录操作以上命令，并修改根目录下的 _config.yml 中的 theme 为 hexo-theme-huhu

本主题需要安装shelljs，因为 requiresJS 打包时，需要执行 bash 命令

npm install --save shelljs

3 站内搜索

目前主题只支持自生成搜索文件的方式，因为依赖第三方站内搜索，始终不是很稳定的赶脚，而且会加载许多第三方的服务文件，导致博客首屏加载慢

3.1 安装

安装hexo-generator-json-content插件，用于生成站内搜索生成文件

npm install --save hexo-generator-json-content

在根目录下的 _config.yml 中新增配置，如下:

#https://github.com/alexbruno/hexo-generator-json-content
jsonContent:
  dateFormat: YYYY/MM/DD
  pages: false
  posts:
    tags: true
    title: true
    date: true
    text: true
    permalink: true
    photos: true
  file: content.json

4 新建 about 页面

about 页面没有单独 layout，直接以 markdown 渲染

hexo new page "about"

5 新建 tags、categories、friends 页面

tags、categories、friends 有单独的 layout，所以新增命令后，需要在对应的文件中新增 layout 参数

hexo new page "tags"

hexo new page "friends"

hexo new page "categories"

请自行添加，例如：

---
layout: tags
---

5.1 friends 友链

在根目录下的 _config.yml 中新增配置，例如：

friends:
  - name: Don Lex
    time: '2019-10-12'
    url: 'https://www.donlex.cn/'
    logo: 'https://www.donlex.cn/images/avatar.png'
    intro: '码农'

6 Google 相关配置

如果使用 GTM 统计、Goole 站点、Google 广告等，则在根目录配置 _config.yml 中添加配置

#google-site-verification 添加在meta信息中
google_site_verification: ''

#google gtm
gtm_id: ''

#google gtm
google_ad_client: ''

7 Baidu 相关配置

主题新加了一个百度统计图表功能，使用方法见链接

使用百度站点、百度联盟、百度统计等功能，在根目录配置 _config.yml 中添加配置

# 百度站点验证码
baidu_site_verification: ''

#百度联盟验证
baidu_union_verify: ''

#百度统计
baidu_tongji:
  site_from: '2019/7/26'
  site_id: ''
  access_token: 'xxxxx'

8 代码高亮

本主题支持 highlight.js 官方的 css，highlight.js 官网看中哪个颜色搭配，复制 css 样式替换themes\huhu\source\style\highlight.styl

新增 hljs 参数，并设为 trye，不然无法使用 highlight.js 官方的 css

highlight:
  enable: true
  hljs: true #新增hljs参数，并设为true，不然无法使用highlight.js 官方的 css
  line_number: false #暂不支持行号
  auto_detect: false #这一项也关闭，若开启有可能报错
  tab_replace:

9 文章评论

支持两种方案，二选一

valine
畅言

9.1 valine 评论

官网教程，在根目录配置 _config.yml 中添加

#valine评论
valine:
  API_ID: ''
  API_KEY: ''

9.2 畅言评论

官网教程，在根目录配置 _config.yml 中添加

#畅言评论
changyan:
  appid: ''
  conf: ''

10 RSS

安装插件hexo-generator-feed

npm install --save hexo-generator-feed

在根目录配置 _config.yml 中添加

#rss
feed:
  type: atom
  path: atom.xml
  limit: 20
  hub:
  content:
  content_limit: 140
  content_limit_delim: ''
  order_by: -date
  icon: icon.png

11 置顶

#卸载官方插件
npm uninstall hexo-generator-index --save

#安装插件
npm install hexo-generator-index-pin-top --save

在 markdown 文件的 Front-matter，新增 top: 1即可，top 值越大，越靠前展示

主题在列表页增加了置顶的小图标，具体样式查看虎虎博客

12 兼容性

使用了 Flex 布局，不支持 IE8

13 自定义

其他的自定义，修改也很方便，比如更换打赏二维码、Follow 地址，都在主题的配置中themes\huhu\_config.yml，各位大佬请自行修改

askdaddy / hexo-theme-huhu