Hexo 个人博客搭建

很早之前看到别人搭建的个人博客,就想自己也搭建个,最开始接触的都是部署在服务器上,但个人没有稳定长期使用的服务器,就一直拖延下来,最近发现Hexo搭建个人博客很方便,并且可以托管在GitHub上,不用自己买服务器域名,唯一可能的缺点就是网速加载会慢些,但免费的要什么自行车,记录下搭建过程,作为第一篇博客😀

Github 创建账户

Github 网址 https://github.com/

直接按照指引注册即可,注册成功后新建一个仓库,后面加.github.io后缀,必须要同名,比如你的名字是 abc,那新建的仓库名字应该为 abc.github.io

安装git工具 网址 https://git-scm.com/

添加自己的账户信息,在桌面上邮件选择 git bash ,输入GitHub用户名和邮箱验证

1
2
git config --global user.name "用户名"
git config --global user.email "邮件地址"

配置SSH Key,使用ssh更安全些

1
ssh-keygen -t rsa -C "邮件地址"

然后连续按三次回车,会生成配置文件在用户目录\.ssh\id_rsa.pub 用记事本打开复制里面的内容,打开GitHub中新建仓库里的设置,选择Deploy keys,添加新key,将复制的内容粘贴到key中,至此GitHub部分准备完毕。

Hexo安装准备

Hexo官网 http://hexo.io

Hexo 需要 Node.js 环境,所以我们先安装 Node.js https://nodejs.org/zh-cn/ ,下载安装即可

验证是否安装成功,在桌面右键打开 git bash ,输入如下,能显示出版本号即为安装成功

123

1
2
3
4
5
6
# 安装Hexo,在cmd中输入
npm install -g hexo-cli
# 这样下载很慢,临时换用国内淘宝源,输入如下
npm install -g hexo-cli --registry https://registry.npm.taobao.org
# 永久生效
npm config set registry https://registry.npm.taobao.org

初始化Hexo环境

在磁盘中新建一个目录用来存储博客环境,进入文件夹右键打开 git bash ,输入hexo init初始化 hexo 环境

1
2
3
4
5
6
7
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

其中_config.yml文件用于存放网站的配置信息,你可以在此配置大部分的参数;scaffolds是存放模板的文件夹,当新建文章时,Hexo会根据scaffold来建立文件;source是资源文件夹,用于存放用户资源,themes是主题文件夹,存放博客主题,Hexo 会根据主题来生成静态页面。

1
2
hexo g # 生成
hexo s # 启动服务

执行以上命令之后,hexo就会在public文件夹生成相关html文件,这些文件将来都是要提交到github去。

打开浏览器访问 http://localhost:4000 即可看到内容

更换Hexo主题

选择使用的主题为Butterfly 详情及更换操作请看https://demo.jerryc.me/

部署到GitHub

Hexo本地预览没有问题后,准备将博客静态文件部署到GitHub上,修改博客根目录下的_config.yml文件,将deploy项改为自己的仓库地址

1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: 'git'
repo: https://github.com/username/username.git
branch: master

部署到git我们需要安装hexo-deployer-git插件,在blog目录下运行一下命令进行安装

1
npm install hexo-deployer-git --save

安装成功后可用hexo d命令自动部署到github上,部署成功后即可使用https://username.github.io/ 访问博客

使用过程中GitHub访问有时比较慢,还有时候找不到ip,所以准备换成国内的Gitee。

使用Gitee部署

Gitee网址 https://gitee.com/ 注册账户

由于Github创建的博客链接有时候加载很慢,后改成Gitee上部署。

新建仓库,仓库名字和用户名相同,只有名字相同才能让首页访问地址不带二级目录,若不相同需要更改Hexo中配置,详情请见Gitee的帮助文件:https://gitee.com/help/articles/4136

其余操作和上面一样,做过的可以不再重复

新建博客

根目录命令行输入hexo new <模板> <文章名>新建文章

其中<模板>scaffolds中,默认情况下有三个模板postdraftpage

参数 功能 路径
post 新建文章 /source/_posts/
draft 新建草稿 /source/_drafts/
page 新建页面(标签页,分类页等) /source/

通常情况下使用hexo new post <title>即可,注意这里的title不是文章名,具体文章中显示的文章标题可以在文章文件中修改。

新建完成后可以在/source/_posts/目录下找到新建的.md文件,打开编辑好后即可生成静态网页后部署