如何 Install/Use GitHub Pages 中的 Jekyll 插件?

How to Install/Use Jekyll Plugins in GitHubPages?

我已经使用 Jekyll 创建了一个 GitHub 页面,目前我正在尝试使用一些可用的基本插件。到目前为止没什么特别的,我正在使用列入白名单的插件,特别是 this 一个。它在新标签页中打开 links,Markdown.

默认不支持

到目前为止,我已经使用 myusername.github.io 存储库创建了站点,将其克隆到本地,并按照 here 的说明使用 jekyll new . 创建了一个基本站点。然后我将所有更改推送到 GitHub,一切正常。

然后,为了安装上面提到的插件,我按照帮助部分中提到的步骤进行操作,即这些东西:


Add the following to your site's Gemfile

gem 'jekyll-target-blank'

and add the following to your site's _config.yml

plugins:
  - jekyll-target-blank

另请注意,默认情况下 Gemfile 包含以下部分以及以下说明:

# This will help ensure the proper Jekyll version is running.
# Happy Jekylling!
gem "jekyll", "~> 3.8.3"

# This is the default theme for new Jekyll sites. You may change this to anything you like.
gem "minima", "~> 2.0"

# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
# uncomment the line below. To upgrade, run `bundle update github-pages`.
# gem "github-pages", group: :jekyll_plugins

所以我按照那里的指示更改了 Gemfile 和 运行 bundle update github-pages.

现在我的 Gemfile 看起来像这样:

source "https://rubygems.org"

# Hello! This is where you manage which Jekyll version is used to run.
# When you want to use a different version, change it below, save the
# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
#
#     bundle exec jekyll serve
#
# This will help ensure the proper Jekyll version is running.
# Happy Jekylling!
# gem "jekyll", "~> 3.8.3"

# This is the default theme for new Jekyll sites. You may change this to anything you like.
gem "minima", "~> 2.0"

# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
# uncomment the line below. To upgrade, run `bundle update github-pages`.
gem "github-pages", group: :jekyll_plugins

# If you have any plugins, put them here!
group :jekyll_plugins do
  gem "jekyll-feed", "~> 0.6"
  gem 'jekyll-target-blank'
end

# Windows does not include zoneinfo files, so bundle the tzinfo-data gem
gem "tzinfo-data", platforms: [:mingw, :mswin, :x64_mingw, :jruby]

# Performance-booster for watching directories on Windows
gem "wdm", "~> 0.1.0" if Gem.win_platform?

请注意,我已经 commented/uncommented 了正确的部分。

我的 _config.yml 看起来像这样:

title: xxxxxx
email: xxxxxx
description: >- # this means to ignore newlines until "baseurl:"
  xxxxxx.
baseurl: "" # the subpath of your site, e.g. /blog
url: "" # the base hostname & protocol for your site, e.g. http://example.com

github_username:  xxxxxx
instagram_username: xxxxxx

# Build settings
markdown: kramdown
theme: minima
plugins:
  - jekyll-feed
  - jekyll-target-blank

然后我做了一个

bundle exec jekyll serve

本地 运行 它在 http://127.0.0.1:4000/ 并且插件工作正常。通过单击如下所示的 link,它会在新选项卡中打开 link。

[LinkText](link)

但是,当我将其全部推送到 GitHub 时,该插件不起作用。它仍然会在同一选项卡上打开 link。

我做错了什么?

我是 Jekyll Target Blank 的开发者。 GH Pages 仅支持部分插件 https://help.github.com/articles/adding-jekyll-plugins-to-a-github-pages-site/。我已请求支持此插件,但他们的回应是可能的。

GitHub 页面使用 Kramdown,这是 Jekyll 3 中的默认降价处理器。您可以使用 Kramdown 执行此操作:

[link](url){:target="_blank"}

它将在新选项卡中打开 link,它适用于我的博客 GitHub 页面。

如果您使用的是最新的 GitHub 页版本,它应该也适用于您。

如果这不起作用,您始终可以在降价文件中使用纯 HTML 并添加 links,就像目标 _blank 那样。

众所周知,出于某些安全原因,现在 Github 页面无法支持自定义插件。

如果你想让 Jekyll 站点 运行 就像本地站点一样,比如让自定义插件正常工作,这里有一个构建 Jekyll 站点并将其部署到 Github 页面非常方便

jekyll-deploy-action - A Github Action to deploy the Jekyll site conveniently for GitHub Pages.
https://github.com/jeffreytse/jekyll-deploy-action

通过这个动作,我想你的问题可以得到完美的解决。