avatar

这次使用hexo + github搭建博客花了许多时间,所以决定自己写一篇教程以方便后来者,如有不足处请海涵,同时欢迎指正。

Git 和 node.js 安装

到浏览器上下载 Git (https://git-scm.com/download/win) 和 node.js (https://nodejs.org/en/download/current)。

安装和初始化 hexo

先在你认为方便的地方创建一个文件夹,这个文件夹会用来存放你搭建博客所使用的包括后续发表的博客的文件。然后打开这个文件夹,右键显示更多选项,选择 Open Git Bash Here,接着在弹出的黑色窗口中输入 npm install -g hexo-cli ,安装 Hexo。

1
npm install -g hexo-cli

安装完后输入 hexo -v ,若有版本号出现,说明安装成功了。

1
hexo -v

最后输入 npm install ,安装插件。

1
npm install

做完这一切后,原本空空的文件夹里会有:
node_modules
public
scaffolds
source
themes
_config.yml。
如果这些文件都有,那说明这一步已经大功告成了。

Github 账号注册并创建个人仓库

打开 Github 网站(https://github.com),注册个人账号。然后在主页创建一个新的个人仓库,!!!注意:个人仓库命名要与自己的用户名一样。

生成ssh密钥添加到 Github

在之前的黑色窗口中,输入指令

1
2
git config --global user.name "Github 用户名"
git config --global user.email "Github 邮箱"

接着输入以下指令,检查是否有输入错误。

1
2
git config user.name
git config user.email

最后就是创建ssh。
输入以下指令

1
ssh-keygen -t rsa -C "Github 邮箱"

然后输入

1
cat ~/.ssh/id_rsa.pub

将系统输出的一串字符复制。
打开Github,在头像下点击settings,然后点击SSH and GPG keys,新建一个ssh,名字随意,将刚刚复制的那一串字符粘贴到框里。
在黑色窗口中,输入以下指令

1
ssh -T git@github.com

如果系统输出了你的用户名,那说明成功了。

将 hexo 部署到 Github

打开之前创建的文件夹,打开 _config.yml 文件,直接滑到底,找到 deploy ,补充修改为

1
2
3
4
deploy:
type: git
repository: https://github.com/用户名/用户名.github.io.git
branch: main

然后安装 deploy-git ,即在黑色窗口输入以下指令

1
npm install hexo-deployer-git --save

如果报错,那就需要先输入以下指令

1
npm install -g cnpm --registry=https://registry.npm.taobao.org

然后再输入

1
cnpm install hexo-deployer-git --save

结束

在黑色窗口依次输入以下指令

1
2
3
4
hexo clean
hexo g
hexo d
hexo s
接下来,稍等一段时间,最多不到半小时,你就可以在浏览器输入 用户名.github.io 查看你的博客了。

avatar