GitHub加Hexo打造个人博客

---

本文由 CDFMLR 原创，收录于个人主页 https://clownote.github.io，并同时发布到 CSDN。本人不保证 CSDN 排版正确，敬请访问 clownote 以获得良好的阅读体验。

---

GitHub + Hexo => 个人博客

打造一个个人博客其实很简单，我们不需要拥有一台服务器、甚至可以对 Web 开发不甚了解。

这篇文章记录我如何在 Mac 上通过 GitHub、Hexo 打造一个个人博客 —— clownote

起因

我一直不喜欢 CSDN 和博客园等博客平台，但确实有写东西的习惯。写了东西就要发表，所以在之前，我把我学习计算机知识的笔记都放到了一个自己初学 Web 开发时搞的一个超级简陋的静态网站上。

但它实在是太简陋了导致使用起来巨麻烦，发布文章要手动把 markdown 写的文章用自己写的一个转换器渲染成 HTML，然后调用一个可以及时渲染代码颜色的 js 进去，然后 FTP 上传到服务器上，再到手动修改 index.html，加入这篇新文章的链接…

这完全不是正常人应该用的操作！

我一直在考虑写一个功能完整的、更方便的博客。计划是用 Flask 写后端，Vue 做前端，Git 来管理内容，然后再写一些 Apple Script、Bash Script 让这个博客系统方便在 Mac 中使用 。但最近一直忙其他项目，没时间来实现。现在我的服务器到期了，百度云的，感觉不太好用（主要是受对这家公司的某些其他产品的不良印象的影响），不续费了。

笔记急需迁出！写之前想的博客系统是来不及了，突然想起来很多人用一个叫 Hexo 的东西做博客，于是一番 Google、Bing。最终，我觉定用 GitHub + Hexo 快速（Less than One Day）打造一个不用服务器、不用写代码的博客。

经过

废话不多说，代码赶快写起来，，，（哦，错了，咱们今天不用写代码！只是几个简单的命令 + 配置就好了）

废话不多说，建站走起！

安装

注册GitHub

首先，我们需要注册一个 GitHub 账户，我相信绝大多数的读者已经完成了这一步，所以不再赘述；如果您幸运的属于少数人，请打开 GitHub，即可按照感觉轻松完成。

创建 GitHub Pages

在您的 GitHub 中，New 一个 Repository，名字为 .github.io，其中的 与您的 GitHub 用户名相同。

注意，在这个新建的 Repository 的 Settings 中，您应该可以找到，有关 GitHub Pages 的设置里写了:

Your site is published at https://.github.io

这样就成了，否则请检查之前的步骤是否正确。

安装 Hexo

在安装 Hexo 前，需要确定电脑中是否已安装了：

• Node.js (版本至少为 nodejs 6.9)
• Git

$ git --version
$ node --version

如果没有，要先安装他们。接下来只需要使用 npm 即可完成 Hexo 的安装：

$ npm install -g hexo-cli

建站

初始化

安装 Hexo 完成后，执行下列命令，Hexo 将会在指定文件夹中新建您的博客：

$ hexo init 
$ cd 
$ npm install

然后，可以看到指定文件夹的目录如下：

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

配置

目录中的 _config.yml 是网站的配置信息，我们需要在此配置一些参数：

$ cat _config.yml
# Hexo Configuration
## Docs: https://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/
......

需要配置的项目有：

参数	描述
title	网站标题
subtitle	网站副标题
description	网站描述
keywords	网站的关键词。使用半角逗号 , 分隔多个关键词。
author	您的名字
language	网站使用的语言
url	网址
theme	当前主题名称。值为false时禁用主题
deploy	部署部分的设置

需要说明的是，deploy 项的配置就可以把Hexo与GitHub关联起来，即将我们的博客推送到 GitHub，打开站点的配置文件_config.yml，deploy 项配置为：

deploy: 
	type: git
	repo: https://github.com/>/>.github.io
	branch: master

然后，我们需要让 Hexo 连接上我们的 GitHub：

$ npm install hexo-deployer-git --save

$ hexo clean
$ hexo generate
$ hexo deploy

每一条命令的作用都很直观。操作完之后你就会发现你的博客已经上线了，可以在网络上被访问了！

主题

如果你像我一样，觉得 Hexo 自带的 landscape 主题不太好看，我们可以跟换一个主题。

我们可以在 Hexo 官网上找到很丰富的 主题资源，具体的使用方法主题项目的 README 里会写明，照着做就行。

这里以配置一个叫做 cactus 的主题为例：

1. 下载、安装：

$ cd 		# hexo init 的目录
$ git clone https://github.com/probberechts/hexo-theme-cactus.git themes/cactus		# 拷贝一份主题

2. 修改Hexo主题：

$ vim ./config.yml

修改其中的 theme 属性：

# theme: landscape
theme: cactus

3. 主题配置

在 themes/cactus/_config.yml 中按照自己的需要对主题进行配置。

写作

其实到这里，我们的博客就已经构建完成了。接下来我们就可以用新建的博客系统写作了。

新建文章

你可以执行下列命令来创建一篇新文章。

$ hexo new [layout]