Hexo 部署博客时踩过的各种坑

最近参考各种教程用hexo搭了一个博客,在这里记录一下遇到的各种坑。

Deploy的步骤

不要在软件内置的终端里进行提交!!(比如Vs Code) 具体来说,过程如下 (npx 我个人需要加上),以 powershell 为例:

# 1.清除缓存
$ npx hexo clean
# 2.生成
$ npx hexo g
# 3.部署
$ npx hexo d

如果 hexo 部署之后却没有在网页更新,很有可能上述步骤有遗漏或者运行失败,按照上面的步骤来。

如果出现 remote: No anonymous write access. 等显示没有权限访问 github 的情况,有可能使用的终端不正确,尝试去用 git bash。

Hexo的数学渲染

由于 CSDN 的博客采用的是Katex,因此我也使用了Katex便于渲染,但是Katex已知有许多问题:(尚没有好的解决办法)

  1. $$ \[ 的数学公式需要另起一行并且不能有字符与\]相邻。
  2. Katex对于在左侧目录(toc)中的公式会连续渲染3遍
  3. Katex不支持对标题的渲染。

Hexo 插入本地图片

将图片放到source中的images下,然后直接引用 > ![](/images/xxx.png)

即可

改变图片大小

<img src='xxx' width=200 height=200>

Hexo 插入bilibili视频

只需要点击b站视频的分享然后复制嵌入代码,放到对应的md文件需要的位置即可。eg: 对应的复制出来代码:

<iframe src="//player.bilibili.com/player.html?aid=96349948&bvid=BV1mE41137MT&cid=165161227&page=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>

然后贴到md里就成了这样:

特殊字符处理方法

在 Markdown 中使用  无法转译的字符需要使用字符的命名实体或十进制编码。

Hexo 中 Markdown 特殊字符的处理方法

hexo 的基本操作

  1. hexo n "xxx" // 创建新文章
  2. 进入_post编辑文章
  3. hexo clean
  4. hexo g
  5. hexo d