帮助

小提示

使用主题的时候,尽量fork主题到自己的GitHub,然后进行修改并使用。这样做的好处是:当主题进行重要更新的时候可以根据需要拉取合并代码,使自己DIY的主题能够通过更新获取BUG修复或者新特性。

故障自检

如果你发现 无法使用 或者效果与示例有较大区别,可以使用hexo官方提供的用于单元测试的博客应用本主题查看样式是否正常,对比_config.yml文件排查问题。

下载单元测试:

Hexo官方的单元测试博客: https://github.com/hexojs/hexo-theme-unit-test.git。如果你的系统是macOS,则可以使用hexo.sh脚本一键完成测试。

为什么顶部导航栏是空的

导航栏要写在./_config.yml中,而不是直接修改主题的themes/material-x/_config.yml文件,详见:#导航栏

更新了主题之后FontAwesome图标变成方块

由于最初使用的版本是4.7.0,从2018年11月7号更新后使用5.5.0版本,其命名方式发生了变化:

版本命名示例
4.7.0<i class="fab fa-github"></i>
5.5.0<i class="fab fa-github"></i>

由于5.x版本之前前缀始终是:fa,所以主题中写好了前缀,_config.yml中只需要写fa-github即可,但是从5.x版本起,前缀有多种,所以需要写全名,即:fab fa-github这样才能正常显示。

所以,你需要去FontAwesome官网搜索图标,复制图标的class字段中的全名,来替换之前的名字。 如下图所示:

关于markdown的写法

例如不知道怎么显示图片,怎么画表格等等,你可以去这里看《Markdown 语法介绍》,讲的极其详细。

关于SEO

SEO跟主题之间没有什么耦合,所以主题没有捆绑SEO插件,你需要的话可以自己安装,我安装了以下SEO优化插件:

恕不提供Hexo教程

关于hexo如何搭建的问题,网上有很多教程,仅仅是查阅官方文档和demo都足够了,所以这方面的问题请不要再来问我了。




评论