Hexo+GitHub搭建个人博客的原理是通过hexo将我们编写的markdown文章生成静态的html页面,然后,将生成的html上传到我们的GitHub服务器。因此第一步搭建Hexo环境。

搭建Hexo环境

Hexo是个静态页面生成、上传的工具,基于node.js。而不是我们理解的一个开源的博客系统。

安装Node.js和配置好Node.js环境

1
node -v 检测node版本

安装hexo

1
2
npm install hexo -g 安装Hexo
hexo -v 检查hexo是否安装成功

初始化

1
hexo init 初始化该文件夹
  • source 存放我们编写的md文件
  • themes 存放生成静态页面的样式主题
  • public 通过hexo通过md生成的静态页面

配置Deployment

hexo生成的静态页面需要部署到GitHub的服务器,因此需要本地的hexo与自己的GitHub的服务器关联。

编辑_config.yml

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

Hexo发布博客

新建一篇博客

1
hexo new post "博客名"

将Md文件内容通过Hexo生成静态页面

1
hexo generate

静态资源推动到GitHub服务器

1
hexo deploy

补充:在每次生成静态页面前,可执行hexo clean 清除之前生成的静态页面。

主题安装

通过配置主题来决定生成静态页面的样式,让我们的博客更个性化。可参考官方主题。这里举例 maupassant。

安装主题和渲染器:

1
2
3
$ git clone https://github.com/tufu9441/maupassant-hexo.git themes/maupassant
$ npm install hexo-renderer-pug --save
$ npm install hexo-renderer-sass --save

编辑Hexo目录下的 _config.yml,将theme的值改为maupassant。 具体细节配置可参考作者笔记博客

推荐

Mac客户单编写Markdown的工具-Yu Writer

Windwos环境

下载安装Nodejs 建议选择LTS版

安装Git