安装：

一、安装Homebrew

Mac上已经安装了ruby环境，只需要输入

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

二、安装node.js

sudo brew install node

三、安装Hexo

Hexo是基于node.js的博客系统，这里安装就可以了。

sudo npm install -g hexo 
npm install hexo-renderer-ejs --save
npm install hexo-renderer-stylus --save
npm install hexo-renderer-marked --save

安装完成后，找一个放blog的目录

cd ~/Blog

然后执行初始化

hexo init

然后可以直接预览hello word.md

hexo g
hexo s
=> [info] Hexo is running at localhost:4000/. Press Ctrl+C to stop.

g是generate, s是server，还有d是deploy（部署）推荐用首字母，方便快捷。

四、创建Blog Repository

在自己的Github，点击New repository创建Blog的仓库，记住勾选README。

这里有特别需要注意的地方：如果你想要能通过 username.github.io的方式访问你的博客主页，仓库名必须为 username.github.io，username为你的用户名。你也可以用其他方式命名你的blog仓库，比如就叫blog，但是这样在访问的时候，域名就是username.github.io/blog （blog为仓库名）。所以还是推荐使用第一种方式命名，github推荐的也是这种方式。

repository1 repository2

创建完毕。点击仓库右上角的Settings标签，进入设置页，检查GitHub Pages这一项。如果你的仓库命名是推荐方式，则会像下图一样，Source一栏是灰色的。否则会有两个分支选择：master branch、gh-pages branch，hexo默认会使用gh-pages branch，所以如果你这里是master branch，会出现blog主页没有内容的问题。

github pages

五、安装hexo的git插件

npm install hexo-deployer-git --save

六、建立映射关联

进入你的Blog目录，修改_config.yml文件，配置一些东西。

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
      type: git
      branch: gh-pages  ## branch这一行默认不写，如果你需要特别指定，可以在这里加上
      repository: https://github.com/aoshiwenrou/aoshiwenrou.github.io.git

这里repository的地址可以是https的，也可以是git的，只不过git需要SSH证书，一般用https就可以了，如果出现443错误，替换成git。

然后在Blog目录下

hexo g -d

生成静态文件并且部署出去，不出意外，已经可以外网访问了。

这个命令这里说一下：

hexo g ：部署到github，也就是你有什么修改，用这个命令提交到服务器

hexo s ：打开hexo本地服务，此时可以在本地进行预览

hexo d ：发布

一般可以组合使用hexo g -d，部署并发布，或者hexo s -d。不过一般还是推荐先g，然后s，进行本地预览，没有问题再进行d

写文章

在Blog目录下，创建

hexo new 文章题目

然后用Markdown编写，写好后save。

hexo g
hexo s

生成，然后在本地localhost:4000预览一下，如果没有问题，就可以发布了。

hexo d

所有的文章都是放在Blog/source/_posts/目录下的，可以随时编辑修改。

小技巧：hexo new 的时候，推荐使用英文名，例如我这篇文章就叫build blog site with hexo and github in maxOS（英文很水，轻点吐槽），这样你的文章链接就不会出现一堆中文转义。然后在你文章的顶部进行配置，设置title为中文（默认会有这两行，并且title为文件名，我这里默认就是build blog site with hexo and github in maxOS），这样在你的blog列表中，显示的就是你的中文title，就像你现在在文章中看到的，我的标题就是mac下基于Hexo-Github的Blog搭建

title: mac下基于Hexo-Github的Blog搭建
date: 2017-05-16 10:16:18

优化

一、访问速度

由于Google被墙，大部分主题中引用的jquery都会因为超时（可以Blog目录下搜索google），而造成页面访问很慢，这里需要将jquery改为百度的

<script src="//apps.bdimg.com/libs/jquery/2.0.3/jquery.min.js"></script>

二、RSS订阅

输入命令

$ npm install hexo-generator-feed --save

然后在_config.yml中，添加

rss: /atom.xml
feed:
     type: atom
     path: atom.xml
     limit: 20

三、搜索支持

现在在百度和Google是搜不到你的网站的，为了让搜索引擎搜索到，需要做一些工作。

搜索引擎入口

• Google搜索引擎提交入口
• 百度搜索引擎入口

添加sitemap.xml：

首先输入：

npm install hexo-generator-sitemap --save
npm install hexo-generator-baidu-sitemap --save    
npm install hexo-baidu-url-submit --save

前两个插件用于生成sitemap，后一个插件用于主动推送链接到百度（防止百度爬虫抓取失败，导致百度搜不到您的博客，这里有一篇关于百度无法爬取Github Pages静态网站解决方案）。

然后在_config.yml文件中添加

sitemap:
         path: sitemap.xml
baidusitemap:
         path: baidusitemap.xml

## BaiduUrlSubmit: http://hui-wang.info/2016/10/23/Hexo插件之百度主动提交链接/    
baidu_url_submit:        ##主动推送新文章到百度
  count: 3 ## 比如3，代表提交最新的三个链接
  host: blog.darkangel7.com ## 在百度站长平台中注册的域名
  token: your_token ## 请注意这是您的秘钥， 请不要发布在公众仓库里!
  path: baidu_urls.txt ## 文本文档的地址， 新链接会保存在此文本文档里

##同时要检查这里有没有URL值，必须包含是百度站长平台注册的域名，比如 
# URL
url: http://blog.darkangel7.com
root: /
permalink: :year/:month/:day/:title/

##最后，加入新的deployer，如
deploy:
- type: git
  repository: git@github.com:DarkAngel7/Blog-Hexo.git
- type: baidu_url_submitter  ## 百度链接主动推送

先验证网站所有权，下载html，mv到Blog/themes/yourtheme/source目录下，执行

hexo g -d

验证成功后，添加百度自动推送脚本，最好在head.ejs中添加百度自动推送的代码，至于head.ejs文件位置，在你使用的theme文件夹下搜索吧。
谷歌的话，在抓取-站点地图里面添加就好。

这样主动推送与自动推送结合，能很好的提高您文章的曝光率。

四、评论功能

可以使用多说来提供评论功能。首先，在_config.yml文件中添加

# Duoshuo
duoshuo_shortname: yoursite.doushuo.com

然后，搜索themes文件夹下，你使用的theme文件目录下的commemt.ejs（不同的theme可能位置不同，请自行寻找）。修改如下：

 <div id="comment" class="comments-area">
     <% if(config.duoshuo_shortname) { %>
     <! -- 多说的代码 --> 
     <% } %> 
</div>    

 如果报关于data-thread-key的错误，则改成下面这样：
 <div class="ds-thread" data-thread-key="<%= page.path %>" data-title="<%= page.title %>" data-url="<%= page.permalink %>"></div    >

五、分享功能

可以在Blog目录下搜索post/share，一般在article.ejs文件中，或者post.ejs文件中，然后替换

<%- partial('post/author') %>

为百度分享提供的代码。

六、个人信息完善

网站的信息一般都在Blog/_config.yml中修改。

关于Theme，去官方提供的主题列表中选个现成的，按照里面的方法pull下来，如light主题

$ git clone git://github.com/tommy351/hexo-theme-light.git themes/light

然后在_config.yml配置文件中设置：

theme: light

关于主题的优化，一般在themes/yourtheme/_config.yml中配置。

写在最后

本文参考<a href="http://blog.darkangel7.com/2016/08/19/Hexo+Github的Blog搭建/">Dark Angel的博客</a>，他的文章还提到了付费购买域名，及域名与github绑定的内容，有需要的可以参考