个人博客的快速搭建

前言：

这篇基于github的个人博客的搭建是查阅了网上各种资料，结合自己实际操作中遇到的各种坑而成。

ps:只针对mac，windows的童鞋可以适量参考。

参考链接：

http://gonghonglou.com/2016/02/03/firstblog/

http://www.jianshu.com/p/4eaddcbe4d12

1 创建Github域名和空间

1.1 Github账号

首先你要有一个github的账号，没有的同学自觉排队去注册，没什么难度，一步一步来就行了。

1.2 创建仓库

接着我们需要创建一个仓库(repository) 来存储我们的网站，点击首页任意位置出现的 New repository按钮创建仓库, 记住你的username下面会用到。 

2 安装

我这里使用hexo作为我的博客框架，想了解更多的小伙伴可以自行google。安装hexo之前需要安装的工具包括Git，Nodejs，Hexo。

2.1 安装git

Xcode自带git,没安装的可以通过下载安装程序进行安装。 当然，还有以下方式：

    <em>// 如果已安装HomeBrew 无需执行此行      $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"            // 安装Git     brew install git</em>

2.2 安装git

先安装nvm，这是Nodejs版本管理器，可以轻松切换Nodejs版本。 这里有两种方式安装。如果使用curl的方式安装，安装完成之后一定要重启终端。

  1. Homebrew 安装方式，此安装方式无需重启  $ brew install nvm    $ mkdir ~/.nvm  $ export NVM_DIR=~/.nvm  $(brew --prefix nvm)/nvm.sh   2. curl安装方式    $ curl https://raw.github.com/creationix/nvm/master/install.sh | sh

安装完成后，重启终端 并执行下列命令即可安装 Node.js。

$ nvm install 4

我在这里徘徊了好久，两种方式都安装不对，建议遇到同样问题的同学直接去[Node.js官网]（https://nodejs.org/en/）下载一路安装即可

2.3 安装Hexo

当Node.js和Git都安装好后就可以正式安装Hexo了，终端执行如下命令：

  $ sudo npm install -g hexo        

输入管理员密码（Mac登录密码）即开始安装 (sudo:linux系统管理指令 -g:全局安装)

注意坑一：Hexo官网上的安装命令是$ npm install -g hexo-cli，安装时不要忘记前面加上sudo，否则会因为权限问题报错。

2.3.1初始化

终端cd到一个你选定的目录，执行hexo init命令：

  $ hexo init blog

blog是你建立的文件夹名称。cd到blog文件夹下，执行如下命令，安装npm：

  $ npm install

执行如下命令，开启hexo服务器：

  $ hexo s

此时，浏览器中打开网址'http://localhost:4000'，能看到如下页面：

此时本地设置已经基本完成了

3 关联Github

本地的blog文件夹下内容为：

  _config.yml      db.json   node_modules   package.json  scaffolds  source  themes

终端cd到blog文件夹下，vim打开_config.yml，命令如下：

  $ vim _config.yml

打开后往下滑到最后，修改成下边的样子：

deploy:    type: git    repository: https://github.com/qiqiqimu/qiqiqimu.github.io.git    branch: master       

你需要将repository后qiqiqimu换成你自己的用户名，地址如图。hexo 3.1.1版本后type:值为git。

注意坑二：在配置所有的_config.yml文件时（包括theme中的），在所有的冒号:后边都要加一个空格，否则执行hexo命令会报错，切记 切记

在blog文件夹目录下执行生成静态页面命令：

  $ hexo generate        或者：hexo g  

此时若出现如下报错：

  ERROR Local hexo not found in ~/blog  ERROR Try runing: 'npm install hexo --save'则执行命令：  npm install hexo --save

若无报错，自行忽略此步骤。

再执行配置命令：

  $ hexo deploy            或者：hexo d注意坑三：若执行命令hexo deploy仍然报错：无法连接git或找不到git，则执行如下命令来安装hexo-deployer-git：  $ npm install hexo-deployer-git --save        

再次执行hexo generate和hexo deploy命令。

若你未关联Github，则执行hexo deploy命令时终端会提示你输入Github的用户名和密码，即

  Username for 'https://github.com':

  Password for 'https://github.com':

hexo deploy命令执行成功后，浏览器中打开网址'http://qiqiqimu.github.io'（将qiqiqimu换成你的用户名）能看到和打开'http://localhost:4000'时一样的页面。

为避免每次输入Github用户名和密码的麻烦，可参照以下方法

4.添加ssh key到Github

4.1.检查SSH keys是否存在Github

执行如下命令，检查SSH keys是否存在。如果有文件idrsa.pub或iddsa.pub，则直接进入步骤1.3将SSH key添加到Github中，否则进入下一步生成SSH key。

  $ ls -al ~/.ssh

4.2.生成新的ssh key

执行如下命令生成public/private rsa key pair，注意将[e-mail]换成你自己注册Github的邮箱地址。

  $ ssh-keygen -t rsa -C "[e-mail]"

默认会在相应路径下（~/.ssh/idrsa.pub）生成idrsa和id_rsa.pub两个文件。

4.3.将ssh key添加到Github中

Find前往文件夹~/.ssh/idrsa.pub打开idrsa.pub文件，里面的信息即为SSH key，将这些信息复制到Github的Add SSH key页面即可。

进入Github –> Settings –> SSH keys –> add SSH key:

Title里任意添一个标题，将复制的内容粘贴到Key里，点击下方Add key绿色按钮即可。

5.发布文章

终端cd到blog文件夹下，执行如下命令新建文章：

  hexo new "postName"    

名为postName.md的文件会建在目录/blog/source/_posts下，postName是文件名，为方便链接不建议掺杂汉字。你当然可以用vim来编辑文章。我在用macdown编辑器，支持预览。刚开始用，还不熟练，但是感觉特别好用！

文章编辑完成后，终端cd到blog文件夹下，执行如下命令来发布：

  hexo generate             //生成静态页面  hexo deploy            //将文章部署到Github

至此，Mac上搭建基于Github的Hexo博客就完成了。 

后记：

搭建这个博客和整理虽然花费了两天左右的时间，但是收获还是蛮大的，正好最近项目上也不太忙。留下下面的问题之后再做补充：

1.markdown语句的使用

2.更改博客[主题]（https://hexo.io/themes/）和其他配置（https://hexo.io/zh-cn/docs/configuration.html）

3.自动部署发布工具(https://github.com/hexojs/hexo-deployer-git)

4.不基于github的个人域名的绑定

5.theme的安装

有兴趣的同学到我博客来看看https://hyf12138.github.io/