一篇非常啰嗦的Hexo搭建教程

前言

本来想写一篇长文的,但精神不济,所以各位就凑活看视频吧

一些链接

  • Node.js 必需的环境 安装最新版Node.js。
  • git 必需的环境 版本控制,管理代码。
  • watt toolkit国内访问GitHub就靠它了
  • npmmirror源淘宝NPM镜像源
  • Hexo博客官网,可以查找更多主题
  • GitHub需要有一个GitHub账号,用来保存你的代码。
  • Vscode方便后续操作非必需

一些命令

验证Node.js和npm版本

1
2
3
node -v
npm -v
git -v

如果显示版本号,则代表安装成功。

安装Hexo

1
npm install -g hexo-cli

如果网络被阉,可以使用阿里云镜像源进行安装:

1
2
npm install -g cnpm --registry=https://registry.npmmirror.com
cnpm install -g hexo-cli

初始化Hexo项目

选择一个位置创建Hexo项目文件夹:

1
hexo init laogou

卡死了可以直接按下 CTRL+C 终止。
然后CD进入项目目录:
1
cd laogou

手动切换阿里镜像源安装项目依赖:
1
cnpm install

出现SSL错误,可绕过证书验证(仅用于开发环境):

1
git config --global http.sslVerify false

选择并安装主题

  • 选择一个Hexo主题,例如Butterfly。
  • 访问主题的GitHub页面,点击Code,下载压缩包。解压缩包到Hexo项目的themes目录下。或者直接通过git进行克隆
  • 修改Hexo根目录配置文件_config.yml(非主题的_config.yml)
    设置主题:
    1
    theme: butterfly

本地生成和预览

  • 清理缓存:
    1
    2
    hexo clean
    # 或者简写为 hexo c 或 hexo cl
  • 生成静态文件:
    1
    2
    hexo generate
    # 或者简写为 hexo g
  • 启动本地服务器进行预览:
    1
    2
    hexo server
    # 或者简写为 hexo s
    在浏览器中访问http://localhost:4000查看效果。

推送或部署到GitHub

  • 确保已经在GitHub上创建了一个仓库。
  • 安装Hexo部署插件:
    1
    2
    3
    4
    官方源
    npm install hexo-deployer-git --save
    阿里源
    cnpm install hexo-deployer-git --save
  • 配置Hexo部署信息,在_config.yml文件中的规范写法:
    1
    2
    3
    4
    deploy:
    type: git
    repo: https://<你的访问令牌>@github.com/你的用户名/你的仓库名.git
    branch: main
    例如:
    1
    2
    3
    4
    deploy:
    type: git
    repo: https://[email protected]/GGB60/blog.git
    branch: main
  • 推到GitHub:
    1
    2
    hexo deploy
    # 或者简写为 hexo d

使用免费容器进行部署

总结

通过以上步骤,你应该已经成功安装并配置了Hexo博客,并且能轻易将其部署到互联网。