Git搭建静态博客

2016-03-26

一直想写篇文章来介绍git-pages的搭建，拖了好久，今天来填下坑。

Git基本配置

git config 命令可以对 Git 的使用选项和配置进行设置（记得将下面大写部分的 YOUR_USERNAME 和 YOUR_EMAL@EMAIL.COM 替换为你自己的名字和 Email 地址）。

1 2	git config --global user.name " YOUR_USERNAME" git config --global user.email "YOUR_EMAL@EMAIL.COM"

完成上述设置后，我们可以通过 git config -l 命令来查看设置是否生效。

Git添加 SSH 公钥

我们通过下面的命令生成密钥，请将命令中的 YOUR_EMAIL@YOUREMAIL.COM替换为你自己的 Email 地址。

1	ssh-keygen -t rsa -C "YOUR_EMAIL@YOUREMAIL.COM"

在 SSH 生成过程中会出现以下信息，按屏幕的提示操作即可；当提示Enter passphrase ( empty for no passphrase ) : 时，可以直接按两次回车键输入一个空的 passphrase；也可以选择输入一个 passphrase 口令，如果此时你输入了一个 passphrase，请牢记，之后每次提交时都需要输入这个口令来确认，所以建议不填写。

SSH 秘钥生成结束后，你可以在 SSH 目录下看到私钥 id_rsa 和公钥 id_rsa.pub这两个文件，不要把私钥文件 id_rsa 的信息透露给任何人。打开id_rsa.pub，复制里面的内容，打开github里面的setting，点击SSH and GPG keys，在SSH keys中选择New SSH key，将刚才复制的内容粘贴进去，并设置好title，完成上面的操作后，可以通过下面的命令来测试一下是否可以连接 github 服务器。

1	ssh -T git@github.com

如果你操作的电脑是第一次与 github 建立连接，会出现以下警告，

1
2
3

The authenticity of host 'github.com (192.30.**.131)' can't be established.
RSA key fingerprint is SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8.
Are you sure you want to continue connecting (yes/no)?

输入 yes 后回车。此时，如果你在生成 SSH 密钥时设置了 passphrase 口令，会提示你输入口令，输入后回车即可，之前，，没写的直接回车就好。最后，如果你看到以下信息，说明连接成功。

1	Hi dsky1990! You've successfully authenticated, but GitHub does not provide shell access.

hexo

现在git的环境已经配置好，接下来我们来写博客，这里我们用markdowm来写，然后用hexo来生成静态页面。

npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server

然后我们根据提示，可以在http://localhost:4000/打开页面了。
写好markdowm文件后，我们可以直接在游览器里面查看，没问题后，就可以用下面的命令

1	hexo generate

在public文件夹中就会生成对应的静态页面，然后我们可以修改_config.yml文件，然后修改deploy标签，改为

deploy:
    type: github
    respository: 自己的git仓库地址
    branch: master

接下来我们只需要用到下面的命令就可以直接将页面push到仓库了

1
2
3

hexo clean
hexo generate
hexo deploy

如果报错的话，将deploy 的 type 改成 git，然后再在运行以下命令

1	npm install hexo-deployer-git --save

再重新来一遍

1
2
3

hexo clean
hexo generate
hexo deploy

hexo是可以修改主题的，推荐的话用yilia，至于主题的配置看文档就好了，这里就不多说了，接下来说说如何配置gitpages。

gitpages

登录后系统，在github首页，点击页面右下角「New Repository」，填写项目信息，注意project name一定要填写username.github.io，其中username是自己的用户名，比如博主的是dsky100，那么project name一定要填写dsky100.github.io，然后一步步跟着指导走，最后点击「Create Repository」完成创建。
接下来我们在本地：

1	git clone projectUrl

接着然后我们可以将hexo生成的文件copy过来，然后

1
2
3

git add *
git commit -m "message"
git push origin master

或者用上面的

1
2
3

hexo clean
hexo generate
hexo deploy

提交完后我们就可以在游览器中打开username.github.io查看我们的页面了。