快速搭建个人博客

# 前言：

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

参考链接：

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

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

# 1 创建Github域名和空间

## 1.1 Github账号

首先你要有一个[github](https://github.com/)的账号，没有的同学自觉排队去注册，没什么难度，一步一步来就行了。

## 1.2 创建仓库

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


# 2 安装

我这里使用[hexo](https://hexo.io/zh-cn/docs/index.html)作为我的博客框架，想了解更多的小伙伴可以自行google。安装hexo之前需要安装的工具包括Git，Nodejs，Hexo。

## 2.1 安装git

Xcode自带git,没安装的可以通过下载[安装程序](https://sourceforge.net/projects/git-osx-installer/)进行安装。

当然，还有以下方式：

// 如果已安装HomeBrew 无需执行此行

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

// 安装Git

brew install git

## 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是否存在。如果有文件id_rsa.pub或id_dsa.pub，则直接进入步骤1.3将SSH key添加到Github中，否则进入下一步生成SSH key。

$ ls -al ~/.ssh

## 4.2.生成新的ssh key

执行如下命令生成public/private rsa key pair，注意将your_email@example.com换成你自己注册Github的邮箱地址。

$ ssh-keygen -t rsa -C "your_email@example.com"

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

## 4.3.将ssh key添加到Github中

Find前往文件夹~/.ssh/id_rsa.pub打开id_rsa.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的安装*

ps:感兴趣的同学可以看看我的博客 https://hyf12138.github.io/

转载于:https://juejin.im/post/5cb6f95e6fb9a06852553821