简介

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

Butterfly 是Hexo的一款精美主题，能让你的博客增色不少，并且文档齐全。

GitHub Pages 是免费的静态站点。

所以你只需要动动手指，就可以免费拥有一个属于自己的精美博客。

开始

前期准备

在安装前，需要先安装下列应用程序

  • nodejs(Node.js 版本需不低于 10.13，建议使用 Node.js 12.0 及以上版本)
  • git

在 Hexo官方文档 中有介绍，这里就不多做说明。

安装 Hexo

执行命令即可完成安装 Hexo

1
npm install -g hexo-cli

安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

1
2
3
hexo init <folder>
cd <folder>
npm install

继续执行命令，启动服务器

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

默认情况下，访问网址为： http://localhost:4000/

安装butterfly

这里可以参考一下 Butterfly安装文档。

执行命令

1
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

并修改Hexo根目录下的_config.yml，把主题改为butterfly。

1
theme: butterfly

并且安装相关的插件

1
npm install hexo-renderer-pug hexo-renderer-stylus --save

并且依据官方的建议把themes/butterfly/_config.yml复制到Hexo根目录并更名为_config.butterfly.yml。

接下来，我们执行命令

1
hexo clean && hexo g && hexo s

我们就可以直接在自己浏览器上看到主题已经变为butterfly

发布

发布前需要在github新建一个项目，用来存储静态网页，并且生成站点。

配置Git

如果第一次需要设置用户名和邮箱:

1
2
git config --global user.name "your username"
git config --global user.email "your email"

生成公钥

1
ssh-keygen -t rsa

在当前用户目录下进入.ssh文件夹能发现id_rsa.pub。在github上添加Deploy keys，把id_rsa.pub内容复制进去即可。

最后可以测试一下连接

1
ssh -T git@github.com

如果测试成功，会有成功的回复。

配置hexo发布插件

修改_config.yml，把仓库地址配置为之前生成的项目地址

1
2
3
4
deploy:
  type: git
  repository: # 你的仓库地址，例如：git@github.com:<用户名>/ivoryforest.git
  branch: # 分支 例如：master

配置正确，然后执行命令

1
2
3
hexo clean
hexo g  # 编译生成
hexo d  # 发布

如果没出问题的话，即可看到github项目中已经有内容了。（如果有问题多半是网络的问题）

生成站点

通过点击项目setting -> pages 可以配置静态站点，如果是你免费会员，那么该项目必须是public的。

默认站点名称为https://<用户名>.github.io/<项目名>，如果你想以根目录结尾，不显示项目名，那么你的项目名需要为(<用户名>.github.io)。

结尾

到目前为止，你就拥有一个精美的个人网站了，但是维护好还需要坚持。