Как установить / использовать плагины Jekyll в GitHubPages?

Я создал GitHubPage вместе с Jekyll, и в настоящее время я пытаюсь использовать некоторые из основных доступных плагинов. Пока что ничего особенного, я использую плагины из белого списка, особенно этот. Он открывает ссылки в новых вкладках, которые не поддерживаются по умолчанию в Markdown,

Пока что я создал сайт, используя 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, плагин не работает. Он по-прежнему открывает ссылку на той же вкладке.

Что я делаю неправильно?

2 ответа

Решение

Я разработчик Jekyll Target Blank. Страницы GH поддерживают только некоторые плагины https://help.github.com/articles/adding-jekyll-plugins-to-a-github-pages-site/. Я просил, чтобы этот плагин стал поддерживаться, но они ответили, что может быть.

Страницы GitHub используют Kramdown, процессор разметки по умолчанию в Jekyll 3. Вы можете сделать это с помощью Kramdown:

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

Откроется ссылка в новой вкладке, она работает в моем блоге на страницах GitHub.

Если вы используете последнюю версию страниц GitHub, она также должна работать для вас.

Если это не работает, вы всегда можете использовать обычный HTML в ваших файлах разметки и добавлять ссылки, как это с target _blank.

Как мы знаем, из соображений безопасности теперь Github Pages не поддерживает настраиваемые плагины.

Если вы хотите, чтобы сайт Jekyll работал так, как если бы он был локальным, например, чтобы настраиваемые плагины работали должным образом, вот способ, действительно удобный для создания и развертывания сайта Jekyll на страницах Github.

jekyll-deploy-action - действие Github для удобного развертывания сайта Jekyll для страниц GitHub.
https://github.com/jeffreytse/jekyll-deploy-action

Я думаю, что с помощью этого действия ваши проблемы могут быть решены идеально.

Другие вопросы по тегам