前言

写此篇文章的初衷就是当一个完全不懂的小白可以看着此篇教程后就可以完成自己的Hexo博客搭建。

这篇文章分为三部分:

第一部分:安装环境

第二部分:安装Hexo

第三部分:部署到Github或者Coding或者码云

安装环境

安装node.js与git

这里的安装环境主要指的是GitNode.js环境,因此我们的后续操作都是建立在了这两个的基础上。

安装下载非常简单,遇到不懂的点下一步即可。但是需要注意的是添加完成后需要添加环境变量,一般情况下它会默认帮你添加上,如果没有添加也不需要担心,我们手动添加即可。

  • 检查是否正确安装

    打开cmd,输入node -vgit --version,如果能输出信息则表示成功。

  • 手动配置环境变量

    选择Path,然后点击编辑。然后将你的安装目录写在里边即可,如果两个都没有则需要写两个目录(git与node)直到可以使用git与node为止。

安装Hexo

这里首先说明下,npm的仓库在国外,这就意味着下载可能非常慢,或者不可以下载。因此我的解决方案是用淘宝的镜像源替代。更多

替代方案很简单只需要在命令行输入npm install -g cnpm --registry=https://registry.npm.taobao.org即可,然后每次需要使用npm命令时,将npm换成cnpm即可。

我这里使用以上解决方案,因为实在是慢

以上内容非必须,你完全可以不适用淘宝的镜像源,而使用官方的下载方式。即将本教程的cnpm xxxx命令换成npm xxxx即可。

  1. 安装Hexo

    cnpm install -g hexo-cli

    安装完成后依旧使用hexo -v查看以下版本号。

  2. 初始化一个Hexo博客

    在任意位置创建一个文件夹,你的博客将出现在这个文件夹。

    然后我们用命令行进入这个文件夹。如果你是Windows用户,可以使用shift+鼠标右键,然后选择PowerShell。快速进入这个文件夹哦

    输入命令hexo init .,然后程序会自动克隆一个Hexo项目到你当前目录。克隆过程中可能速度稍慢,可需要耐心等一会儿。

    看到这样的结果,那就说明已经初始化完成了一个Hexo博客。

  3. 查看Hexo博客

    Hexo博客是自带服务器的,所以我们可以通过hexo s命令查看

    看到图片上的提示那么此时打开浏览器输入http://127.0.0.1:4000即可查看到博客。

  4. 安装一个主题

    这里我是用sakura主题 github地址文档地址

    此主题较为特殊,此主题需要将GitHub下载的文件在Hexo根目录解压,如果出现重复覆盖即可。关于此主题的更多内容请参考官方文档。

    如果你没有选择此主题,请注意你所选用的主题是否需要放在themes文件里

    请选择完主题后按照主题官方文档进行配置。

部署发布

我们使用ssh免密部署。

创建密钥对

为了方便运行GitHub Actions时登录GitHub账号,我们使用SSH方式登录。就是要把设备的私钥交给GitHub Actions,公钥交给GitHub,需要去Settings里去配置。

1
2
3
ssh-keygen -t rsa -C "Github 的邮箱地址"

如 ssh-keygen -t rsa -C "123123123@gmail.com"

密钥对生成后默认的位置是用户文件。以windows为例:密钥对文件在C:\Users\用户名里,其中Users可能因为系统原因显示的是用户。这个文件夹里会有一个.ssh的目录,这个里面就是我们的密钥对。

其中id_rsa是私钥,id_rsa.pub是公钥。

  • 配置公钥,应该已经配好,不然如何上到的项目资源,配置路径:github网站–>Settings–>SSH and GPG keys


    新增一个公钥,然后把id_rsa.pub这个文件用文本文档打开,将内容复制进去。

  • Coding与GitHub类似

    在这里将你的公钥添加进去即可。

配置部署信息

登录GitHub或者是coding新建一个仓库,用于公开你的博客信息。

GitHub请以用户名.github.io命名仓库名,例如我的antmoe.github.io

创建好仓库复制ssh连接。

填到hexo博客根目录下的_config.yml文件中

1
2
3
4
5
6
deploy:
type: git
repo:
github: 你的地址
coding: 你的地址
branch: master

然后输入命令cnpm install hexo-deployer-git --save,否则无法使用自动部署。

然后输入命令hexo cl && hexo g && hexo d即可完成部署。

更多关于hexo高级部署请参考我的博客