本篇文章介绍了使用hexo+github创建博客的主要流程。我也是在考虑各方因素之后,选择了github.io的方式。优点嘛,就是免费加开源yyds!好了,进入正题。

1、搭建本地环境

1.1下载并安装nodejs

安装时一路默认即可。

测试:打开cmd,输入以下测试,出现版本号即表示成功

1
2
3
node -v

npm -v

1.2下载并安装git

安装时也一路默认即可。

测试:打开cmd,输入如下测试,出现版本号

1
git --version

并且在桌面右键鼠标,出现如下两个图标即表示成功

2、注册Github账户(已有账户的可跳过此步)

2.1进入github官网,注册账号即可

2.2注册完成后,连接github

在桌面右键,选择Git Bash Here,设置用户名和邮箱(创建github账户时的用户名和邮箱)

1
2
3
git config --global user.name "Github 用户名"

git config --global user.email "Github 邮箱"

3、添加加密密钥

3.1创建ssh密钥

先检查一下本地是否有.ssh文件夹:

1
cd ~/.ssh

如果没有,则直接进入接下这一步,有的话,可以修改路径等

1
ssh-keygen -t rsa -C "Github 邮箱" #注意ssh-keygen是直接连起来的,中间没有空格

默认回车,创建完成后,可得到两个文件(因为.ssh为隐藏文件,如果没有找到.ssh项目,可以先检查一下自己的文件是否勾选隐藏的项目。.ssh的默认路径为:C:\users\用户名.ssh)

1
2
3
id_rsa

id_rsa.pub

3.2添加ssh密钥到github账户

将id_rsa.pub的内容全部复制下来,

进入github,点击setting页面,然后选择左边栏的 SSH and GPG keys,点击 New SSH key。

Title随便命令,将复制下来的id_rsa.pub的内容粘贴到Key中,点击Add SSH key 完成添加。

3.3验证连接

在桌面右击鼠标,选择Git Bash Here,输入

1
ssh -T git@github.com

出现以下图片即表示成功:

4、创建github仓库

  • GitHub 主页右上角加号,选择 New repository

  • Repository name 中输入:用户名.github.io

  • Description 选填

  • 勾选 “Add a README file”

注意:最新版的GitHub的默认分支为main,从下图可以看到(也可以自行更改为其他分支)

创建后,博客地址为:https://用户名.github.io

5、安装hexo

5.1安装

使用我们前面的环境npm即可一键安装hexo程序

鼠标右击,选择Git Bash Here,输入:

1
npm install -g hexo-cli

5.2测试

检查是否安装成功:

在cmd或者Git Bash Here里面输入:

1
hexo -v

出现相关版本号即可

5.3初始化并安装所需组件:

先新建一个文件夹,在该文件夹下右击鼠标,选择Git Bash Here,输入:

1
2
3
hexo init    #初始化

npm install #安装组件

或者,直接这样运行:

1
2
3
4
5
hexo init 文件名称

cd 文件路径

npm install

完成后,启动服务器进行预览:

1
2
3
hexo g     #生成静态页面,或者hexo generate

hexo s #启动服务,或者hexo server

此时访问:http://localhost:4000,出现hexo默认页面,表示安装成功

6、部署hexo到GitHub Pages

前面五步已经能够实现在本地访问hexo,我们的真正目的是使其部署到GitHub Pages,通过网络能够访问它。

6.1安装git部署插件hexo-deployer-git

1
npm install hexo-deployer-git --save

6.2修改_config.yml站点配置文件

在你之前创建的目录下,找到_config.yml文件,并用记事本打开,

修改末尾的Deployment 部分,

注意:冒号后面一定记得有个空格!!!

1
2
3
4
5
6
7
deploy:

type: git

repository: git@github.com:用户名/用户名.github.io.git

branch: main

其中,

repository后面的地址可从如下图所示直接复制过来

branch后面是前面提过的默认分支,默认为main,可以修改为其他的,我把默认分支修改为了master(那就要修改为branch: master),修改方法如下:

6.3发布文章

进入之前所创建的hexo的所在目录,右键Git Bash Here ,输入

1
2
3
4
5
hexo new "first" #创建名为"first"的文章,""里面的标题可自行命名

hexo g #生成静态页面

hexo d #将文章部署到GitHub pages,或者hexo deploy

此时,访问我们的GitHub域名,即:https://用户名.github.io 就可以看到hexo网站啦!`

常用的hexo命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
hexo new "name"         # 新建文章

hexo new page "name" # 新建页面

hexo g # 生成页面

hexo d # 部署

hexo g -d # 生成页面并部署

hexo s # 本地预览

hexo clean # 清除缓存和已生成的静态文件

hexo help # 帮助

hexo --debug # 调试模式