常见问题

如何更新主题

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

如果不懂请自行搜索关键词:fork 更新

常见问题

无法成功运行本地预览

可能是没有安装依赖,请按照【开始使用 -> 下载安装】中的步骤进行安装,并安装所需依赖。

如果开启了某些第三方服务,请查看文档中是否要求安装插件。

如果报错信息有lastIndex,你可以尝试把博客根目录配置文件中找到highlight,并将auto_detect设置为false

主题配置修改没有生效

请确认文档中要求修改的是博客主目录的配置文件./config.yml还是主题的配置文件themes/material-x/config.yml

主题样式修改没有生效

如果主题配置文件中开启了cdn服务,那么修改本地的样式是不会生效的,需要关闭cdn服务。

修改什么都没有生效

需要重新hexo s

如果安装了popularposts插件后,每次修改frontmatter后都需要重新hexo s

搜索无法使用

  1. 检查是否安装文档要求正确的安装了依赖包。
  2. 检查根目录配置文件是否有search字段冲突(我的根目录配置文件中没有search字段)。
  3. 如果以上两步都无法找到问题,请下载示例源码进行对比。

搜索结果链接不正确

请检查根目录配置文件中的链接是否正确,如:

1
2
url: https://xaoxuu.com
root: /

故障自检

一个全新的工程全部使用默认配置是正常没有故障的。#示例

如果无法使用或者效果与示例有较大区别,可以使用hexo官方提供的用于单元测试的博客应用本主题查看样式是否正常,对比_config.yml文件排查问题。Hexo官方的单元测试博客: https://github.com/hexojs/hexo-theme-unit-test.git。如果你的系统是macOS,则可以使用hexo.sh脚本一键完成测试。

关于SEO

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

教程与指南

亲这里是MaterialX主题的使用文档,不是Hexo博客一站式教程。与MaterialX主题无关的,例如markdown的写法、Valine的用法以及BUG之类的,请自行搜索相关教程。

请一定要阅读官方文档! Hexo官方文档 | Valine官方文档




评论