')
* Use `.size` to get the length of a collection and `.length` to get the length of a string.
"abc".length
[1, 2, 3].size
* Use `+#[0]+` and `+#[-1]+` to get the first and last element of an Array, respectively, rather than `#first` and `#last`.
NOTE: You still have to use `#first` and `#last` on an Enumerable object that's not an Array.
a = [1, 2, 3]
a[0]
a[-1]
* Pass symbol reference to `.map` when invoking no-args method on iteration variable (parens are required).
lines.map(&:strip)
* When calling `raise` to raise an exception, pass the exception class as the first argument and the message as the second.
Write the message as a sentence, but exclude the period.
raise ::ArgumentError, 'Not a valid argument'
* Use name instead of symbol to alias a method.
alias copy original
* When only one private method, add keyword to method definition; otherwise use block form
* Use `do...end` for multi-line blocks and `{ ... }` for single-line blocks (even when chained)
* Use `{}.tap {|accum| arr.each {|v| accum[v] = v } }` to create a Hash from an Array or Hash
* Use default_ as prefix instead of suffix
////
* try to make assignments in condition if scoped to that block
* close empty block on same line if empty - `rescue ::NameError; end`
////
jekyll-asciidoc-3.0.0/jekyll-asciidoc.gemspec 0000664 0000000 0000000 00000003647 13532407643 0021214 0 ustar 00root root 0000000 0000000 require File.absolute_path 'lib/jekyll-asciidoc/version', __dir__
require 'open3' unless defined? Open3
Gem::Specification.new do |s|
s.name = 'jekyll-asciidoc'
s.version = Jekyll::AsciiDoc::VERSION
s.summary = 'A Jekyll plugin that converts the AsciiDoc source files in your site to HTML pages using Asciidoctor.'
s.description = s.summary
s.authors = ['Dan Allen', 'Paul Rayner']
s.email = ['dan.j.allen@gmail.com']
s.homepage = 'https://github.com/asciidoctor/jekyll-asciidoc'
s.license = 'MIT'
s.metadata = {
'bug_tracker_uri' => 'https://github.com/asciidoctor/jekyll-asciidoc/issues',
'changelog_uri' => 'https://github.com/asciidoctor/jekyll-asciidoc/blob/master/CHANGELOG.adoc',
'mailing_list_uri' => 'http://discuss.asciidoctor.org',
'source_code_uri' => 'https://github.com/asciidoctor/jekyll-asciidoc',
}
# NOTE the required ruby version is informational only
# it tracks the minimum version required by Jekyll >= 3.0.0 (see https://jekyllrb.com/docs/installation/#requirements)
# we don't enforce it because it can't be overridden and can cause builds to break
#s.required_ruby_version = '>= 2.2.0'
files = begin
(result = Open3.popen3('git ls-files -z') {|_, out| out.read }.split ?\0).empty? ? Dir['**/*'] : result
rescue ::SystemCallError
Dir['**/*']
end
s.files = files.grep %r/^(?:lib\/.+|Gemfile|(?:CHANGELOG|LICENSE|README)\.adoc|\.yardopts|jekyll-asciidoc\.gemspec)$/
#s.test_files = files.grep %r/^spec\/./
s.require_paths = ['lib']
s.add_runtime_dependency 'asciidoctor', '>= 1.5.0'
s.add_runtime_dependency 'jekyll', '>= 3.0.0'
s.add_development_dependency 'deep-cover-core', '~> 0.7.0'
s.add_development_dependency 'pygments.rb', '~> 1.2.1'
s.add_development_dependency 'rake', '~> 12.3.2'
s.add_development_dependency 'rspec', '~> 3.8.0'
s.add_development_dependency 'rubocop', '~> 0.74.0'
s.add_development_dependency 'simplecov', '~> 0.17.0'
end
jekyll-asciidoc-3.0.0/lib/ 0000775 0000000 0000000 00000000000 13532407643 0015335 5 ustar 00root root 0000000 0000000 jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc.rb 0000664 0000000 0000000 00000001200 13532407643 0020721 0 ustar 00root root 0000000 0000000 module Jekyll
module AsciiDoc
jekyll_gem_version = ::Gem::Version.new ::Jekyll::VERSION
Jekyll3_0 = (::Gem::Requirement.new '~> 3.0.0').satisfied_by? jekyll_gem_version
Jekyll3_1 = !Jekyll3_0 && ((::Gem::Requirement.new '~> 3.1.0').satisfied_by? jekyll_gem_version)
end
end
require_relative 'jekyll-asciidoc/core_ext'
require_relative 'jekyll-asciidoc/jekyll_ext'
require_relative 'jekyll-asciidoc/utils'
require_relative 'jekyll-asciidoc/mixins'
require_relative 'jekyll-asciidoc/excerpt'
require_relative 'jekyll-asciidoc/converter'
require_relative 'jekyll-asciidoc/integrator'
require_relative 'jekyll-asciidoc/filters'
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/ 0000775 0000000 0000000 00000000000 13532407643 0020403 5 ustar 00root root 0000000 0000000 jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/converter.rb 0000664 0000000 0000000 00000033220 13532407643 0022737 0 ustar 00root root 0000000 0000000 module Jekyll
module AsciiDoc
class Converter < ::Jekyll::Converter
DefaultAttributes = {
'idprefix' => '',
'idseparator' => '-',
'linkattrs' => '@',
}
DefaultFileExtensions = %w(asciidoc adoc ad)
DefaultPageAttributePrefix = 'page'
ImplicitAttributes = {
'env' => 'site',
'env-site' => '',
'site-gen' => 'jekyll',
'site-gen-jekyll' => '',
'builder' => 'jekyll',
'builder-jekyll' => '',
'jekyll-version' => ::Jekyll::VERSION,
}
MessageTopic = Utils::MessageTopic
NewLine = Utils::NewLine
AttributeReferenceRx = /\\?\{(\p{Word}[-\p{Word}]*)\}/
HeaderBoundaryRx = /(?<=\p{Graph}#{NewLine * 2})/
HeaderLineRx = /^=[ \t]+.|^:!?\w[-\w]*!?:(?:[ \t]+.)?/
# Enable plugin when running in safe mode; jekyll-asciidoc gem must also be declared in whitelist
safe true
# highlighter prefix/suffix not used by this plugin; defined only to avoid warning
highlighter_prefix nil
highlighter_suffix nil
def initialize config
@config = config
@logger = ::Jekyll.logger
@page_context = {}
# NOTE jekyll-watch reinitializes plugins using a shallow clone of config, so no need to reconfigure
# NOTE check for Configured only works if value of key is defined in _config.yml as Hash
unless Configured === (asciidoc_config = (config['asciidoc'] ||= {}))
if ::String === asciidoc_config
@logger.warn MessageTopic,
'The AsciiDoc configuration should be defined using Hash on asciidoc key instead of discrete entries.'
asciidoc_config = config['asciidoc'] = { 'processor' => asciidoc_config }
else
asciidoc_config['processor'] ||= 'asciidoctor'
end
old_asciidoc_ext = config.delete 'asciidoc_ext'
asciidoc_ext = (asciidoc_config['ext'] ||= (old_asciidoc_ext || (DefaultFileExtensions * ',')))
asciidoc_ext_re = asciidoc_config['ext_re'] = /^\.(?:#{asciidoc_ext.tr ',', '|'})$/ix
old_page_attr_prefix_def = config.key? 'asciidoc_page_attribute_prefix'
old_page_attr_prefix_val = config.delete 'asciidoc_page_attribute_prefix'
unless (page_attr_prefix = asciidoc_config['page_attribute_prefix'])
page_attr_prefix = old_page_attr_prefix_def ? old_page_attr_prefix_val || '' :
(asciidoc_config.key? 'page_attribute_prefix') ? '' : DefaultPageAttributePrefix
end
asciidoc_config['page_attribute_prefix'] = (page_attr_prefix = page_attr_prefix.chomp '-').empty? ?
'' : %(#{page_attr_prefix}-)
asciidoc_config['require_front_matter_header'] = !!asciidoc_config['require_front_matter_header']
asciidoc_config.extend Configured
if asciidoc_config['require_front_matter_header']
unless (::Jekyll::Utils.method :has_yaml_header?).owner == ::Jekyll::Utils
# NOTE restore original method
::Jekyll::Utils.extend (::Module.new do
define_method :has_yaml_header?, &(Utils.method :has_yaml_header?)
end)
end
else
::Jekyll::Utils.extend (::Module.new do
define_method :has_yaml_header?,
(Utils.method :has_front_matter?).curry[Utils.method :has_yaml_header?][asciidoc_ext_re]
end)
end
end
if (@asciidoc_config = asciidoc_config)['processor'] == 'asciidoctor'
unless Configured === (@asciidoctor_config = (config['asciidoctor'] ||= {}))
asciidoctor_config = @asciidoctor_config
asciidoctor_config.replace symbolize_keys asciidoctor_config
source = ::File.expand_path config['source']
dest = ::File.expand_path config['destination']
case (base = asciidoctor_config[:base_dir])
when ':source'
asciidoctor_config[:base_dir] = source
when ':docdir'
asciidoctor_config[:base_dir] = :docdir
else
asciidoctor_config[:base_dir] = ::File.expand_path base if base
end
asciidoctor_config[:safe] ||= 'safe'
site_attributes = {
'site-root' => ::Dir.pwd,
'site-source' => source,
'site-destination' => dest,
'site-baseurl' => config['baseurl'],
'site-url' => config['url'],
}
attrs = asciidoctor_config[:attributes] = compile_attributes asciidoctor_config[:attributes],
(compile_attributes asciidoc_config['attributes'],
((site_attributes.merge ImplicitAttributes).merge DefaultAttributes))
if (imagesdir = attrs['imagesdir']) && !(attrs.key? 'imagesoutdir') && (imagesdir.start_with? '/')
attrs['imagesoutdir'] = ::File.join dest, (imagesdir.chomp '@')
end
asciidoctor_config.extend Configured
end
end
load_processor
end
def load_processor
case @asciidoc_config['processor']
when 'asciidoctor'
begin
require 'asciidoctor' unless defined? ::Asciidoctor::VERSION
rescue ::LoadError
@logger.error MessageTopic, 'You\'re missing a library required to convert AsciiDoc files. Install using:'
@logger.error '', '$ [sudo] gem install asciidoctor'
@logger.abort_with 'Bailing out; missing required dependency: asciidoctor'
end
else
@logger.error MessageTopic, %(Invalid AsciiDoc processor given: #{@asciidoc_config['processor']})
@logger.error '', 'Valid options are: asciidoctor'
@logger.abort_with 'Bailing out; invalid Asciidoctor processor.'
end
nil
end
def self.get_instance site
site.find_converter_instance self
end
def matches ext
@asciidoc_config['ext_re'].match? ext
end
def output_ext _ext
'.html'
end
def self.before_render document, payload
(get_instance document.site).before_render document, payload if Document === document || Excerpt === document
end
def self.after_render document
(get_instance document.site).after_render document if Document === document || Excerpt === document
end
def before_render document, payload
# NOTE Jekyll 3.1 incorrectly maps the page payload to document.data instead of payload['page']
@page_context[:data] = ::Jekyll::AsciiDoc::Jekyll3_1 ? document.data : payload['page']
record_paths document
end
def after_render _document
@page_context.clear
end
def record_paths document, opts = {}
@page_context[:paths] = paths = {
'docfile' => (docfile = ::File.join document.site.source, document.relative_path),
'docdir' => (::File.dirname docfile),
'docname' => (::File.basename docfile, (::File.extname docfile)),
}
paths.update(
'outfile' => (outfile = document.destination document.site.dest),
'outdir' => (::File.dirname outfile),
'outpath' => document.url
) unless opts[:source_only]
end
def clear_paths
@page_context.delete :paths
end
def load_header document
record_paths document, source_only: true
case @asciidoc_config['processor']
when 'asciidoctor'
opts = @asciidoctor_config.merge parse_header_only: true
header = extract_header document
if (paths = @page_context[:paths])
if opts[:base_dir] == :docdir
opts[:base_dir] = paths['docdir'] # NOTE this assignment happens inside the processor anyway
else
paths.delete 'docdir'
end
opts[:attributes] = opts[:attributes].merge paths
end
if (layout_attr = resolve_default_layout document, opts[:attributes])
opts[:attributes] = opts[:attributes].merge layout_attr
end
# NOTE return instance even if header is empty since attributes may be inherited from config
doc = ::Asciidoctor.load header, opts
else
@logger.warn MessageTopic,
%(Unknown AsciiDoc processor: #{@asciidoc_config['processor']}. Cannot load document header.)
doc = nil
end
clear_paths
doc
end
def convert content
# NOTE don't use nil_or_empty? since that's only provided only by Asciidoctor
return '' unless content && !content.empty?
case @asciidoc_config['processor']
when 'asciidoctor'
opts = @asciidoctor_config.merge header_footer: (data = @page_context[:data] || {})['standalone']
if (paths = @page_context[:paths])
if opts[:base_dir] == :docdir
opts[:base_dir] = paths['docdir'] # NOTE this assignment happens inside the processor anyway
else
paths.delete 'docdir'
end
opts[:attributes] = opts[:attributes].merge paths
end
if (doctype = data['doctype'])
opts[:doctype] = doctype
end
(data['document'] = ::Asciidoctor.load content, opts).extend(Liquidable).convert
else
@logger.warn MessageTopic,
%(Unknown AsciiDoc processor: #{@asciidoc_config['processor']}. Passing through unparsed content.)
content
end
end
private
# Take up to the AsciiDoc document header (if present), then continue to the excerpt separator, if non-blank.
def extract_header document
if (content = document.content)
header = (header_boundary = HeaderBoundaryRx =~ content) ? $` : content
# NOTE at this point, excerpt is already set to an instance of Jekyll::Excerpt unless set in front matter
if ::Jekyll::Page === document || !(::Jekyll::Excerpt === document.data['excerpt'])
header = '' unless HeaderLineRx.match? header
else
document.data['excerpt'] = nil
if (excerpt_separator = document.data['excerpt_separator'] || @asciidoc_config['excerpt_separator'] ||
@config['excerpt_separator']).to_s.empty?
header = '' unless HeaderLineRx.match? header
else
header_boundary = 0 unless header_boundary && (HeaderLineRx.match? header)
if (excerpt_boundary = content.index excerpt_separator, header_boundary)
header = content.slice 0, excerpt_boundary
else
header = content
end
end
end
header
else
''
end
end
def symbolize_keys hash
hash.each_with_object({}) {|(key, val), accum| accum[key.to_sym] = val }
end
def compile_attributes attrs, initial = {}
if (is_array = ::Array === attrs) || ::Hash === attrs
attrs.each_with_object(initial) do |entry, new_attrs|
key, val = is_array ? (((entry.split '=', 2) + ['', '']).slice 0, 2) : entry
if key.start_with? '!'
new_attrs[key.slice 1, key.length] = nil
elsif key.end_with? '!'
new_attrs[key.chop] = nil
# we're reserving -name to mean "unset implicit value but allow doc to override"
elsif key.start_with? '-'
new_attrs.delete key.slice 1, key.length
else
case val
when ::String
new_attrs[key] = resolve_attribute_refs val, new_attrs
when ::Numeric
new_attrs[key] = val.to_s
when true
new_attrs[key] = ''
when nil, false
# we may preserve false in the future to mean "unset implicit value but allow doc to override"
# false already has special meaning for page-layout, so don't coerce it
new_attrs[key] = key == 'page-layout' ? val : nil
else
new_attrs[key] = val
end
end
end
else
initial
end
end
def resolve_attribute_refs text, attrs
if text.empty?
text
elsif text.include? '{'
text.gsub AttributeReferenceRx do
($&.start_with? '\\') ? ($&.slice 1, $&.length) : ((attrs.fetch $1, $&).to_s.chomp '@')
end
else
text
end
end
def resolve_default_layout document, attributes
layout_attr_name = %(#{@asciidoc_config['page_attribute_prefix']}layout)
if attributes.key? layout_attr_name
if ::String === (layout = attributes[layout_attr_name])
if layout == '~@'
layout = 'none@'
elsif (layout.end_with? '@') && ((document.data.key? 'layout') || document.data['layout'])
layout = %(#{(layout = document.data['layout']).nil? ? 'none' : layout}@)
else
layout = nil
end
elsif layout.nil?
layout = 'none'
else
layout = layout.to_s
end
elsif (document.data.key? 'layout') || document.data['layout']
layout = %(#{(layout = document.data['layout']).nil? ? 'none' : layout}@)
else
layout = '@'
end
layout ? { layout_attr_name => layout } : nil
end
# Register pre and post render callbacks for saving and clearing contextual AsciiDoc attributes, respectively.
::Jekyll::Hooks.tap do |hooks|
hooks.register [:pages, :documents], :pre_render, &(method :before_render)
hooks.register [:pages, :documents], :post_render, &(method :after_render)
end
end
end
end
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/core_ext.rb 0000664 0000000 0000000 00000000054 13532407643 0022537 0 ustar 00root root 0000000 0000000 require_relative 'core_ext/regexp/is_match'
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/core_ext/ 0000775 0000000 0000000 00000000000 13532407643 0022213 5 ustar 00root root 0000000 0000000 jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/core_ext/regexp/ 0000775 0000000 0000000 00000000000 13532407643 0023505 5 ustar 00root root 0000000 0000000 jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/core_ext/regexp/is_match.rb 0000664 0000000 0000000 00000000213 13532407643 0025615 0 ustar 00root root 0000000 0000000 # NOTE remove once minimum required Ruby version is at least 2.4
class Regexp
alias match? ===
end unless Regexp.method_defined? :match?
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/excerpt.rb 0000664 0000000 0000000 00000003020 13532407643 0022375 0 ustar 00root root 0000000 0000000 module Jekyll
module AsciiDoc
class Excerpt < ::Jekyll::Excerpt
if Jekyll3_0
def_delegators :@doc, :destination, :url
else
def_delegators :@doc, :destination
end
def initialize primary_doc, excerpt_content
excerpt_doc = primary_doc.dup
excerpt_doc.content = excerpt_content
excerpt_doc.extend NoLiquid unless primary_doc.data['liquid']
super excerpt_doc
end
def extract_excerpt content
# NOTE excerpt_doctype has already been resolved from either the page attribute or front matter variable
if (doctype = (excerpt_data = data)['excerpt_doctype'] ||
(inherited = doc.site.config['asciidoc']['excerpt_doctype']))
excerpt_data['doctype'] = doctype
excerpt_data['excerpt_doctype'] = doc.data['excerpt_doctype'] = doctype if inherited
end
content
end
def output
unless defined? @output
renderer = ::Jekyll::Renderer.new doc.site, self, site.site_payload
@output = renderer.run
trigger_hooks :post_render
end
@output
end
def render_with_liquid?
!(NoLiquid === doc)
end
# NOTE Jekyll 3.0 incorrectly maps to_liquid to primary doc
alias to_liquid data if Jekyll3_0
def trigger_hooks hook_name, *args
#::Jekyll::Hooks.trigger collection.label.to_sym, hook_name, self, *args if collection
::Jekyll::Hooks.trigger :documents, hook_name, self, *args
end
end
end
end
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/filters.rb 0000664 0000000 0000000 00000003156 13532407643 0022405 0 ustar 00root root 0000000 0000000 module Jekyll
module AsciiDoc
module Filters
# A Liquid filter for converting an AsciiDoc string to HTML using {Converter#convert}.
#
# @param input [String] the AsciiDoc String to convert.
# @param doctype [String] the target AsciiDoc doctype.
#
# @example Convert the AsciiDoc page excerpt to inline HTML
# {{ page.excerpt | asciidocify: 'inline' }}
#
# @return [String] the converted result as an HTML-formatted String.
def asciidocify input, doctype = nil
(@context.registers[:cached_asciidoc_converter] ||= (Converter.get_instance @context.registers[:site]))
.convert(doctype ? %(:doctype: #{doctype}#{Utils::NewLine}#{input}) : (input || ''))
end
# A Liquid filter for generating an HTML table of contents from a parsed AsciiDoc document.
#
# @param document [Asciidoctor::Document] the parsed AsciiDoc document for which to generate an HTML table of
# contents.
# @param levels [Integer] the maximum section depth to use; if not specified, uses the value of toclevels document
# attribute.
#
# @example Generate a table of contents from the document for the current page
# {{ page.document | tocify_asciidoc: 3 }}
#
# @return [String] the table of contents as an HTML-formatted String.
def tocify_asciidoc document, levels = nil
::Asciidoctor::Document === document ?
(document.converter.convert document, 'outline', toclevels: (levels.nil_or_empty? ? nil : levels.to_i)) : nil
end
end
::Liquid::Template.register_filter Filters
end
end
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/integrator.rb 0000664 0000000 0000000 00000015151 13532407643 0023111 0 ustar 00root root 0000000 0000000 module Jekyll
module AsciiDoc
# Promotes eligible AsciiDoc attributes to page variables and applies page-level settings to all documents handled
# by the converter included with this plugin. It also copies the custom Pygments stylesheet if Pygments is the
# source highlighter and configured to use class-based styling.
class Integrator < ::Jekyll::Generator
NewLine = Utils::NewLine
PygmentsRootSelector = /^(.+?)\.pygments +{/
# Enable plugin when running in safe mode; jekyll-asciidoc gem must also be declared in whitelist
safe true
def self.get_instance site
site.find_generator_instance self
end
# This method is triggered each time the site is generated, including after any file has changed when running in
# watch mode (regardless of incremental setting).
#
# @param site [Jekyll::Site] the site being processed.
#
# @return [nil] Nothing
def generate site
@converter = converter = Converter.get_instance site
site.pages.select! do |page|
(converter.matches page.ext) ? (integrate page) : true
end
site.collections.each do |name, collection|
collection.docs.select! do |doc|
(converter.matches doc.extname) ? (integrate doc, name) : true
end
end
if site.config['asciidoc']['processor'] == 'asciidoctor'
attrs = site.config['asciidoctor'][:attributes]
attrs['localdate'], attrs['localtime'] = (site.time.strftime '%Y-%m-%d %H:%M:%S %Z').split ' ', 2
if ((attrs['source-highlighter'] || '').chomp '@') == 'pygments' &&
((attrs['pygments-css'] || '').chomp '@') != 'style' && (attrs.fetch 'pygments-stylesheet', '')
generate_pygments_stylesheet site, attrs
end
end
nil
end
# Integrate the page-related attributes from the AsciiDoc document header into the data Array of the specified
# {::Jekyll::Page}, {::Jekyll::Post} or {::Jekyll::Document}.
#
# @param document [::Jekyll::Page, ::Jekyll::Post, ::Jekyll::Document] the page, post, or document to integrate.
# @param collection_name [String] the name of the collection to which this document belongs.
#
# @return [Boolean] whether the document should be published.
def integrate document, collection_name = nil
return true unless (doc = @converter.load_header document)
data = document.data
data['asciidoc'] = true
# NOTE id is already reserved in Jekyll for another purpose, so we'll map id to docid instead
data['docid'] = doc.id if doc.id
data['title'] = doc.doctitle if doc.header?
data['author'] = doc.author if doc.author
if collection_name && (doc.attr? 'revdate')
data['date'] = ::Jekyll::Utils.parse_date doc.revdate,
%(Document '#{document.relative_path}' does not have a valid revdate in the AsciiDoc header.)
end
page_attr_prefix = document.site.config['asciidoc']['page_attribute_prefix']
no_prefix = (prefix_size = page_attr_prefix.length) == 0
adoc_data = doc.attributes.each_with_object({}) do |(key, val), accum|
if no_prefix || ((key.start_with? page_attr_prefix) && (key = key[prefix_size..-1]))
accum[key] = ::String === val ? (parse_yaml_value val) : val
end
end
data.update adoc_data unless adoc_data.empty?
{ 'category' => 'categories', 'tag' => 'tags' }.each do |sole_key, coll_key|
if (sole_val = data[sole_key])
(coll_val = data[coll_key] ||= []).delete sole_val
coll_val.unshift sole_val
elsif (coll_val = data[coll_key])
data[sole_key] = coll_val[0]
end
end
# NOTE excerpt must be set before layout is assigned since excerpt cannot have a layout (or be standalone)
unless ::Jekyll::Page === document
data['excerpt'] = Excerpt.new document, ((excerpt = data['excerpt']) || doc.source)
data['excerpt_origin'] = excerpt ? ((adoc_data.key? 'excerpt') ? 'asciidoc-header' : 'front-matter') : 'body'
end
case data['layout']
when nil
data['standalone'] = true unless data.key? 'layout'
when '', '_auto'
layout = collection_name ? (collection_name.chomp 's') : 'page'
data['layout'] = (document.site.layouts.key? layout) ? layout : 'default'
when false
data['layout'] = 'none'
data['standalone'] = true
end
document.extend Document
document.extend NoLiquid unless data['liquid']
data.fetch 'published', true
end
def generate_pygments_stylesheet site, attrs
css_base = site.source
unless (css_dir = (attrs['stylesdir'] || '').chomp '@').empty? || (css_dir.start_with? '/')
css_dir = %(/#{css_dir})
end
css_name = attrs['pygments-stylesheet'] || 'asciidoc-pygments.css'
css_file = ::File.join css_base, css_dir, css_name
css_style = (attrs['pygments-style'] || 'vs').chomp '@'
css = ::Asciidoctor::Stylesheets.instance.pygments_stylesheet_data css_style
# NOTE apply stronger CSS rule for general text color
css = css.sub PygmentsRootSelector, '\1.pygments, \1.pygments code {'
if site.static_files.any? {|f| f.path == css_file }
::File.write css_file, css unless css == (::File.read css_file)
else
::FileUtils.mkdir_p ::File.dirname css_file
::File.write css_file, css
site.static_files << (::Jekyll::StaticFile.new site, css_base, css_dir, css_name)
end
end
private
# Parse the specified value as though it is a single-line value part of a YAML key/value pair.
#
# Attempt to parse the specified String value as though it is a single-line value part of a YAML key/value pair.
# If the value fails to parse, wrap the value in single quotes (after escaping any single quotes in the value) and
# parse it as a character sequence. If the value is empty, return an empty String.
#
# @param val [String] the value to parse.
#
# @return [Object, String] the value parsed from the string-based YAML value or an empty String if the specified
# value is empty.
def parse_yaml_value val
if val.empty?
''
else
begin
::SafeYAML.load %(--- #{val})
rescue ::StandardError, ::SyntaxError
val = val.gsub '\'', '\'\'' if val.include? '\''
::SafeYAML.load %(--- \'#{val}\')
end
end
end
end
end
end
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/jekyll_ext.rb 0000664 0000000 0000000 00000000223 13532407643 0023077 0 ustar 00root root 0000000 0000000 require_relative 'jekyll_ext/drops/drop'
require_relative 'jekyll_ext/renderer/layouts'
require_relative 'jekyll_ext/site/find_generator_instance'
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/jekyll_ext/ 0000775 0000000 0000000 00000000000 13532407643 0022555 5 ustar 00root root 0000000 0000000 jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/jekyll_ext/drops/ 0000775 0000000 0000000 00000000000 13532407643 0023704 5 ustar 00root root 0000000 0000000 jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/jekyll_ext/drops/drop.rb 0000664 0000000 0000000 00000000561 13532407643 0025177 0 ustar 00root root 0000000 0000000 module Jekyll
module Drops
class Drop
class << self
# NOTE fixes "warning: instance variable @is_mutable not initialized"
prepend (Module.new do
def mutable?
@is_mutable ||= nil # rubocop:disable Naming/MemoizedInstanceVariableName
end
end)
end
end
end
end if defined? Jekyll::Drops::Drop
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/jekyll_ext/renderer/ 0000775 0000000 0000000 00000000000 13532407643 0024363 5 ustar 00root root 0000000 0000000 jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/jekyll_ext/renderer/layouts.rb 0000664 0000000 0000000 00000000433 13532407643 0026410 0 ustar 00root root 0000000 0000000 module Jekyll
class Renderer
# NOTE fixes "warning: instance variable @layouts not initialized"
prepend (Module.new do
def layouts
@layouts = nil unless defined? @layouts
super
end
end)
end
end if Jekyll::Renderer.method_defined? :layouts
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/jekyll_ext/site/ 0000775 0000000 0000000 00000000000 13532407643 0023521 5 ustar 00root root 0000000 0000000 jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/jekyll_ext/site/find_generator_instance.rb 0000664 0000000 0000000 00000000514 13532407643 0030720 0 ustar 00root root 0000000 0000000 module Jekyll
class Site
# Introduce complement to {::Jekyll::Site#find_converter_instance} for generators.
def find_generator_instance type
generators.find {|candidate| type === candidate } || (raise %(No Generators found for #{type}))
end
end
end unless Jekyll::Site.method_defined? :find_generator_instance
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/mixins.rb 0000664 0000000 0000000 00000000401 13532407643 0022232 0 ustar 00root root 0000000 0000000 module Jekyll
module AsciiDoc
Configured = ::Module.new
Document = ::Module.new
module Liquidable
def to_liquid
self
end
end
module NoLiquid
def render_with_liquid?
false
end
end
end
end
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/utils.rb 0000664 0000000 0000000 00000002002 13532407643 0022062 0 ustar 00root root 0000000 0000000 module Jekyll
module AsciiDoc
module Utils
MessageTopic = 'Jekyll AsciiDoc:'
NewLine = ?\n
module_function
# Checks whether the file at the specified path has front matter. For AsciiDoc files, this method always returns
# true. Otherwise, it delegates to {::Jekyll::Utils.has_yaml_header?}.
#
# @param dlg_method [Method] the delegate method to call if this path is not an AsciiDoc file.
# @param asciidoc_ext_rx [Regexp] the regular expression to use to check if this path is an AsciiDoc file.
# @param path [String] the path to check.
#
# @return [Boolean] whether the file at this path has front matter.
def has_front_matter? dlg_method, asciidoc_ext_rx, path
(asciidoc_ext_rx.match? ::File.extname path) || (dlg_method.call path)
end
# NOTE use define_method to match signature of original method (and avoid extra call)
define_method :has_yaml_header?, &(::Jekyll::Utils.method :has_yaml_header?)
end
end
end
jekyll-asciidoc-3.0.0/lib/jekyll-asciidoc/version.rb 0000664 0000000 0000000 00000000100 13532407643 0022404 0 ustar 00root root 0000000 0000000 module Jekyll
module AsciiDoc
VERSION = '3.0.0'
end
end
jekyll-asciidoc-3.0.0/spec/ 0000775 0000000 0000000 00000000000 13532407643 0015521 5 ustar 00root root 0000000 0000000 jekyll-asciidoc-3.0.0/spec/fixtures/ 0000775 0000000 0000000 00000000000 13532407643 0017372 5 ustar 00root root 0000000 0000000 jekyll-asciidoc-3.0.0/spec/fixtures/alternate_page_attribute_prefix/ 0000775 0000000 0000000 00000000000 13532407643 0026005 5 ustar 00root root 0000000 0000000 jekyll-asciidoc-3.0.0/spec/fixtures/alternate_page_attribute_prefix/_config.yml 0000664 0000000 0000000 00000000106 13532407643 0030131 0 ustar 00root root 0000000 0000000 plugins:
- jekyll-asciidoc
asciidoc:
page_attribute_prefix: jekyll-
jekyll-asciidoc-3.0.0/spec/fixtures/alternate_page_attribute_prefix/_layouts/ 0000775 0000000 0000000 00000000000 13532407643 0027644 5 ustar 00root root 0000000 0000000 jekyll-asciidoc-3.0.0/spec/fixtures/alternate_page_attribute_prefix/_layouts/default.html 0000664 0000000 0000000 00000000244 13532407643 0032156 0 ustar 00root root 0000000 0000000
{{ page.title }}
{{ content }}