94 lines
2.4 KiB
Ruby
94 lines
2.4 KiB
Ruby
module Jekyll
|
|
class PluginManager
|
|
attr_reader :site
|
|
|
|
# Create an instance of this class.
|
|
#
|
|
# site - the instance of Jekyll::Site we're concerned with
|
|
#
|
|
# Returns nothing
|
|
def initialize(site)
|
|
@site = site
|
|
end
|
|
|
|
# Require all the plugins which are allowed.
|
|
#
|
|
# Returns nothing
|
|
def conscientious_require
|
|
require_plugin_files
|
|
require_gems
|
|
self.class.require_from_bundler
|
|
end
|
|
|
|
# Require each of the gem plugins specified.
|
|
#
|
|
# Returns nothing.
|
|
def require_gems
|
|
site.gems.each do |gem|
|
|
if plugin_allowed?(gem)
|
|
Jekyll.logger.debug("PluginManager:", "Requiring #{gem}")
|
|
require gem
|
|
end
|
|
end
|
|
end
|
|
|
|
def self.require_from_bundler
|
|
if ENV["JEKYLL_NO_BUNDLER_REQUIRE"] || !File.file?("Gemfile")
|
|
false
|
|
else
|
|
require "bundler"
|
|
Bundler.setup # puts all groups on the load path
|
|
Bundler.require(:jekyll_plugins) # requires the gems in this group only
|
|
Jekyll.logger.debug("PluginManager:", "Required #{required_gems.map(&:name).join(', ')}")
|
|
ENV["JEKYLL_NO_BUNDLER_REQUIRE"] = "true"
|
|
true
|
|
end
|
|
rescue LoadError, Bundler::GemfileNotFound
|
|
false
|
|
end
|
|
|
|
# Check whether a gem plugin is allowed to be used during this build.
|
|
#
|
|
# gem_name - the name of the gem
|
|
#
|
|
# Returns true if the gem name is in the whitelist or if the site is not
|
|
# in safe mode.
|
|
def plugin_allowed?(gem_name)
|
|
!site.safe || whitelist.include?(gem_name)
|
|
end
|
|
|
|
# Build an array of allowed plugin gem names.
|
|
#
|
|
# Returns an array of strings, each string being the name of a gem name
|
|
# that is allowed to be used.
|
|
def whitelist
|
|
@whitelist ||= Array[site.config['whitelist']].flatten
|
|
end
|
|
|
|
# Require all .rb files if safe mode is off
|
|
#
|
|
# Returns nothing.
|
|
def require_plugin_files
|
|
unless site.safe
|
|
plugins_path.each do |plugins|
|
|
Dir[File.join(plugins, "**", "*.rb")].sort.each do |f|
|
|
require f
|
|
end
|
|
end
|
|
end
|
|
end
|
|
|
|
# Public: Setup the plugin search path
|
|
#
|
|
# Returns an Array of plugin search paths
|
|
def plugins_path
|
|
if (site.config['plugins'] == Jekyll::Configuration::DEFAULTS['plugins'])
|
|
[site.in_source_dir(site.config['plugins'])]
|
|
else
|
|
Array(site.config['plugins']).map { |d| File.expand_path(d) }
|
|
end
|
|
end
|
|
|
|
end
|
|
end
|