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

How do I install one of Github Pages' Jekyll themes for local preview?

我正在尝试在我的 CentOS 7 虚拟机上安装 Github Pages 的 Slate theme,这样我就可以使用 bundle exec jekyll serve命令。

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

在那之后(因为这些是他们唯一的说明),我 运行 bundle exec jekyll serve 它告诉我我有未安装的 gem (duh),并建议 运行宁bundle install.

之后,我又运行 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,其中直接提到了能够使用该主题在本地预览站点。

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

出现与之前相同的错误。

How am I supposed to install this Jekyll theme?

_config.yml 中更改主题后按照以下步骤操作:

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

    source "https://rubygems.org"
    gem "github-pages"
    
  2. 删除捆绑器当前配置:rm -r .bundle/

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

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

  5. 您不会有 postpagehome 主题,您需要在所有帖子中使用 default

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