常见问题

更新主题

使用主题的时候,尽量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

为什么顶部导航栏和侧边小部件是空的

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

故障自检

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

关于markdown的写法

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

关于SEO

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

可选的联系方式

由于个人精力有限,暂不接受私聊,关于主题的疑问请在主题文档下方留言,或者是在主题的github页面提issue,其次是发邮件。所有开源作品均可在我的GitHub找到源码,请不要私聊我询问源码了。
与hexo的使用相关的问题请前往hexo官方文档页面留言,与valine的使用相关的问题请前往valine官方文档页面留言。

恕不提供Hexo教程

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




评论

有疑问请前往本项目的【Issue】页面搜索问题,如果没有相关问题,点击【New issue】进行提问。