Material 主题 (opens new window)是一个基于 Material Design (质感设计)的 Hexo (opens new window)主题。

Hexo 更换主题的方法参见另一篇博客

在网上找到了一个配置过程非常详实的博客 (opens new window),而且还修复了一些主题的小 bug,基本上按照这个博客做就好啦。

# 几个 bug

但是按照这篇博客做了之后,还是有几个小问题:

# bug1:无法本地搜索

要实现本地搜索,除了安装hexo-generator-search (opens new window)插件外,还要把主题配置文件search.usegoogle修改为local

# Search Systems
# Available value:
#     swiftype | google | local
search:
    use: local
    swiftype_key:

# bug2:图表显示不全

原主题配置文件的图标包是从googleapis在线获取的,由于众所周知的原因,大陆不能顺利访问。但是主题配置文件中提供了镜像站的选项,把google改成中科大的镜像站ustc就可以正常显示图标了。

fonts:
    family: Roboto, "Helvetica Neue", Helvetica, "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "微软雅黑", Arial, sans-serif
    use: ustc
    custom_font_host:

# bug3:代码高亮也有问题

如下图。

highlight

这个在Material主题的Issues (opens new window)被大量提及。

解决方法步骤:

  • 关掉主题配置文件hanabi高亮,并开启prettify高亮;
prettify:
    enable: true
    theme: "github-v2"

hanabi:
    enable: false
    line_number: false
    includeDefaultColors: true
    customColors:
  • 站点配置文件里,关掉 Hexo 自带的所有 Highlight。
highlight:
  enable: false
  line_number: false
  auto_detect: false
  tab_replace:
  • 下一次执行hexo g之前先hexo clean

放一个我的主题配置文件

改名以后,直接覆盖_\themes\material\_config.yml就可以了,也可以做一些自己的修改。

# 页面计数——不蒜子

Material 里面自带了不蒜子的。在主题配置文件里面打开开关,然后更换一下不蒜子的链接(原服务器倒闭了)就可以了。这个挺简单的。

# _config.yml
# Busuanzi 不蒜子 Views
busuanzi:
    enable: true
    all_site_uv: true
    post_pv: true
    busuanzi_pure_mini_js: "https://busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"

# 推荐插件

插件等配置可以参照这个

【持续更新】最全Hexo博客搭建+主题优化+插件配置+常用操作+错误分析 (opens new window)

一些插件的链接

hexo-generator-search (opens new window)

下载安装插件,需要在博客根目录使用下面这句命令

npm install <package name> --save

一定要加--save参数,这样该插件才会被加入该项目的dependencies中,下次生成hexo的时候才会被编译。

插件具体使用方法建议去看各插件的github项目的README.MD文件。

# 博客置顶插件

摘抄自:【持续更新】最全Hexo博客搭建+主题优化+插件配置+常用操作+错误分析 (opens new window)

安装插件:

npm uninstall hexo-generator-index --save
npm install hexo-generator-index-pin-top --save

然后在需要置顶的文章的Front-matter中加上 top 即可:

---
title: 2018
date: 2018-10-25 16:10:03
top: 10
---