共计 2130 个字符，预计需要花费 6 分钟才能阅读完成。
实际上，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 环境了，不值得。
我的经验是：安装越麻烦的，模版本身其实反而更丑更差劲????。
涉及 Node.js 技术的模版安装方法
Github 社区里的 Jekyll 模版流行使用 nodejs 的 npm 的 gulp 来编译 scss 这些东西。所以如果你没注意到主题的说明文档里提到的 gulp, npm 之类，就会发现用 jekyll serve 无法进行网站生成。
这种情况下，只需要：安装 Node.js -> 使用 npm -> 安装 gulp -> 命令行使用 gulp 编译网站中的 css 文件。不过大多数情况下你的机器已经自带了 nodejs 和 npm（Windows 除外），所以：
$ cd < 主题的目录 >
# 安装此项目的依赖环境
$ npm install
# 编译此项目中的相关文件
$ gulp run
小 1 分钟后，就会看到 gulp 开启了一个端口，并自动打开了你的 chrome 浏览器，打开了这个项目的网页（你会看到无法显示出正常效果，因为这里 gulp 这是用来编译 css 的，它运行不了 jekyll 项目）。然后 ctrl+ c 退出，再打开 jekyll 命令编译网站就行了 -_-!
吐槽一下：请回想，为了安装个 jekyll 和主题，此时你已经经历了一个真的不算短的学习历程了：GitHub Pages -> Jekyll 框架 -> .yml 文件语法和配置 -> Liquid 动态语言 -> Ruby -> gem -> bundle -> HTML+CSS+JS -> nodejs -> npm -> gulp……这其中哪一步都值得说上一段时间。然后回想起当初，其实你只是想在 GIthub Pages 里建个静态网页而已。
常见问题
运行 Jekyll serve 总报错：ERROR `/sw.js’ not found
根据这个 Stackoverflow 的回答：sw.js 是 Service worker 的意思，是自动生成的。基本上不会造成什么影响，但是主要出现这个错误，jekyll 就没法同步更新。
根据我的实际体验，这不是主题的问题，而是 jekyll 的问题：对每个主题都报有这个错误。
