浅谈使用jekyll搭建个人博客

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

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

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

在进入正题之前,先上张最终效果图:
浅谈使用jekyll搭建个人博客_第1张图片
进去之后也有许多功能,几乎可以满足个人博客需求。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 下来的文档进行局部修改,然后提交上去。
注意:提交过程可能会出错,根据提示一步步去改错。使用上文提到的解决方法应该可以解决。

参考文档

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

你可能感兴趣的:(github,git,微信公众号,搭建个人博客,jekyll,github)