如何 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
通过这个动作,我想你的问题可以得到完美的解决。
我已经使用 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
通过这个动作,我想你的问题可以得到完美的解决。