0%

创建hexo,并让hexo支持公式

创建hexo

网上相关教程很多。
hexo项目的主页在https://github.com/hexojs/hexo
本来没什么可说的,就是依赖比较多:需要git、github账号、nodejs、npm

光我自己参考过的教程就很多了,比方说:

如何搭建自己的个人网站(上) | Zhang Yi
超详细Hexo+Github博客搭建小白教程 - 知乎

这是两个非常细致的教程,手把手喂饭了。对于熟悉git的人,可以看下边一篇简洁版的,重点讲node和npm的安装。
使用 Hexo 生成博客并发布

要注意的点是npm和nodejs在安装时可能会报错,我认为创建hexo基本都卡在这个上边。我遇到的两个问题:

  • hexo、npm和node版本不匹配
    hexo匹配的node版本:

hexo需要的node版本

  • 安装npm和node时没有给够权限导致安装失败

以上问题百度容易解决,但是难发现是这两个问题。

用hexo创建文章

这个,一旦hexo部署好,就能在自带的首页上看到hexo的使用方法。
无外乎:

1
2
3
4
5
6
hexo new "xxxx"
hexo g
hexo s
hexo d
hexo clean
hexo init

有些东西额外注意:

  • 主题目录和项目根目录下各有一个_comfig.yml配置文件,且后者优先级更高。
  • /home/ubuntu/blog/themes/next/languages 下有很多语言文件,可以找到汉语的,然后在配置里改“language:xxx”
  • /home/ubuntu/blog/scaffolds目录下都是一些模板,可以修改或增加模板。
  • 头像、网站图标、摘要都可以再打磨打磨。
  • NexT文章目录点击不跳转,可参考NexT中文目录不跳转的解决方法

更多玩法,可以参考这篇next文章目录跳转_Hexo系列 | Hexo+next主题搭建炫酷的个人博客网站

但我觉得做个人网站的初心是记录好的内容和经历,网站做得太花里胡哨就没意思啦。对网站的美化要适可而止。

让hexo支持公式

hexo加nexT,初始没有支持公式。我查了一些资料,发现越早的资料方法越复杂。这说明hexo对公式的支持还是越来越强的。我参考在 Hexo 博客中写出好看的Latex 公式,但是比它少安装两个插件,阴差阳错倒也成功了。

要做以下几步:

  1. 修改 主题配置中 的 mathjax 相关设置

搜寻主题配置文件里的“math”关键词,取消下方第二行的注释。

1
2
3
# MathJax
mathjax: //cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
# mathjax:

更改下方第二行为“enable: true”

1
2
3
4
mathjax:
enable: true
# See: https://mhchem.github.io/MathJax-mhchem/
mhchem: false
  1. 在文章头部声明“mathjax: true”
1
2
3
4
5
6
7
---
title: 跟据全景贴图求球谐系数
date: 2023-02-01 20:11:36
tags:
- SH
mathjax: true
---
  1. 重新编译以下
    1
    2
    3
    hexo clean
    hexo generate
    hexo s

截止2023年2月4号,配置如下的hexo用以上方法更改主题配置后公式渲染生效。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
ubuntu@VM-16-2-ubuntu:~/blog/source$  npm list
hexo-site@0.0.0 /home/ubuntu/blog
├── hexo-deployer-git@3.0.0
├── hexo-generator-archive@2.0.0
├── hexo-generator-category@2.0.0
├── hexo-generator-index@3.0.0
├── hexo-generator-search@2.4.3
├── hexo-generator-searchdb@1.4.1
├── hexo-generator-tag@2.0.0
├── hexo-renderer-ejs@2.0.0
├── hexo-renderer-marked@6.0.0
├── hexo-renderer-stylus@2.1.0
├── hexo-server@3.0.0
├── hexo-theme-landscape@0.0.3
├── hexo-theme-next@8.14.1
└── hexo@6.3.0