参考教程：fomal 魔改教程

项目源码：hexo-theme-Fomalhaut

博客搭建教程导航

注意事项

网络链接

  必须联网。即使不谈图床，有些基本的库文件都是需要网络加载的。例如要用到的部分前端三件套之一的 js 脚本，位置见文件_config.butterfly.yml，关键词为 inject 和 bottom。

勘误

  随着时间的更迭，原作者 Fomal 的教程和源码出现了部分严重的错误，在搭建博客时就需要注意。

npm 镜像源

  原文中的提到的淘宝镜像源已经被舍弃，更新了新的镜像源，具体内容如下。

npm 镜像源

原错误命令：

1
npm config set registry https://registry.npm.taobao.org

新正确命令为：

1
npm config set registry https://registry.npmmirror.com

  如果已经使用了错误镜像源，需要以下命令进行更改：

查看镜像源：

1
npm config get registry

清空缓存

1
npm cache clean --force

最后切换新源即可。

jQuery

  这真是一个很离谱的错误，错误现象为网站主题的美化设置、一些按钮、一图流背景都无法显示。

jQuery 文件错误

  错误来源于 js 脚本 jQuery 错误。jQuery 是一个 JavaScript 工具库，对 HTML 的元素和功能提供方便的支持。这就是原因所在。

本地文件_config.butterfly.yml，关键词为 inject、bottom 和 jQuery。本地文件调用了该库，原代码如下：

1
- <script src="https://cdn.staticfile.org/jquery/3.6.3/jquery.min.js"></script> # jQuery

浏览器报错内容为：

1
Uncaught SyntaxError: Unexpected end of input(at jquery.min.js:2:85449)  jquery.min.js:2

查看 jquery.min.js 文件，发现结尾处异常，没有函数闭合结束符号 });。由于这个脚本源自网络，所以原因大概是托管源代码的网站的源码文件被错误修改。解决办法为将 jQuery 版本更换为 3.6.0，博客功能立刻正常。而在崩溃了一段时间后（至少两周），使用 3.6.3 版本文件再次正常，说明问题已经修复。

编译环境

  查看 hexo 和主题 butterfly 的版本：

1
hexo version

结果如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
butterfly 4.3.1
hexo: 6.3.0
hexo-cli: 4.3.1
os: win32 10.0.19045
node: 20.10.0
acorn: 8.10.0
ada: 2.7.2
ares: 1.20.1
base64: 0.5.0
brotli: 1.0.9
cjs_module_lexer: 1.2.2
cldr: 43.1
icu: 73.2
llhttp: 8.1.1
modules: 115
napi: 9
nghttp2: 1.57.0
nghttp3: 0.7.0
ngtcp2: 0.8.1
openssl: 3.0.12+quic
simdutf: 3.2.18
tz: 2023c
undici: 5.26.4
unicode: 15.0
uv: 1.46.0
uvwasi: 0.0.19
v8: 11.3.244.8-node.25
zlib: 1.2.13.1-motley

编译命令

  本文记录利用hexo操作博客的命令。

清理博客：

1
hexo clean

生成博客：

1
hexo generate

上传博客到服务器：

1
hexo d

运行本地服务启动博客：

1
hexo s

综上所述：

1
hexo clean; hexo generate; hexo d; hexo s

调试方法

  启动本地服务器后，修改博客文章的内容并保存后，对应 localhost 网页内容会自动修改，在网页端刷新即可，不需要重新编译和启动。除此以外本地更改，网页端后没反应的情况，项目需要重新编译。

  出现异常，可以在浏览器上键入 F12，进入源代码模式，查看报错。从上到下，依次解决报错，博客就会显示正常。

设置部署网址

  在 hexo 配置文件 _config.yml 中有如下代码：

1
2
3
4
deploy:
  - type: git
    repository: https://github.com/Adonothing/adonothing.github.io.git # 这里写上你的Github地址
    branch: main

在此处进行修改即可。

关于我

  在 ../personal/about/index.md 里修改。