Hexo Material Theme Notes | ComyDream Studio

此页面用于汇总在使用 Hexo Material Theme 时遇到的问题及解决方案。

Hexo Docs

Material Theme Docs (Mirror)

Material Design Icons

针对 TOC 不可用

我原来在 Hexo 文件夹下装了 hexo-toc 插件，然而在使用 Material 主题时，点击 TOC 并没有跳转至对应的位置，可以发现地址栏变成了：

1. ../#undefined

一直持续了很久很久不知道原因。后来发现把 hexo-toc 插件卸载就可以让功能正常了。

在 Hexo （站点）文件夹下运行命令：

1. npm uninstall hexo-toc

针对公式块不能渲染

修改默认的render

hexo 默认的渲染引擎是 marked，但是 marked 不支持 mathjax。 kramed 是在 marked的基础上进行修改。我们在 hexo 目录下执行以下命令来安装 kramed ：

1. npm uninstall hexo-renderer-marked --save
2. npm install hexo-renderer-kramed --save
3. npm uninstall hexo-math --save
4. npm install hexo-renderer-mathjax --save

修改kramed的渲染细节

在 /node_modules/hexo-renderer-kramed/lib/renderer.js，找到：

1. // Change inline math rule
2. function formatText(text) {
3. // Fit kramed's rule: $$ + \1 + $$
4. return text.replace(/`\$(.*?)\$`/g, '$$$$$1$$$$');
5. }

1. // Change inline math rule
2. function formatText(text) {
3. return text;
4. }

在 /node_modules/kramed/lib/rules/inline.js 找到（11行）：

1. escape: /^\\([\\`*{}\[\]()#$+\-.!_>])/,

1. escape: /^\\([`*\[\]()# +\-.!_>])/,

在同个文件中找到（20行）：

1. em: /^\b_((?:__|[\s\S])+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,

1. em: /^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,

配置 Material 主题的 Mathjax 加载的 CDN 链接

在主题配置文件（material/_config.yml）下添加：

1. vendors:
2. # MaterialCDN
3. # You can load theme unique files from your private cdn or oss.
4. # The new src will have the base domain you configured below.
5. # MathJax 2.7.0-2.7.1
6. mathjax: https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js

这样，在需要用到 MathJax 的md文件头中，填入：

1. mathjax: true

针对摘要显示

在想显示的文字末尾添加语句：

1. <!--more-->

这样，它之后的内容都不会显示到摘要中。

添加站内搜索

需要先安装插件：

1. npm install hexo-generator-search --save
2. npm install hexo-generator-searchdb --save

在 站点配置 文件中，添加（或搜索）：

1. search:
2. path: search.xml
3. field: post

在 主题配置 文件中，搜索并将 use 的值改成 local ：

1. # Search Systems
2. # Available value:
3. # swiftype | google | local
4. search:
5. use: local
6. swiftype_key:

ERROR …\material\layout\layout.ejs:3

在构建时报错信息如以上，请尝试使用 2018 年前的版本，可在Releases · bolnh/hexo-theme-material中下载 1.52 及以前的版本。

原因可能是主题配置文件 _config.yml 不匹配。

为新建的页面添加 TOC

通过 hexo new page "page-name" 添加的页面默认不显示 TOC（左上角第二个图标）。

可在 Front-matter 中添加：

1. toc: true

即可显示。

针对连接不安全 Dec. 11, 2019

此条是 Hexo 插件的问题

使用免费的 .github.io 域名的网站默认都是 https，但是我发现地址栏提示连接并不安全。

使用 F12 检查工具，Ctrl + Shift +R 重新加载页面，在【Network】选项卡下可以发现与 Mathjax 有关的资源标红了，协议用的是 http 。原来如此，因为它也开放了 https 协议端口，只需把 http 改成 https 就行了。

到哪里改，在 Hexo 目录下看到 node_modules，到里面通过 grep 命令寻找和 Mathjax 有关代码，找到 hexo-renderer-mathjax/mathjax.html ，找个编辑器打开，将 <script> 中的 src 中的 http 改成 https 即可。

现在可以完整提供 https 支持啦~

公式中的星号渲染错误 Dec. 17, 2020

因 Markdown 中星号用于实现加粗和倾斜，故若公式中存在星号，可能导致渲染不合预期。

其实可以使用 \ast 表示星号，效果为 ∗∗ 。

跳过指定文件的渲染 Apr. 2, 2021

配置 - Hexo

跳过指定文件的渲染。匹配到的文件将会被不做改动地复制到 public 目录中。

修改站点配置文件，即根目录下的_config.yml。

找到skip_render参数。

1. skip_render: "mypage/**/*"
2. # 将会直接将 `source/mypage/index.html` 和 `source/mypage/code.js` 不做改动地输出到 'public' 目录
3. # 你也可以用这种方法来跳过对指定文章文件的渲染
4. skip_render: "_posts/test-post.md"
5. # 这将会忽略对 'test-post.md' 的渲染

执行 hexo deploy 命令时提示：

1. Please make sure you have the correct access rights
2. and the repository exists.

或者在最后卡住：

1. [master XXXXXXXX] Site updated: 2021-XX-XX 09:51:34

很可能需要重新生成 SSH 公私钥对。

重新配置 Git 的用户名及邮箱（用户名、邮箱换成自己的）：

1. git config --global user.name "yourname"
2. git config --global user.email“[email protected]"

打开目录（将 yourname 替换成你的用户名）：

1. C:\Users\yourname\.ssh

删除 known_hosts 文件，然后使用命令（邮箱换成自己的）：

1. ssh-keygen -t rsa -C "[email protected]"

在过程中直接按两次回车，系统会在 .ssh 文件夹生成 id_rsa 和 id_rsa.pub 两个文件。

打开 GitHub 密钥设置页面，可以将之前的 SSH 密钥删除，然后新建，用任意编辑器打开 id_rsa.pub 文件，将内容复制粘贴进去。

在 Git 中输入命令：

1. ssh -T [email protected]

输入 yes 回车。over。

本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明来自 ComyDream 。
本文链接：http://comydream.github.io/2019/01/20/hexo-material-issues/