Jekyll 安装第三方模版
实际上,Jekyll安装主题是非常反人类的——它一点也不比自己写模版简单,学习成本真是高。
安装主题不是把人家做好的template直接复制过来就能用了。
每个模版设置的变量设置名、依赖的gem包都不一样,还经常需要在本地安装所有依赖包,安装jekyll插件等。如果不懂Ruby gem的话,还真是不简单。
到了这里,一般人真的会问自己应不应该再继续下去。因为明明简单的东西,不知道是不是还值得了。
我相信所有坚持学习jekyll的人,都有自己非学不可的理由吧。
包管理器的理解
Jekyll是用Ruby语言构建的,且每个主题都会有超多的Ruby依赖包。在这里需要先理解一些基本概念才能进行下去。
Ruby
:是语言。这就不说了Gem
:全称RubyGems
,是Ruby的包管理器。相当于Python的pip。每一个包都叫a gem
,在Python里叫package
.Bundler
:是管理gem管理器的管理器……相当于Python的pipenv,管理每个项目的gem包依赖。
简单说,gem主要管理整个系统的Ruby包,下载安装卸载之类。而Bundler只负责管理每个项目的Ruby包依赖。
一般安装方法
先讲讲一般通用的模板安装方法:
- 首先到模版的Github网页里clone下来全部文件。
- 在命令行里打开这个模版的文件夹(其实它就是一个完整的Jekyll文件夹结构)
- 首先直接运行这个主题:
$ jekyll serve
- 如果没有出错能直接使用最好,出错的话就走下一步。
- 输入以下命令安装模版所需的依赖环境:
$ bundle install
- 这样
bundle
命令就会会根据文件夹中的Gemfile
文件下载安装所有模版所需的依赖环境。 - 静等结束之后,一般就可以
$ jekyll serve
直接运行网站了。 - 打开jekyll提示的网站,到处点一点,如果网站能正常运行,那么就可以把自己的markdown文章导入到
_posts
文件夹里了。 - 然后在每篇markdown文章的
Front Matter
里,把theme
改成这个模版的名称,layout
改成这个模版要求的layout等。 - 然后重新运行
jekyll serve
,开始运行服务。 - 复制命令行里提示的本地url地址(每个主题的地址都不同),在浏览器里打开,就可以在网站上看到更新了。
- 如果出错,可以试试下面命令来启动服务,强制服务在当前依赖环境下运行。
$ bundle exec jekyll serve
至此,一般简单的模版都可以搞定了。如果超出任何以上提及内容,我们就要到"特殊安装方法"一节来分析了。
特殊安装方法
一般安装方法解决不了的,基本上算是特殊安装方法了。
经过我尝试了下载和安装几十个下载的主题后,发现如果碰见一个连bundle install
命令都不用,直接jekyll serve
就打开服务的,那简直是像中大奖一样的。
每个主题的安装都不太一样,且遇到的错误都完全不同。通用性极其小。
要想真正安装好一个主题,必须掌握基本的Debug能力,命令行信息的理解能力,如果精通Ruby那么就再好不过了。
基本上我不打算在这里浪费时间把这些情况列出来讨论,只是想把坑分享出来,提醒你不要跳。
如果不是100%确定真的想用这个主题,就不要浪费时间去调试和修改gem环境了,不值得。
我的经验是:安装越麻烦的,模版本身其实反而更丑更差劲
相关推荐
86354492 2020-05-11
83364896 2020-02-18
aluomaidi 2020-02-03
何志文 2020-01-05
83364492 2019-10-28
DevilGoddy 2019-06-30
83364896 2019-06-30
yzhj00 2019-06-28
83364492 2019-06-27
aluomaidi 2019-06-27
倩 2019-06-26
lizhi 2014-04-28
yangxingstar 2019-06-26
gjc 2019-06-26
83364492 2019-06-25
83364492 2019-06-25
87317519 2019-06-25
88304694 2019-06-25