在上一篇中已经用 Hexo 做出了简单的博客。但这仅仅是基础,在基础之上,还有许多工作需要完成,包括但不限于下述问题:
- 修改 URL 形式
- 修改导航栏
- 创建 About 页面
- 添加 MathJax 支持
- 添加 Jupyter Notebook 支持
- ……
请和我一起来解决这些问题。
修改 URL 形式
页面从 md 文件渲染成 HTML 以后,会发现其 URL 形式是 根目录网址/年/月/日/文件名
如果我想要把 URL 形式改成 根目录网址/类别/文件名
怎么办呢?
打开根目录下的 _config.yml
(全局配置文件),找到这一行:
permalink: :year/:month/:day/:title/
改成下面这样即可:
permalink: :category/:title/
当然,这要求在每一篇文章的开头都加入 categories: <value>
字段,把 <value>
替换成文章对应的分类。没有该字段的文章,被会分到 uncategorized
分类下。
所有可用于配置 permalink 的变量见 https://hexo.io/zh-cn/docs/permalinks
注:Hexo 没有提供 Pelican 中 slug 这样的变量/配置项,但提供了
:title
这个变量——因此要实现 slug,只要修改文件名,然后在 permalink 中使用:title/
即可。
修改导航栏
修改主题文件夹下的配置文件即主题配置文件 _config.yml
中的 nav
(或 menu
之类的字段)值即可。
再次提醒:修改的是 主题配置,而非全局配置!!!例如采用 Daily 主题,则修改
blog/themes/Daily/_config.yml
例如,原来为:
nav:
home: .
archive: archives
about: about
效果是
现在为:
nav:
home: .
archive: archives
category: categories
about: about
效果是:
创建 About 页面
键入如下命令:
$ hexo new page about
打开 source/about/index.md
,修改该文件的内容。然后渲染生成,即可得到下图效果:
添加 MathJax 支持
Hexo 要使用 MathJax 这个 JS 库来实现对 LaTex 公式的渲染,有 2 种方法
1. 使用 Jacman 主题
参考 Jacman 作者原文:
首先在博客根目录下执行:
$ git clone https://github.com/wuchong/jacman.git themes/jacman
然后修改根目录下配置文件 _config.yml
,注意除了修改 theme
值以外剩下加入的那两行是为了压缩 CSS 文件:
theme: jacman
stylus:
compress: true
然后在文章开头 front-matter 部分,即类似如下内容的部分中
---
title: test
date: 2016-08-16 10:32:50
tags:
---
加入一个字段 mathjax: true
(注意:1.冒号是半角冒号;2. 冒号之后有个半角空格)即可。以上面那个 front-matter 为例,即改成这样:
---
title: test
date: 2016-08-16 10:32:50
tags:
mathjax: true
---
然后就可以在文件中用 LaTex 语法书写数学公式了。
2. 使用其他主题,配合 hexo-math 插件
[2018-12-09 16:02] 注:本文太久没更新了。该插件已过时,新的插件可参考这个方案,具体我还没实验过。
第一,安装 hexo-math
插件:
$ npm install hexo-math --save
第二,也是最奇怪的一点:要在 _config.yml
中添加下述文字:
plugins:
- hexo-math
问题就在于执行完第 2 步后,hexo clean
+ hexo s -g
无论如何都无法挂到本地,总是提示:
INFO [hexo-math] Using engine 'mathjax'
甚至无法部署:
$ hexo d
INFO [hexo-math] Using engine 'mathjax'
ERROR Deployer not found: git
于是 Google 一搜,找到了这里
把plugins 清空就没问题,这两天都在被这问题折腾
于是我就尝试把 _config.yml
中刚加入的 plugins 部分删除,然后成功 hexo clean
+ hexo s -g
+ hexo d
……
也不知道这是为什么。
增补 20160816:删除博客文件夹从头开始做了 2 遍以上,推测只要执行第 1 步
npm install hexo-math --save
即可,然后就可以在文件中用 LaTex 语法书写数学公式了。
然后我 new
了一篇新文章测试:
$F_{\mu}$
$F_a + F_b = F_c$
渲染成功,如图所示:
3. LaTex 公式渲染与 Markdown 渲染冲突问题
Markdown 解析和 LaTex 公式解析时出现冲突,典型情况就是:如果希望 LaTex 公式中的下划线 _
解析成功,必须写成 \_
强制转义。这是说,如下的公式:
$F_a = F_b + F_c + F_{\mu}$
在 Jacman 主题下的渲染效果是:
必须写成这样:
$F\_a = F\_b + F\_c + F\_{\mu}$
才能渲染成功:
在其他主题下安装 hexo-math
插件的渲染效果也是一样的问题:
必须要改成
$F\_a = F\_b + F\_c + F\_{\mu}$
才能正常渲染……
但是现在有一个更简单的解法
这个问题有一种更简单的、不用大规模改动 LaTex 公式的解法:使用 {% raw %}{% math %}LaTex Formula{% endmath %}{% endraw %}
来替代 $LaTex Formula$
的表达,即:
公式是这样的 {% math %} F_a = F_b + F_c + F_{\mu} {% endmath %},你必须理解它,才能看懂下面这些公式:
{% math %}
\begin{aligned}
\dot{x} & = \sigma(y-x) \\
\dot{y} & = \rho x - y - xz \\
\dot{z} & = -\beta z + xy
\end{aligned}
{% endmath %}
效果就是这样的:
这个解法来自于这篇文章下方 1MHz、路箩筐、oaright 的对话给我的启发。
类似的解法还有一个:使用
{% raw %}{% raw %}$LaTex Formula${% endraw %}{% endraw %}
来替代$LaTex Formula$
,使用{% raw %}{% raw %}$$LaTex Formula$${% endraw %}{% endraw %}
来替代$$LaTex Formula$$
添加 Jupyter Notebook 支持
参考这篇文章,只要现进入该网站:
在输入框中输入
- 你的 GitHub 用户名
- 你的 GitHub 用户名/仓库名
- Gist ID
点击「Go!」,找到你需要的那个文件,复制此时地址栏的 URL,例如
http://nbviewer.jupyter.org/github/fengdasuk19/MLandDS/blob/master/MachineLearning4Theory_AndrewNg_Coursera.ipynb
然后将该 URL 填入下述代码中,并将该代码放入你的博客文章中即可:
<iframe src="your_URL" width="700" height="400"></iframe>
其中 width
与 height
值用于调整 nbviewer 在你的文章中展示的尺寸。效果如图
如果不想用这种嵌入的办法,也可以打开 Jupyter Notebook 将你的交互笔记导出为 md 格式的文件,File -> Download as -> Markdown (.md)。如图
自定义首页
Hexo 默认首页是汇总整个站点的所有文章(哪怕是通过分页,也是「汇总」的另一种表现形式而已)。如果我用 Hexo 来部署一个简单的站点,但又不想让首页展示这个汇总页,想让首页展示指定的某个页面,有没有可能呢?
如果你采用的是生成静态页面、然后把静态页面拷贝到 GitHub Pages repo 中的做法进行站点部署,那么对于自定义首页有一种简单的方法:
- 使用
hexo new page "diy_index"
创建一个名为diy_index
的自定义页面。然后随意修改这个页面吧,它的内容就是将来首页的内容 - 然后通过
hexo generate
生成静态文件后,把生成的文件全部拷贝到 GitHub Pages repo 中 - 删除 GitHub Pages repo 根目录下的
index.html
文件 - 移动到 GitHub Pages repo 根目录下,在命令行中创建一个软链接:
cd $REPO_ROOT && ln -s diy_index/index.html index.html
- 把更新推到 GitHub 上
静待几分钟,就生效了:你将看到,你部署的网站首页不再是所有博客汇总,而是 diy_index
页面内容。