搭建hexo博客并和github关联

  |  

摘要: 记录一下搭建 hexo 博客并与 github 关联的过程,适合新手参考

【对算法,数学,计算机感兴趣的同学,欢迎关注我哈,阅读更多原创文章】
我的网站:潮汐朝夕的生活实验室
我的公众号:算法题刷刷
我的知乎:潮汐朝夕
我的github:FennelDumplings
我的leetcode:FennelDumplings


1. 什么是 hexo

hexo 是一个静态博客框架,参考 https://hexo.io

2. 安装 hexo

  • 准备工作

(1) node.js

1
2
sudo apt install nodejs
sudo apt install npm

(2) 安装 git

(3) 创建 github 账号

  • 正式安装
1
2
sudo npm install hexo-cli -g
sudo npm install hexo -g

3. 建仓库

创建一个名为 github_name.github.io 的仓库,其中 github_name 是 github 的账号名称。例如我的 github 账号名是 FennelDumplings,那么仓库名就是 FennelDumplings.github.io

4. 建立离线文件夹

建立一个离线的文件夹,保存文章内容。例如 ~/blog

5. 初始化离线文件夹

进入离线文件夹目录,然后 hexo init

1
2
cd ~/blog
hexo init

完成后,离线文件夹下会有以下内容

1
2
3
4
5
6
7
_config.landscape.yml  
_config.yml
package.json
source
node_modules
scaffolds
themes

各个文件或文件夹的含义如下

  • node_modules:是依赖包
  • public:存放的是生成的页面
  • scaffolds:命令生成文章等的模板
  • source:用命令创建的各种文章
  • themes:主题
  • _config.yml:整个博客的配置
  • package.json:项目所需模块项目的配置信息

其中我们需要关心的是下面这三个

1
2
3
source: 存放markdown文章内容
themes: 存放使用的主题
_config.yml: 配置

当 source 被解析后,还会产生下面这个文件

  • db.json:source解析所得到的

6. 关联 github

修改 _config.yml

1
2
3
4
deploy:
type: git
repo: https://github.com/FennelDumplings/FennelDumplings.github.io
branch: master

其中 FennelDumplings 是 github 的账号名,与前面创建的仓库 FennelDumplings.github.io 对应。

7. 本地测试

1
2
hexo g
hexo s

可以得到本题网页链接

8. 部署 github 所需插件

用于使用deploy命令时调用git push,将更新信息推送至github.com

1
npm install hexo-deployer-git --save

9. 部署

1
hexo g -d

Share