搭建博客

本教程适用于Mac平台，要求会使用git基本操作，命令行基本操作。

前言

最近看了开智部落成员 @violettianjie 发起的 issues 如何用 Jeklly/Hexo+GitHub 最方便的搭建博客？，于是决定搭建一个属于自己的独立博客，并把搭建过程记录下来。

搭建博客的方法有很多，推荐使用Github Pages，它需要相应的博客引擎来驱动，主流的有两个 Hexo 和 Jekyll 。

GitHub Pages 可以被认为是用户编写的、托管在GitHub上的静态网页。Jekyll是一个静态站点生成器，它会根据网页源码生成静态文件。整个思路到这里就很明显了。你先在本地编写符合Jekyll规范的网站源码，然后上传到github，由github生成并托管整个网站。—-阮一峰

环境配置

操作系统 Mac OS
动态开源编程语言 Ruby
Ruby的包管理框架 RubyGems
基于Chrome V8引擎的JavaScript运行环境 Node.js
分布式版本管理系统 Git
开源项目托管平台 Github
静态站点托管服务 Github Pages
静态站点生产器/博客框架/博客引擎 Jekyll 或 Hexo

Github搭建

Fork Jekyll/Hexo主题：从 Jekyll theme rubygems搜索jekyll theme Hexo theme 搜索找到自己喜欢的博客主题，然后进入此博客主题的github库，点击Fork，再回到自己的github库，把fork的仓库名修改为：username.github.io 。打开博客网址：https://username.github.io ，就可以看到博客界面了。
在本地进行个性化配置：把这个username.github.io仓库git clone到本地，然后查看官网文档Jekyll使用文档中文 Hexo使用文档中文和相应的主题使用文档(此博客主题的github库)，进行个性化配置。
撰写发布新的博文：在本地撰写新的博文，然后git push origin master推送到自己的github仓库，打开博客就看到自己更新的博文了。

本地搭建

安装jekyll/hexo：

jekyll预览 gem安装jekyll环境，打开终端输入命令：

  sudo chown -R your_name /Library/Ruby/Gems/2.3.0 #注释1
  gem install jekyll bundler
  jekyll new blog
  cd blog
  bundler install
  bundle exec jekyll serve #或者jekyll serve

浏览器打开网址：http://127.0.0.1:4000 ，即可预览博客。

hexo预览 npm安装hexo环境，打开终端输入命令：
```
 npm install hexo-cli -g
 hexo init blog
 cd blog
 npm install
 hexo server
```
浏览器打开网址：http://127.0.0.1:4000 ，即可预览博客。

安装主题并进行个性化配置：从 Jekyll theme rubygems搜索jekyll theme Hexo theme 搜索找到自己喜欢的博客主题，然后进入此博客主题的github库，查看主题使用文档，进行个性化配置。
撰写发布新的博文：在本地撰写新的博文，然后git remote add origin关联到自己的github仓库，打开博客就看到自己更新的博文了。

注释：

注释1

在Mac OS下，gem安装时容易出现以下错误：
gem install xxx
ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /Library/Ruby/Gems/2.3.0 director
意思是gem要往某个神奇的目录写文件但是你的权限不够。因为你使用的是Apple家自带的 ruby，在尝试往Apple自家的库中塞东西，默认那个位置是给root的。有两个差劲的方法可以解决这个问题。一个是前面加 sudo。另一种是修改/Library/Ruby/Gems/2.3.0这个目录的用户权限，即：sudo chown -R your_name /Library/Ruby/Gems/2.3.0 。—-出处：Mac OS X 下使用 Ruby Gem 的两个坑

参考资料

CHANGELOG

171003早上创建 171008 增加Hexo、增加环境配置、优化