1. 1. 前言
  2. 2. Hexo + Github Pages
    1. 2.1. 什么是 Hexo？
    2. 2.2. 使用Hexo搭建博客有什么好处？
    3. 2.3. 安装前提
    4. 2.4. 创建你的第一个Hexo博客
    5. 2.5. 配置你的博客
    6. 2.6. 本地浏览运行
    7. 2.7. 发布到Github Pages
      1. 2.7.1. 什么是 Github Pages？
      2. 2.7.2. 如何使用 Github Pages？
      3. 2.7.3. 将Hexo部署到Github Pages
    8. 2.8. Hexo常用命令以及介绍
      1. 2.8.1. server
      2. 2.8.2. generate
      3. 2.8.3. deploy
      4. 2.8.4. clean
      5. 2.8.5. list
      6. 2.8.6. 更多命令

前言

本篇介绍Windows环境下安装Hexo，因为Nodejs和Git的跨平台特性，Linux下操作流程几乎完全一致，只是安装这两个软件的过程不同而已。

Hexo + Github Pages

什么是 Hexo？

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

使用Hexo搭建博客有什么好处？

  1. 方便：Hexo默认使用 Markdown解析文章，如果你稍微懂点Markdown的话，你就会明白使用Markdown写博客是多么的方便快捷了！
  2. 快捷：Hexo是一个静态的博客系统，访问速度相对来说比较快。
  3. 免费：基于Github Pages服务，你的博客系统可以不用花一分钱就能展现在大家面前，域名都给你准备好了，当然只是github的子级域名（也可自定义域名）
  4. 易迁移：博客文章可以轻松迁移到其它平台
  5. 易扩展：Hexo的主题（Theme）和插件（Plugin）非常之多，你可以任意的组合、修改，不满意还可以自己开发！

安装前提

安装 Hexo 相当简单。然而在安装前，你必须检查电脑中是否已安装下列应用程序：

如果你的电脑中已经安装上述必备程序，那么恭喜你！接下来只需要使用 npm 即可完成 Hexo 的安装。

1
$ npm install -g hexo-cli

如果你的电脑中尚未安装所需要的程序，请先完成安装所需的程序。

创建你的第一个Hexo博客

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

1
2
3
$ hexo init first-blog
$ cd first-blog
$ npm install

first-blog 是你的博客系统所在文件夹的名称，而并非博客的名称，最好起一个相对简单好记的名称

新建完成后，指定文件夹的目录如下：

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

配置你的博客

你可以在 _config.yml 中修改大部份的配置。以下列出常用的配置

参数 描述
title 网站标题
subtitle 网站副标题
description 网站描述
author 你的名字
permalink 文章的 永久链接 格式 :year/:month/:day/:title/

其中，description主要用于SEO，告诉搜索引擎一个关于你站点的简单描述，通常建议在其中包含你网站的关键词。author参数用于主题显示文章的作者。

更多配置请浏览Hexo官方文档

本地浏览运行

1
$ hexo server // 确保你是在博客的根目录下运行此命令

执行完毕此命令后，如果没有错误并输出下面这段话则代表运行起来了

1
INFO  Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

你就可以直接访问http://localhost:4000/来浏览你的博客了

发布到Github Pages

什么是 Github Pages？

GitHub Pages 是通过我们网站托管和发布的公开网页。
你可以在线创建和发布 GitHub Pages。如果你更喜欢本地操作，你可以使用 Mac 或者 Windows 平台的 GitHub App，或者使用 命令行。
Pages 是通过 HTTP 服务的，不是 HTTPS，所以你不应该使用它处理敏感的事务，像发送密码或者信用卡号码。
警告：GitHub Pages 网站是在互联网上公开的，即使它们所在的库是私有的。如果你有敏感的数据在 Page 库，你应该在发布之前删除它。
想要获取更多信息，可以查看 Github Pages 网页，或者这里的相关帮助文档。

如何使用 Github Pages？

  1. 首先创建一个Github账号
  2. 设置你的用户名，虽然用户名可以更改，但填写用户名的时候还是要很谨慎
  3. 创建一个存储库，格式必须是username.github.io，例如我的用户名是sjlei，所以我的存储库名称就是sjlei.github.io
  4. 这里一定要是新建的存储库，亲测重命名的不好使
  5. 然后向存储库中传入一个index.html或index.md，等待大约一两分钟，甚至立即就能访问你的Github Pages服务。
  6. 访问地址就是你的存储库名称，例如我的地址就是https://sjlei.github.io

将Hexo部署到Github Pages

确认无误以后，就可以通过git发布到github的存储库上了。
首先打开博客根目录下的_config.yml文件，并且找到deploy配置项，如果没有则可以在最下面自己加一个

1
2
3
4
deploy:
  type: git
  repository: https://github.com/username/username.github.io.git # 将username替换成你github上的用户名即可
  branch: master

然后执行下面这个命令即可

1
$ hexo deploy

如果你是第一次使用这个命令，那么会让你输入github的用户名和密码，如实输入即可。
成功之后，稍微等一会，再访问你的Github Pages专属的域名就能看到你的博客啦！

Hexo常用命令以及介绍

server

1
$ hexo server

启动服务器。默认情况下，访问网址为： http://localhost:4000/。

选项 描述
-p, –port 重设端口
-s, –static 只使用静态文件
-l, –log 启动日记记录，使用覆盖记录格式

generate

1
$ hexo generate

生成静态文件。
新建一篇文章。如果没有设置layout的话，默认使用_config.yml中的default_layout参数代替。如果标题包含空格的话，请使用引号括起来或引号引起来

选项 描述
-d, –deploy 文件生成后立即部署网站
-w, –watch 监视文件变动

该命令可以简写为

1
$ hexo g

deploy

1
$ hexo deploy

部署网站。

选项 描述
-g, –generate 部署之前预先生成静态文件

该命令可以简写为

1
$ hexo d

clean

1
$ hexo clean

清除缓存文件 (db.json) 和已生成的静态文件 (public)。
在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。

list

1
$ hexo list <type>

列出网站资料。

更多命令

请参阅Hexo官方文档