现在越来越多的人喜欢利用Github搭建静态网站，原因不外乎简单省钱。本人也利用hexo+github搭建了本博客，用于分享一些心得。在此过程中，折腾博客的各种配置以及功能占具了我一部分时间，在此详细记录下我是如何利用hexo+github搭建静态博客以及一些配置相关问题，以免过后遗忘，且当备份之用。

准备工作

本地搭建hexo静态博客

  • 新建一个文件夹，如blog
  • 进入该文件夹内，右击运行git，输入：hexo init（生成hexo模板）
  • 生成完模板，运行npm install（目前貌似不用运行这一步）
  • 最后运行：hexo s （运行程序，访问本地localhost:4000可以看到博客已经搭建成功）

目录介绍

1
2
3
4
5
6
7
8
9
10
11
12
13
14
├── _config.yml						// 博客配置文件
├── public								// 静态文件存放目录
│   ├── 2019
│   ├── archives
│   ├── css
│   ├── images
│   ├── index.html
│   ├── js
│   └── lib
├── source								
│   └── _posts						// 博文存放路径
└── themes								// 主题路径
    ├── landscape
    └── next

将博客与Github关联

  • 在Github上创建名字为XXX.github.io的项目，XXX为自己的GitHub用户名。
  • 打开本地的MyBlog文件夹项目内的_config.yml配置文件，将其中的type设置为git
1
2
3
4
deploy:
  type: git
  repository: https://github.com/XXX/XXX.github.io.git
  branch: master
  • 运行：npm install hexo-deployer-git –save
  • 运行：hexo g（本地生成静态文件）
  • 运行：hexo d（将本地静态文件推送至Github）

此时打开 https://XXX.github.io ，即可看到效果

这里注意把文中的 XXX 修改为自己的github用户名

### 更新文章
  • 在blog目录下执行：hexo new “我的第一篇文章”，会在source->_posts文件夹内生成一个.md文件。
  • 编辑该文件（遵循Markdown规则）
  • 修改起始字段
    • title 文章的标题
    • date 创建日期 （文件的创建日期 ）
    • updated 修改日期 （ 文件的修改日期）
    • comments 是否开启评论 true
    • tags 标签
    • categories 分类
    • permalink url中的名字（文件名）
  • 编写正文内容（MakeDown）
  • hexo clean 删除本地静态文件（public目录）
  • hexo g 生成本地静态文件（public目录）
  • hexo deploy 将本地静态文件推送至github（hexo d）

修改主题

至此，我们的博客就已经搭建完了，发现两个问题，一是丑，二是使用GitHub默认域名不舒服。所以我们要修改一个好看的主题（默认的主题经过一番DIY也能达到不错的效果，这里就不多做演示）和使用自己的域名（可选），非必须，看个人喜好。

目前安装的主题：Next

更多主题：主题

主题配置文档：Next主题配置

1、在博客的根目录下，也就是上文提到的blog文件夹中，执行clone主题

1
$ git clone https://github.com/theme-next/hexo-theme-next themes/next

2、修改hexo配置文件

使用文本编辑器打开blog目录下的_config.yml文件，将 themes 对应的值进行修改，如下：

1
theme: next

3、重新生成静态文件

1
2
3
4
5
$ hexo clean

$ hexo g

$ hexo s

浏览器打开 http://localhost:4000 即可看到效果。确认没问题执行 hexo d 命令更新到GitHub，稍等片刻重新打开 https://XXX.github.io 便可看到效果；

绑定域名

  • 域名提供商设置

    添加一条CNAME记录：

    CNAME —> XXX.github.io

  • 博客添加CNAME文件

    配置完域名解析后，进入博客目录，在source目录下新建CNAME文件，写入域名，如：jacian.com

  • 运行：hexo g

  • 运行：hexo d

重新发布完，稍等片刻打开自己的域名即可看到效果。至此你的个人博客就已经搭建完毕了；当然，你还可以做一些DIY的设置，在这篇文章中就不一一列举了，可以参考文档或者其他大神的博客去进行一些自定义的设置。