本文目的是为节省读者在刚开始部署博客遇到部分小问题时要解决处理而花费的不必要时间。

本文适合从零开始的读者,在刚开始部署博客时,大致浏览本文。

你可以只看仓库创建 Hexo 分支页内跳转,详细教程应当参考其它更加优质的博文。

本人参考的文章 顺序 推荐如下:

官方 个人
Hexo 网站搭建
hexo-theme-next 一小时搭建完自己的个人网站
hexo-theme-butterfly 使用hexo,如果换了电脑怎么更新博客?

本篇文章题目是总结1,主要总结在博客从开工到能实际运行起来所遇到的部分问题,只简略说明一些创建博客过程中的实际步骤。

现在开始!

1.如何创建博客

如何在Gitee或Github上
①建立个人博客对应的仓库,以及它们的细微区别
②配置Git Bash工具
③获取 SSH KEY
……
此处不表。

以上准备完成,下载并安装 nodejs ,测试可用后,准备工作完成。

Git Bash安装 Hexo ,生成博客,命令:

1
2
3
4
5
npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo s

测试链接:localhost:4000/

hexo s 是测试命令,当修改博客,在 hexo g 之后,应先 hexo s 本地查看效果。

2.配置 _config.yml ,上传到仓库

注意在本段以下,所有的命令都在 blog 目录下执行。

_config.ymlblog 根目录下。

查找 url 字段,将值配置为将要显示的网站域名:

1
2
3
https://xxx.github.io
or
https://xxx.gitee.io

修改 deploy 字段,配置值:

1
2
3
4
deploy:
type: git
repo: #你的仓库地址(复制仓库中克隆/下载按钮下的https链接)
branch: master

注意冒号之后需要空格间隔开。

修改完成之后,安装一个Git部署插件,命令:

1
npm install hexo-deployer-git --save

最后命令

1
2
3
hexo clean
hexo g
hexo d

生成并发布,如果发布在Gitee上并且打算白嫖,需要手动更新Gitee Pages服务

完成后,即可看到博客效果。

3.新主题:butterfly

在GitHub中找到 butterfly 官方仓库,将其拉取到 blog 下的 themes 目录下,更改文件名称,同时修改 blog 目录下的 _config.yml 文件中的 theme 字段,值修改为更改的文件名

1
2
3
hexo clean
hexo g
hexo d

手动更新Gitee Pages服务,查看效果。

更多配置内容后续总结。

4.仓库创建 Hexo 分支

以上完成后,在仓库下,仅有 master 一个分支存储网站博客内容,但生成这些内容的 blog 目录下的所有文件仅在本地。考虑到之后可能在其它电脑上更新博客,因此需要将这些生产文件上传到仓库中。

创建 hexo 分支,因为我们更新博客时,仅对生产文件做修改,博客内容直接通过 hexo d 上传,因此在分支管理处将 hexo 分支设置成默认分支。之后更新博客后,仅需要 git push hexo 分支即可。

在创建 hexo 分支后, master 分支的内容会被同步复制到该分支中,需要删除掉。

hexo 分支拉取到本地并删除多余文件后,更新远程仓库。

blog 文件夹下的内容复制到 hexo 分支所在根目录下,再更新远程仓库,查看博客所在仓库的 hexo 分支是否更新成功。

hexo 分支目录下发布文章以测试以上修改。

本篇内容到此结束,希望大家一切顺利!