Hexo Matery 常见问题及解决

Hexo 博客

其他

发布日期: 2019-09-25

阅读次数:

0 前言

本文章非 Hexo + Matery Theme 教程，详细教程见blinkfox hexo-theme-matery，主要记录一些使用中的问题，希望能帮到进来的同学，避免踩坑。

1 常见问题

1.1 代码相关

在配置了代码高亮后，代码出现无高亮并且布局混乱?
首先使用npm安装hexo-prism-plugin

npm i -S hexo-prism-plugin

然后，修改 Hexo 根目录下 _config.yml 文件中 highlight.enable 的值为 false，并新增 prism 插件相关的配置，主要配置如下：

highlight:
  enable: false
  line_number: true
  auto_detect: true
  tab_replace:

prism_plugin:
  mode: 'preprocess'    # realtime/preprocess
  theme: 'tomorrow'
  line_number: false    # default false
  custom_css:

1.2 Gitalk

Gitalk 配置了无效
多半是配置的问题，我的问题主要是owen和admin写错了，配置解释如下

# the Gitalk config，default disabled
# Gitalk 评论模块的配置，默认为不激活
gitalk:
enable: true
owner: 
repo: 
oauth:
 clientId: 
 clientSecret:
admin:

enable: gitalk 是否激活
owner: 需要填写你Github的用户名，比如我的https://github.com/Congying-Wang/wangcongying.github.io，这里就填写Congying-Wang
repo: 需要填写你这个仓库的名称，比如我的https://github.com/Congying-Wang/wangcongying.github.io，这里就填写 wangcongying.github.io
oauth: 这里的clientId 以及 clientSecret 是需要进行创建OAuth APP获取，创建路径: https://github.com/settings/applications/new，填写格式以及获取路径如下
admin: 同样需要填写你Github的用户名

1.3 数学公式相关

Hexo 不换行
在我们使用数学公式的时候使用\\就可以换行，但是在hexo中却换不了，可以使用\\\\来替换 \\即可解决

1.4 本地搜索相关

本地搜索无效，无结果
step1: 运行下面命令安装 searchdb
```
 sudo npm install hexo-generator-searchdb --save
```
step2: 在themes/hexo-theme-matery/_config.yml中添加下面配置
```
 search:
   path: search.xml
   field: post
```
本地搜索框导向了github
问题出现在这两个按钮重合在一起了，只要改下一样式就可以，解决方法有多种，自己可以用检查尝试，我是改的.//themes/hexo-theme-matery/source/css/matery.css 样式文件中的.head-container,如下：
```
 .head-container {
     position: absolute;
     padding: 0px 30px;
     width: 100%;
 }
```
将其改为：
```
 .head-container {
     position: absolute;
     padding: 0px 30px;
     width: 98%;
 }
```
只改动了一个占比，这样搜索框就可以出来了