hexo+github博客搭建踩坑记录

最新推荐文章于 2024-01-07 11:18:52 发布

原创最新推荐文章于 2024-01-07 11:18:52 发布 · 243 阅读

0 ·

CC 4.0 BY-SA版权

各种基础知识专栏收录该内容

40 篇文章

订阅专栏

本文档记录了使用Hexo搭建个人博客的过程，包括版本信息、常用命令及遇到的问题。在图片处理上，介绍了如何在不使用图床的情况下管理分类图片。在构建博客时遇到的错误通过清理公共目录解决。还分享了几个参考资料链接，帮助读者更好地理解和配置Hexo博客。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

博客效果：fa1lr4in's blog

具体的搭建过程下面的参考链接中已经有了，下面是常用的命令以及我踩过的坑

版本信息，主题使用了keep，版本3.4.2

$ npx hexo version
INFO  Validating config
hexo: 5.4.0
hexo-cli: 4.2.0
os: Windows_NT 10.0.19042 win32 x64
node: 14.16.0
v8: 8.4.371.19-node.18
uv: 1.40.0
zlib: 1.2.11
brotli: 1.0.9
ares: 1.16.1
modules: 83
nghttp2: 1.41.0
napi: 7
llhttp: 2.1.3
openssl: 1.1.1j
cldr: 37.0
icu: 67.1
tz: 2020a
unicode: 13.0

各种备忘

安装npm库

npm install hexo-wordcount
npm install hexo-generator-searchdb
npm install hexo-generator-feed
npm install hexo-deployer-git --save

常用命令

npx hexo g            #由md构建html
npx hexo s            #本地开启http服务器验证博客
npx hexo d            #同步到服务器上面，类似于git push
npx hexo n "article"  #新建新的文章

目录结构

主要是node_modules存放主题的配置，public是发布到网站的页面，source是我们的源文件。

可以形象的理解为source存放源代码，public存放编译后可执行程序。需要通过npx hexo g来进行编译

踩过的坑

1、静态图片

如果你想将图片分类的在自己的文件夹中，不用图床（将图片托管于其他服务器上），你可能需要

https://hexo.io/docs/asset-folders

之后可以在文章的html文件验证下链接是否形如

~~之前找过的~~

~~https://www.cnblogs.com/codehome/p/8428738.html?utm_source=debugrun&utm_medium=referral~~

~~这个方式，结果这个项目已经不维护了，害得我重新装了一遍hexo~~

2、npx hexo g 问题

当我构建静态页面时报了这个错误

提示我找不到scroll属性了，但是在主题的配置yml文件中是存在的，困扰了我好一阵，最终一行命令解决

npx hexo clean

如果出现一些莫名其妙的问题，可以先执行hexo clean来清理一下public的内容，然后再来重新生成和发布。

参考链接

http://blog.haoji.me/build-blog-website-by-hexo-github.html

https://hexo.io/docs/

https://xpoet.cn/2020/04/Keep-%E4%B8%BB%E9%A2%98%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97/

https://www.zhihu.com/question/31377141