利用Jekyll和GitHub Pages搭建静态博客网站

在前端学习初期,我搭建了自己的博客网站,期间参考了很多资料,回顾发现,这一路上也是从按部就班到半主动性。按照搜索到的流程按部就班地操作,总不能达到理想的效果,卡住,卡住,再卡住,分外忧伤。事情可以慢下来,但不能放弃。后来我调整战略,尝试理解Jekyll的运作原理,事情慢慢变得清晰,有条不紊。这篇文章不会涉及到详细的建站过程,而是从另一个角度,简述Jekyll到底是如何发挥“魔力”的。
如果你希望了解建站全过程,可以大力的戳这里~    我的建站全过程    
另外,所使用的系统为win10。

1. 工作场所:Ruby平台

Jekyll是运行在Ruby平台上的程序,所以,最开始要搭建Jekyll的工作环境,然后再安装Jekyll工具,全部安装成功后,你就可以使用Jekyll这个强有力的工具了。

具体步骤:

  • 安装 Ruby & Ruby Development Kit (下载网址:Ruby官网 )
  • 切换到Devkit的安装目录下,执行 ruby dk.rb init,会自动生成config.yml配置文件
  • ruby dk.rb install
  • gem sources --add http://gems.ruby-china.org/ --remove http://rubygems.org/
  • gem install jekyll
  • gem install bundler

注意

  • 安装Jekyll时出现SSL证书问题,一般有两个解决方法:一是更换gems镜像源避免SSL问题;二是安装OpenSSL保证安全下载。我采用了前者,因为简单。

2. 遵守Jekyll的规矩

按规矩好办事。想要使用Jekyll,就必须遵守Jekyll的规矩,你只有按照Jekyll世界的语言、规范,它才能乖乖为你所用。都有哪些规矩:

  • 网站项目的文件结构(结构)
  • HTML模板语言要求(模板和数据注入)

当然,具体的规矩全部都在官方文档中。

3. 中场反思

当你按照上述规矩,把网站需要的全部数据都整理好后,就欠东风了。那么要怎样运行Jekyll,让它把我们准备的这些原材料,加工成真实网站呢?

4. 配置你的Jekyll工具

使用它,那就先配置它。所以,你需要编写一个Gemfile文件。在这个文件中,需要列举你的网站项目中所有将要使用到的工具,比如jekyll,jekyll plugins等等,当然你还要提供下载这些工具的地址,例如http://rubygems.org

5. 使用Jekyll工具

到这里,所有的配置都搞定了。接下来就开始使用Jekyll工具,施展魔法,把我们的原始材料(符合Jekyll文档规范)加工成真实网站。运行以下步骤:

  • bundle install
  • bundle exec Jekyll serve

解释:bundle install之后,便把我们列举在配置文件中的工具全部安装起来;运行bundle exec jekyll serve,Jekyll开始实时工作,即通过它提供的本地服务器进行本地预览(无需联网),你对文件所做的修改,都会直接反映出来,localhost:4000刷新后,便能看到修改后的效果。
还要继续解释一下jekyll serve:前台所做的各种修改,都会被后台运行的Jekyll实时地加工、“翻译”成真实网站,而且,你能够通过localhost:4000本地预览网站。此外,你可以和jekyll build做对比:jekyll build只是将原始材料“翻译”成真实网站(_site文件夹出现),实现jekyll serve的部分功能,但是不会像Jekyll serve那样,可以本地预览,实时加工。

总结

当然,上述步骤2-5可以通过运行jekyll new your-website-name命令,自动生成网站目录结构、Gemfile预定义配置以及相关工具的安装,这也是网上大部分的流程步骤。不过,有关网站的具体内容还是要自己探索,虽然生成的网站也是有预定义的内容(也就是Jekyll Theme),但太过简单,你肯定不会特别满意。这里插一句话,Jekyll Theme其实就是一个完整的Website了。你如果从GitHub上fork了一个你相中的主题,只需要修改一下网站的名称等原作者相关信息后,就可以变成你的网站了。

结尾反思

在参考的资料中有两篇印象特别深刻(墙裂推荐大家看一看!!),一篇是在github上利用github提供的接口原生态的实践jekyll的全部步骤。这篇很基础,给我提供了别样的思路,让我能够深入地思考jekyll的运作原理。另外一篇是传授我们如何利用GitHub上的Jekyll Theme快速搭建自己的博客网站,让我更进一步理解Jekyll文件的编写、HTML模板语法的使用等,让我渐渐不再对Jekyll感到束手无策、毫无头绪,不会再有那种它就是我眼前,却远在天边的感觉。
这个项目是去年11月份开启的,到现在已经有半年时间了。期间也做过几次更新升级,博文也不定期更新(会慢慢迁移到简书上)。捣鼓网站的过程,包括每次的更新升级也都详细记录在有道笔记上备忘。希望能和大家交流思想,共同进步。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,542评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,596评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,021评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,682评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,792评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,985评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,107评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,845评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,299评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,612评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,747评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,441评论 4 333
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,072评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,828评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,069评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,545评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,658评论 2 350

推荐阅读更多精彩内容