Hexo博客搭建流程

本文最后更新于 2024年6月3日 下午

本文主要记录了自己搭建Hexo博客的流程,主要包括搭建Hexo博客、插件安装和主题美化。

步骤1-5主要为搭建Hexo博客,主要参考了知乎文章从零开始搭建个人博客(超详细),这里就不在赘述,只做补充。

1. 注册GitHub

https://github.com/

2. 安装Git

https://git-scm.com/download

Git下载与安装-CSDN博客

1
git --version  # 查看 Git 版本

3. 绑定GitHub并提交文件

1
2
3
git push -u origin main
# or
git push -u origin master

4. 安装node.js和Hexo

报错处理

  1. 注意在建立两个文件夹node_globalnode_cache时,需要右键设置“属性”,将用户具有完全属性的权限,否则在npm install webpack时会报错。

    感谢大佬!!!,其实直接以管理员身份运行cmd就行了。

5. 解析域名

  1. ping出来地址是ipv6。ping ipv4的方法:

    1
    ping github.io -4
  2. Hexo部署过程中可能会出现错误:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    fatal: unable to access 'https://github.com/a956551943/a956551943.github.io/': Encountered end of file
    FATAL {
    err: Error: Spawn failed
    at ChildProcess.<anonymous> (/usr/local/src/hexo/hanyubolg/node_modules/hexo-util/lib/spawn.js:51:21)
    at ChildProcess.emit (events.js:376:20)
    at Process.ChildProcess._handle.onexit (internal/child_process.js:277:12) {
    code: 128
    }
    } Something's wrong. Maybe you can find the solution here: %s https://hexo.io/docs/troubleshooting.html

    解决方式一:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    ##进入站点根目录
    cd /usr/local/src/hexo/hanyubolg/

    ##删除git提交内容文件夹
    rm -rf .deploy_git/

    ##执行
    git config --global core.autocrlf false

    ##最后
    hexo clean && hexo g && hexo d

    解决方式二:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    ##进入站点根目录
    cd /usr/local/src/hexo/hanyubolg/

    ##删除git提交内容文件夹
    vim _config.yml

    ##修改
    deploy:

    type: git

    repo: https://github.com/yourname/yourname.github.io.git
    # 改为
    # GitHub项目主页,点击绿色的Code,SSH
    repo: git@github.com:a956551943/weixiaohui.github.io.git

    branch: master

    ##最后
    hexo clean && hexo g && hexo d

    解决方式三:不建议

    1
    2
    3
    4
    5
    6
    7
    8
    ##进入站点根目录
    cd /usr/local/src/hexo/hanyubolg/

    ##进入depoly文件夹
    cd .deploy_git/

    ##强制推送
    git push -f

6. Hexo基本技巧

捋一遍文档 | Hexo就基本可以了。

7. 设置主题和主题美化

实现步骤:

  1. GitHub上搜索Hexo寻找自己喜欢的Hexo主题。我最终选择了Hexo Fluid主题。一款很成熟的主题,简洁大方,有官方中文教程。

  2. 安装Hexo Fluid主题

  3. 安装Hexo博客插件

  4. 主题美化

解决的一些问题:

  1. Hexo博客解决插入图片的路径问题

问题与解决

GitHub更换了用户名

  1. 修改你的GitHub仓库名为新用户名.github.io

  2. 修改./Blog根目录下的_config.yml

    1
    2
    3
    4
    deploy:
    type: git
    repo: git@github.com:新用户名/新用户名.github.io.git #你的新仓库地址
    branch: main
  3. 其它与你用户名有关的配置。

    1. Hexo Fluid主题的配置大致没什么需要更改的地方。
    2. Waline评论系统的配置无需更改。
  4. ./Blog根目录下打开Git Bash运行:

    1
    hexo clean && hexo g && hexo d

    重新进行部署。

  5. 打开博客网址验证更新。

  6. 大功告成。


Hexo博客搭建流程
http://zeyulong.com/posts/6d384a56/
作者
龙泽雨
发布于
2024年1月3日
许可协议