如何在GitHubPages中安装/使用Jekyll插件?

时间:2018-08-23 02:57:12

标签: markdown jekyll github-pages jekyll-extensions

我已经与Jekyll一起创建了一个GitHubPage,目前我正在尝试使用一些可用的基本插件。到目前为止,没有什么花哨的地方,我正在使用列入白名单的插件,特别是this一个插件。它会在新标签页中打开链接,Markdown默认不支持。

到目前为止,我已经按照here的说明使用myusername.github.io存储库创建了站点,并将其克隆到本地,并使用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?

请注意,我已经对相应的部分进行了评论/未评论。

我的_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/上本地运行它,该插件可以正常工作。通过单击如下所示的链接,它会按需要在新标签中打开该链接。

[LinkText](link)

但是,当我将其全部推送到GitHub时,该插件不起作用。仍然会在同一标签上打开链接。

我在做什么错了?

3 个答案:

答案 0 :(得分:2)

我是Jekyll Target Blank的开发人员。 GH Pages仅支持某些插件https://help.github.com/articles/adding-jekyll-plugins-to-a-github-pages-site/。我已要求该插件获得支持,但他们的回应可能是这样。

答案 1 :(得分:1)

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

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

它将在新选项卡中打开链接,它可以在GitHub页面上的我的博客上运行。

如果您使用的是最新的GitHub页面版本,它也同样适用。

如果这不起作用,则始终可以在markdown文件中使用纯HTML,并使用目标_blank添加此类链接。

答案 2 :(得分:0)

众所周知,出于安全考虑,现在Github Pages不支持自定义插件。

如果要使 Jekyll网站像本地网站一样运行,例如让自定义插件正常运行,则这是一种真正方便的构建和部署方式Jekyll网站访问Github Pages。

jekyll-deploy-action-Gi Github Action,可为GitHub Pages方便地部署Jekyll网站。
https://github.com/jeffreytse/jekyll-deploy-action

通过此操作,我认为您的问题可以得到完美解决。