利用github hexo搭建博客

---

title: 使用 github + hexo 搭建博客

1.配置环境

安装 node.js

这里我推荐大家使用 v5 的版本，下载传送门：

https://nodejs.org/dist/v5.12.0/

安装 git

下载传送门：

https://git-scm.com/downloads

安装 hexo

安装完git之后就可以安装hexo了，如果某些同学的电脑桌面上没有git bash,可尝试在开始菜单里查找。打开git bash 之后输入以下命令回车将hexo安装到全局。

$ npm install -g hexo

测试安装 hexo

$ hexo -v

如果显示以下内容则安装成功。版本不同可能会有少许差异，不过无伤大雅

hexo-cli: 1.0.2

os: Windows_NT 10.0.14393 win32 x64

http_parser: 2.7.0

node: 5.12.0

v8: 4.6.85.32

uv: 1.8.0

zlib: 1.2.8

ares: 1.10.1-DEV

icu: 56.1

modules: 47

openssl: 1.0.2h

安装完所需的软件之后就要在github上面新建一个库

点击绿色按钮新建库

在Repository name的输入框内写入和你的owner名字+github.io(切记一定要一致)

2.本地配置

hexo初始化

前面我们已经安装完了hexo，但是我们还需要给它初始化，在你的任意一个盘符里新建一个文件夹，这里我选择的是在C盘新建的一个hexo的文件夹。打开文件夹右键git bash,输入以下命令。

$ hexo init

生成静态页面

$ hexo generate

启动本地预览

然后在浏览器中输入http://localhost:4000/查看生成的页面效果。

$ hexo server

3.关联github

本地配置

这里打开前面自己新建的文件夹下面的_config.yml文件，用记事本打开即可。在文件的最下方，添加如下配置。(注：每一个冒号之后需要空一格，第一个Jun-Dong为Github的用户名,第二个Jun-Dong为之前New的Repository的名字,不要把我的给复制上去了,还有type一定要保持缩进)

deploy:

    type: git

    repository: https://github.com/Jun-Dong/Jun-Dong.github.io

    branch: master

配置SSH

如果你是第一次使用github则需要配置SSH key.

右键选择git bash ,输入以下命令，[email protected]换成注册github的邮箱号。

$ ssh-keygen -t rsa -C "[email protected]"

之后会要求确认路径和输入密码，我们这使用默认的一路回车就行，成功的话会在C:\Users\Administrator下生成.ssh文件夹，如果你的电脑的用户名是中文，则会在C:\用户\电脑用户名下生成.ssh文件夹，进入该文件夹，以文本的形式打开idrsa.pub，复制里面的key，即复制文件的全部内容。如果你在这边只看见2个idrsa文件，没看到id_rsa.pub，应该是你把后缀名隐藏了，可以设置显示后缀，或者直接把两个文件都以文本的形式打开，内容短的并且以ssh-rsa开头的即为所需的SSH key。回到github，进入Settings，选择SSH and GPG Keys -> New SSH Key，title随便填，粘贴key。为了验证是否成功，在git bash下输入：

$ ssh -T [email protected]

有些童靴如果显示continue，输入yes就会看到：You’ve successfully authenticated， but GitHub does not provide shell access ，这就表示已成功连上github。

上传本地库到github

$ git config --global user.name "your name"  
$ git config --global user.email "[email protected]"

继续部署github

安装所需插件

$ npm install hexo --save
$ npm install hexo-deployer-git --save

然后分别执行以下三条指令:

$ hexo clean
$ hexo g
$ hexo d

部署成功后，你在浏览器中输入yourname.github.io，就能看到和本地一样的效果了

写文章

在此处新建md文件即可