Github Page博客配置

转自我的博客(http://gongzheng92.net)

---

Github Page博客配置

几经纠结，决定开始写博客，然而希望博客的配置环境是：

在本机利用markdown写作为md文件，利用git管理，然后同时更新gitpage的博客与csdn的博客。

因此配置流程为：
1. csdn博客准备
2. git博客准备，以及本地jekyll的搭建
3. 本地markdown环境的准备。
这几条中，第一条是由于得知csdn可以直接接受本地上传的md文件，因此决定开始在csdn上面写东西。然而之前由于csdn账号注册的较为杂乱，因此想先统一账号后再进行后续工作。但在这其中csdn的各种表现让人非常不爽，包括且不限于：确认邮件送达时间非常缓慢，用户名、昵称分别独立，且均不允许重复，邮箱修改极为繁琐等等，待我有时间另起博文叙述。反正直到我在写本文时csdn的账号邮箱仍然没有更改。

第二，git博客准备，以及本地jekyll的搭建
git page 的博客搭建网上资料颇为丰富，例如

1. 通过GitHub Pages建立个人站点（详细步骤）
2. Run Jekyll on Windows
3. jekyll quick start

其中3是jekyll的官方教程。

Windows平台搭建jekyll

因为我先安装windows平台，因此没有直接按照官方教程，而是按照[2]来的。

在运行

gem update

时，出现了

Please update your PATH to include build tools or download the DevKit from 'http://rubyinstaller.org/downloads' and follow the instructions at 'http://github.com/oneclick/rubyinstaller/wiki/Development-Kit

的报错。

查找后发现是ruby的版本和devkit的版本不一致，装成了64位的。请注意保证ruby和devkit的版本一致。
然后在执行

gem install Jekyll

这步时，出现了

Unable to download data from https://rubygems.org/ 
- SSL_connect returned=1 errno=0 state=SSLv3 read
server certificate B: certificate verify failed 
(https://rubygems.org/latest_specs.4.8.gz)

这样的错误，经查找是由于ruby的官网证书发行者变更的原因造成的bug，这篇文章给出了很好的解决方法：Fixing SSL_connect error while installing Ruby Gems on Windows

然后终于可以开始执行服务器了：

jekyll server

结果又出现

D:/Ruby23/lib/ruby/gems/2.3.0/gems/bundler-1.13.4/lib/bundler/resolver.rb:366:in `block in verify_gemfile_dependencies_are_found!': Could not find gem 'jekyll-sitemap x64-mingw32' in any of the gem sources listed in your Gemfile or available on this machine. (Bundler::GemNotFound)

于是按照字面意思执行：

gem install bundler

结果再开服务器时发现：

in `block in verify_gemfile_dependencies_are_found!': Could not find gem 'jekyll-sitemap x64-mingw32' in any of the gem sources listed in your Gemfile or available on this machine. (Bundler::GemNotFound)

查找后发现：jekyll broke after 2.5 upgrade解决了这个问题：
在管理员权限下：

gem cleanup
bundle exec jekyll serve

然后再报错，执行

bundle install

再开服务器，可以了！

然后我发现了一个可怕的事情。。。。。我想换hexo了！！！！

原因是刚刚搭建好jekyll后，在查找主题的时候突然发现hexo有更多好看的主题，而且支持的特性也更多。于是直接忍不了了。。继续折腾！

Hexo的搭建

hexo的搭建指南有很多，例如

1. 史上最详细的Hexo博客搭建图文教程
2. 使用 Github Pages + Hexo + 多说 搭建博客全过程 - 基础篇
3. 官方文档
4. Jekyll迁移到Hexo搭建个人博客

其中4是卧的学习对象，于是就按照它设置了新的博客。