浅谈使用jekyll搭建个人博客

假期看到圈内一位好友在在自己的github上利用jekyll搭建个人博客，挺有趣的。于是撸起袖子也想搞一个。

之前没有做过类似的程序，找了一堆参考价值不大的资料，也用过python中的扩展库做过。最后结果没达到想要的，还是回到github，基于此，搭建个人博客。

本文不准备详细地谈论搭建过程的细节问题，后面会推荐相应实用的文档供读者参考。本文主要讨论下，搭建个人博客时碰到的一些棘手问题以及需要准备的基础知识。

在进入正题之前，先上张最终效果图：

进去之后也有许多功能，几乎可以满足个人博客需求。Solarzhou’s Blog （喜欢请star）

基础知识

此站是基于 Github pages + Jekyll + Ruby + Git +md 搭建的。
虽然上面列出的知识好像挺多的，其实所涉及的知识都较浅。GitHub 和 Git 有必要了解，毕竟在这个开源社区有许多好用的项目，而我们也是将自己的仓库交由 github 来托管。Git 中常用的命令要掌握，如删除，提交，更新。

Ruby，虽然涉及都 ruby 语言，但是整个过程下来几乎不用编程，主要是配置；若是ruby 零基础的大可不必担心，我们只需下载Ruby编译器及相关的包即可。其余的可在终端通过相应的命令去安装，或更新。

md，这是一款标记语言，可以为程序员省去好多事。此标记语言重内容轻格式，可以让编写文档的人员将大把的时间花在内容上。md 标记语言很容易熟悉，同时这也是值得掌握。

搭建博客所遇到的问题

搭建个人博客，jekyll框架提供了许多丰富的功能，也为我们省去许多麻烦。我们可以直接clone别人的模范，然后上传至自己的远程仓库去进行托管。但是，在制作个人博客时，遇到棘手的问题也真不少，好在逐个都解决了。
下面，列出自己在搭建个人博客时所遇到一些问题。
- 问题 1

Could not load Bundler. Bundle install skipped. 

接着使用jekyll serve 的时候提示没有运行所需的buddle，从stackoverflow上找到的答案：使用 “gem install kekyll bundle” 便可解决。

• 问题 2

Could not find public_suffix-3.0.0 in any of the sources (Bundler::GemNotFound)

如果将别人的项目直接clone下来，许多时候都会出现如上所示的错误。查阅资料发现，这是导致自身配置路径出现混乱而出现的问题。因此可以通过命令’ bundle install –path vendor/cache ’ or ’ bundle install –no-deployment ’ 去重新修正。

• 问题 3

You have already activated public_suffix 3.0.2,but your Gemfile requires public_suffix 3.0.0. Prepending `bundle exec` to your command may solve this. (Gem::LoadError)

在解决问题 1 之后，这应该不算问题。此时只需执行” bundle exec jekyll serve “去启动服务器即可解决。（在这之前若一直使用 ‘jekyll s’ 启动，之后稍加注意即可。）

上述所提到的，可以解决搭建过程中的许多问题。接着，简单提下具体步骤：
1. 打开此电脑，选择一个文件夹，比如 f 盘的 test 文件，右键空白处点击 git bash here, 将该文件在终端打开；
2. 执行命令git clone [email protected]:tzhou2018/tzhou2018.github.io.git 将远程仓库clone下来
3. 对 clone 下来的文档进行局部修改，然后提交上去。
注意：提交过程可能会出错，根据提示一步步去改错。使用上文提到的解决方法应该可以解决。

参考文档

搭建个人博客参考文档一
我当时主要参考的是这个文档，其中有好几处需要注意。若碰到一些问题，可以联系我尝试解决。