个人主页搭建备忘录

在这里记录一下主页的搭建过程,以免日后遗忘。

框架 Hexo
主题 Fluid

搭建过程中主要存在图片无法显示、公式编译器等问题,下面主要记录公式编译器的安装。这里并没有使用hexo官方的hexo-math插件,也许以后遇到问题会更换。目前使用的版本使fluid主题内置的公式渲染器,其支持katex的渲染。

在这里,建议优先换源

1
npm config set registry https://registry.npmmirror.com
1
2
3
npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-markdown-it-plus --save
npm install @traptitech/markdown-it-katex --save

然后在站点配置中添加:

1
2
3
markdown:
plugins:
- "@traptitech/markdown-it-katex"

Q1

长时间不操作,或者由于在drive里操作,会出现:

1
2
3
ERROR Cannot find module 'hexo' from 'xxx\xxx\xxx'
ERROR Local hexo loading failed in xxx\xxx\xxx
ERROR Try running: 'rm -rf node_modules && npm install --force'

这时候把它拷贝到本地再

1
npm install --force

Q2

出现TypeError: Cannot read properties of undefined (reading 'enable_sync')

删除 your_path_to/Blog/node_modules/hexo-leancloud-counter-security这个文件夹即可。

Q3

显示图片

把config.yml中的内容做一些修改

1
2
3
4
post_asset_folder: true
marked:
prependRoot: true
postAsset: true

然后可以通过这两种方式插入图片:

![test](fig1.png)
<img src="/2024/12/18/buildhelp/fig1.png" alt="test" width="500"/>

如果依然无效记得检查是否hexo clean,另外在draft状态时似乎图片不会被部署,所以看不到也正常。

注:

本博客使用的插件:


个人主页搭建备忘录
http://dufolk.github.io/2024/12/18/buildhelp/
作者
Dufolk
发布于
2024年12月18日
许可协议