jekyll - 如何安装 Github Pages 的 Jekyll 主题之一进行本地预览？

Question

我正在尝试安装 Github Pages 的 Slate theme在我的 CentOS 7 虚拟机上，这样我就可以使用 bundle exec jekyll serve 命令在本地预览我的新 站点。

我已尽我所能按照说明进行操作。

• 我在我的 _config.yml 文件中将主题 minima 更改为 jekyll-theme-slate。
• 然后我在 Gemfile gem "minima", "~> 2.0" 更改为 gem "github-pages", group: :jekyll_plugins 文件。

在那之后(因为这些是他们唯一的说明)，我运行了 bundle exec jekyll serve 并且它告诉我我有没有安装的 gems (duh)，并建议运行 bundle安装。

• 我运行了 bundle install，它告诉我依赖项的版本类型存在冲突，这表明 bundle update 可能会解决该问题。
• 没问题，我运行了 bundle update。一些插件/功能实际上在这里恢复了版本，但我现在在我的机器上安装了 Slate 主题，无论出于何种原因版本 0.0.4。

之后，我再次运行 bundle exec jekyll serve。我收到此错误:

Configuration file: /home/peri/my-site/_config.yml
Configuration file: /home/peri/my-site/_config.yml
jekyll 3.4.3 | Error:  Could not find a JavaScript runtime. See https://github.com/rails/execjs for a list of available runtimes.

在某种程度上，这个错误是有道理的。为了使自定义主题起作用，我可能需要一个工具来运行他们的自定义脚本。但首先，我注意到 this extra section在主题的安装说明中，直接提到能够在本地预览具有该主题的站点。

• 我下载了源代码，而不是克隆它...我不需要 .git 东西吗？
• 我编辑了 script/bootstrap 文件，因为 /usr/local 需要 root 并且使用 sudo 不知道任何名为 gem 或 bundle。我将 gem 和 bundle 更改为它们各自的绝对路径，并在 slate-master 中运行了 sudo ./script/bootstrap >.

故事的重点是，当我运行 bundle exec jekyll serve 时，它对我的​​ home/peri/my-site 目录不起作用。大概是因为他们打算将用户的站点集成到他们的主题源代码中？这似乎不直观或不正确。所以，我调查了ExecJS .

• 我安装了它。 gem 安装 execjs
• 我将 gem "execjs", "2.7.0" 添加到我的 Gemfile 文件中。

和之前一样的错误。

How am I supposed to install this Jekyll theme?

Answer 1

在 _config.yml 中更改主题后执行以下步骤:

1. Gemfile 应该只有这个内容:

   source "https://rubygems.org"
   gem "github-pages"
   

2. 删除 bundler 当前配置:rm -r .bundle/

3. 删除 Gemfile.lock:rm Gemfile.lock

4. 在这个网站的独立文件夹中安装本地依赖项:bundle install --path=vendor/bundle

5. 您不会有post 和page 以及home 主题，您只需要使用default 在你所有的帖子中。

6. 生成并运行服务器:bundle exec jekyll s