asciidoctor-html5s 0.1.0.beta.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c16c90fa30631f549c6e9a6f9677919571dc2d69
+  data.tar.gz: 73ea5fbfd2ee70c5d361e1c8b6d5ef3ef4b6d804
+SHA512:
+  metadata.gz: 9fd08e3a180262d33d54d187fe373286306405b65d0a49e5a295e0b5c7116c790dcf678e4a6300d6a20c43ea4f6746463539b292f177e23a30fc4985e2c7a30e
+  data.tar.gz: 87bc0fba47221dd500b4ffe14c1f507aa608d9816ca809b18788c29a3cd8f27eefa49ce488b81122e0f93f3e97669d8faed8a89250d37613d5210f6d46b8ddc2

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright 2014-2017 Jakub Jirutka <jakub@jirutka.cz> and the Asciidoctor Project.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.adoc

@@ -0,0 +1,62 @@
+= Semantic HTML5 Backend For Asciidoctor
+// custom
+:gem-name: asciidoctor-html5s
+:gh-name: jirutka/{gem-name}
+:gh-branch: master
+
+ifdef::env-github[]
+image:https://travis-ci.org/{gh-name}.svg?branch={gh-branch}[Build Status, link="https://travis-ci.org/{gh-name}"]
+image:https://img.shields.io/gem/v/{gem-name}.svg?style=flat[Gem Version, link="https://rubygems.org/gems/{gem-name}"]
+endif::env-github[]
+
+This project provides alternative HTML5 converter (backend) for http://asciidoctor.org/[Asciidoctor] that focuses on correct semantics, accessibility and compatibility with common typographic CSS styles.
+
+
+== Goals
+
+* Clean markup with correct HTML5 semantics.
+* Good accessibility for people with disabilities.
+* Compatibility with common typographic CSS styles when possible and especially with GitHub and GitLab.
+* Full standalone converter without fallback to the built-in Asciidoctor converters.
+* Easy to use and integrate into third-party projects.
+* Well readable and maintainable code – this should be never sacrificed for performance (I’m looking at you, Asciidoctor!).
+
+
+== Non-goals
+
+* Compatibility with existing Asciidoctor CSS styles.
+
+
+== Requirements
+
+* https://www.ruby-lang.org/[Ruby] 2.0+ or http://jruby.org/[JRuby] 9.1+
+* https://rubygems.org/gems/asciidoctor/[Asciidoctor] 1.5.5+
+* https://rubygems.org/gems/thread_safe/[thread_safe] (not required, but recommended)
+
+Note: This converter consists of https://github.com/slim-template/slim/[Slim] templates, but they are precompiled into pure Ruby code using https://github.com/jirutka/asciidoctor-templates-compiler/[asciidoctor-templates-compiler], so you don’t need Slim to use it!
+
+
+== Installation
+
+Install {gem-name} from Rubygems:
+
+[source, sh, subs="+attributes"]
+gem install {gem-name}
+
+or to get the latest development version:
+
+[source, sh, subs="+attributes"]
+gem install --pre {gem-name}
+
+
+== Usage
+
+[source, sh, subs="+attributes"]
+asciidoctor -r {gem-name} -b html5s FILE...
+
+
+== License
+
+This project is licensed under http://opensource.org/licenses/MIT/[MIT License].
+For the full text of the license, see the link:LICENSE[LICENSE] file.
+

data/asciidoctor-html5s.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+require File.expand_path('lib/asciidoctor/html5s/version', __dir__)
+
+Gem::Specification.new do |s|
+  s.name          = 'asciidoctor-html5s'
+  s.version       = Asciidoctor::Html5s::VERSION
+  s.author        = 'Jakub Jirutka'
+  s.email         = 'jakub@jirutka.cz'
+  s.homepage      = 'https://github.com/jirutka/asciidoctor-html5s'
+  s.license       = 'MIT'
+
+  s.summary       = 'Semantic HTML5 converter (backend) for Asciidoctor'
+  s.description   = <<-EOF
+This project provides alternative HTML5 converter (backend) for Asciidoctor
+that focuses on correct semantics, accessibility and compatibility with common
+typographic CSS styles.
+EOF
+
+  s.files         = Dir['data/**/*', 'lib/**/*', '*.gemspec', 'LICENSE*', 'README*']
+  s.has_rdoc      = false
+
+  s.required_ruby_version = '>= 2.0'
+
+  s.add_runtime_dependency 'asciidoctor', '~> 1.5.5'
+  s.add_runtime_dependency 'thread_safe', '~> 0.3.4'
+
+  s.add_development_dependency 'asciidoctor-doctest', '= 2.0.0.beta.4'
+  s.add_development_dependency 'asciidoctor-templates-compiler', '~> 0.1.2'
+  s.add_development_dependency 'bundler', '~> 1.6'
+  s.add_development_dependency 'coderay', '~> 1.1'
+  s.add_development_dependency 'rake', '~> 10.0'
+  s.add_development_dependency 'slim', '~> 3.0'
+  s.add_development_dependency 'slim-htag', '~> 0.1.0'
+end

data/data/templates/_attribution.html.slim

@@ -0,0 +1,4 @@
+footer
+  '—
+  cite
+    =[(attr :attribution), (attr :citetitle)].compact.join(', ')

data/data/templates/_footer.html.slim

@@ -0,0 +1,8 @@
+#footer-text
+  - if attr? :revnumber
+    | #{attr 'version-label'} #{attr :revnumber}
+  - if attr? 'last-update-label'
+    br
+    | #{attr 'last-update-label'} #{attr :docdatetime}
+- unless (docinfo_content = (docinfo :footer)).empty?
+  =docinfo_content

data/data/templates/_footnotes.html.slim

@@ -0,0 +1,11 @@
+section.footnotes aria-label='Footnotes' role='doc-endnotes'
+  hr
+  ol.footnotes
+    - footnotes.each do |fn|
+      li.footnote id=(footnote_id fn.index) role='doc-endnote'
+        ="#{fn.text} "
+        a.footnote-backref [
+            href="##{footnoteref_id fn.index}"
+            role='doc-backlink'
+            title='Jump to the first occurrence in the text' ]
+          | ↩

data/data/templates/_hdlist.html.slim

@@ -0,0 +1,20 @@
+= block_with_title :class=>'hdlist'
+  table
+    - if (attr? :labelwidth) || (attr? :itemwidth)
+      colgroup
+        col style=style_value(width: [(attr :labelwidth), '%'])
+        col style=style_value(width: [(attr :itemwidth), '%'])
+    - items.each do |terms, dd|
+      tr
+        th.hdlist1 class=('strong' if option? 'strong')
+          - terms = [*terms]
+          - terms.each_with_index do |dt, idx|
+            =dt.text
+            - unless idx >= terms.count - 1
+              br
+        td.hdlist2
+          - unless dd.nil?
+            - if dd.text?
+              p =dd.text
+            - if dd.blocks?
+              =dd.content

data/data/templates/_header.html.slim

@@ -0,0 +1,27 @@
+- if has_header?
+  - unless notitle
+    h1 =header.title
+  - if [:author, :revnumber, :revdate, :revremark].any? {|a| attr? a }
+    .details
+      - if attr? :author
+        span.author#author =(attr :author)
+        br
+        - if attr? :email
+          span.email#email =sub_macros(attr :email)
+          br
+        - if (authorcount = (attr :authorcount).to_i) > 1
+          - (2..authorcount).each do |idx|
+            span.author id="author#{idx}" =(attr "author_#{idx}")
+            br
+            - if attr? "email_#{idx}"
+              span.email id="email#{idx}" =sub_macros(attr "email_#{idx}")
+      - if attr? :revnumber
+        span#revnumber #{((attr 'version-label') || '').downcase} #{attr :revnumber}#{',' if attr? :revdate}
+        '
+      - if attr? :revdate
+        time#revdate datetime=revdate_iso =(attr :revdate)
+      - if attr? :revremark
+        br
+        span#revremark =(attr :revremark)
+- if (attr? :toc) && (attr? 'toc-placement', 'auto')
+  include _toc.html

data/data/templates/_qanda.html.slim

@@ -0,0 +1,12 @@
+= block_with_title :class=>'qlist qanda', :role=>'doc-qna'
+  dl.qanda
+    - items.each do |questions, answer|
+      - [*questions].each do |question|
+        dt.qanda-question =question.text
+      - unless answer.nil?
+        dd.qanda-answer
+          - if answer.text?
+            = html_tag_if answer.blocks?, :p
+              =answer.text
+          - if answer.blocks?
+            =answer.content

data/data/templates/_toc.html.slim

@@ -0,0 +1,4 @@
+nav#toc class=(attr 'toc-class', 'toc') role='doc-toc'
+  h2#toctitle =(attr 'toc-title')
+  / Renders block_outline.html.
+  = converter.convert document, 'outline'

data/data/templates/admonition.html.slim

@@ -0,0 +1,10 @@
+- capture
+  h6 =(title || caption)
+  = html_tag_if !blocks?, :p
+    =content
+- if admonition_aside?
+  aside.admonitionblock id=id class=[(attr :name), role] role=admonition_aria
+    - yield_capture
+- else
+  section.admonitionblock id=id class=[(attr :name), role] role=admonition_aria
+    - yield_capture

data/data/templates/audio.html.slim

@@ -0,0 +1,7 @@
+= block_with_caption :bottom, :class=>'audioblock'
+  audio [
+      src=media_uri(attr :target)
+      autoplay=(option? 'autoplay')
+      controls=!(option? 'nocontrols')
+      loop=(option? 'loop') ]
+    | Your browser does not support the audio tag.

data/data/templates/colist.html.slim

@@ -0,0 +1,4 @@
+/ Note: We ignore title on callout list here.
+ol.colist id=id class=[style, role]
+  - items.each do |item|
+    li =item.text

data/data/templates/dlist.html.slim

@@ -0,0 +1,13 @@
+- case style
+- when 'qanda'
+  include _qanda.html
+- when 'horizontal'
+  include _hdlist.html
+- else
+  = block_with_title :class=>['dlist', style]
+    dl
+      - items.each do |terms, dd|
+        - [*terms].each do |dt|
+          dt =dt.text
+        - unless dd.nil?
+          dd =(print_item_content dd)

data/data/templates/document.html.slim

@@ -0,0 +1,30 @@
+doctype 5
+html lang=(attr :lang, 'en' unless attr? :nolang)
+  head
+    meta charset=(attr :encoding, 'UTF-8')
+    /[if IE]
+      meta http-equiv="X-UA-Compatible" content="IE=edge"
+    meta name='viewport' content='width=device-width, initial-scale=1.0'
+    meta name='generator' content="Asciidoctor #{attr 'asciidoctor-version'}"
+    = html_meta_if 'application-name', (attr 'app-name')
+    = html_meta_if 'author', (attr :authors)
+    = html_meta_if 'copyright', (attr :copyright)
+    = html_meta_if 'description', (attr :description)
+    = html_meta_if 'keywords', (attr :keywords)
+    title=((doctitle sanitize: true) || (attr 'untitled-label'))
+    = styles_and_scripts
+    - unless (docinfo_content = docinfo).empty?
+      =docinfo_content
+  body [
+      id=id
+      class=[(attr :doctype), ("#{attr 'toc-class'} toc-#{attr 'toc-position', 'left'}" if (attr? 'toc-class') && (attr? :toc) && (attr? 'toc-placement', 'auto'))]
+      style=style_value(max_width: (attr 'max-width')) ]
+    - unless noheader
+      header
+        include _header.html
+    #content =content
+    - unless !footnotes? || (attr? :nofootnotes)
+      include _footnotes.html
+    - unless nofooter
+      footer
+        include _footer.html

data/data/templates/embedded.html.slim

@@ -0,0 +1,5 @@
+- unless notitle || !has_header?
+  h1 id=id =header.title
+=content
+- unless !footnotes? || (attr? :nofootnotes)
+  include _footnotes.html

data/data/templates/example.html.slim

@@ -0,0 +1,2 @@
+= block_with_caption :top, :class=>'exampleblock'
+  =content

data/data/templates/floating_title.html.slim

@@ -0,0 +1,2 @@
+h level=(level + 1) id=id class=[style, role]
+  =title

data/data/templates/helpers.rb

@@ -0,0 +1,665 @@
+require 'asciidoctor'
+require 'asciidoctor/html5s'
+require 'date'
+require 'json'
+
+# Needed only in compile-time.
+require 'slim-htag' if defined? Slim
+
+if Gem::Version.new(Asciidoctor::VERSION) <= Gem::Version.new('1.5.1')
+  fail 'asciidoctor: FAILED: HTML5/Slim backend needs Asciidoctor >=1.5.2!'
+end
+
+# Add custom functions to this module that you want to use in your Slim
+# templates. Within the template you can invoke them as top-level functions
+# just like in Haml.
+module Slim::Helpers
+
+  # URIs of external assets.
+  FONT_AWESOME_URI     = '//cdnjs.cloudflare.com/ajax/libs/font-awesome/4.1.0/css/font-awesome.min.css'
+  HIGHLIGHTJS_BASE_URI = '//cdnjs.cloudflare.com/ajax/libs/highlight.js/7.4'
+  MATHJAX_JS_URI       = '//cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-MML-AM_HTMLorMML'
+
+  # Defaults
+  DEFAULT_HIGHLIGHTJS_THEME = 'github'
+  DEFAULT_SECTNUMLEVELS = 3
+  DEFAULT_TOCLEVELS = 2
+
+  # The MathJax configuration.
+  MATHJAX_CONFIG = {
+    tex2jax: {
+      inlineMath:  [::Asciidoctor::INLINE_MATH_DELIMITERS[:latexmath].inspect],
+      displayMath: [::Asciidoctor::BLOCK_MATH_DELIMITERS[:latexmath].inspect],
+      ignoreClass: 'nostem|nolatexmath',
+    },
+    asciimath2jax: {
+      delimiters:  [::Asciidoctor::BLOCK_MATH_DELIMITERS[:asciimath].inspect],
+      ignoreClass: 'nostem|noasciimath',
+    }
+  }.to_json
+
+  VOID_ELEMENTS = %w(area base br col command embed hr img input keygen link
+                     meta param source track wbr)
+
+
+  ##
+  # Captures the given block for later yield.
+  #
+  # @example Basic capture usage.
+  #   - capture
+  #     img src=image_uri
+  #   - if title?
+  #     figure.image
+  #       - yield_capture
+  #       figcaption =captioned_title
+  #   - else
+  #     - yield_capture
+  #
+  # @example Capture with passing parameters.
+  #   - capture do |id|
+  #     img src=image_uri
+  #   - if title?
+  #     figure id=@id
+  #       - yield_capture
+  #       figcaption =caption
+  #   - else
+  #     - yield_capture @id
+  #
+  # @see yield_capture
+  def capture(&block)
+    @_html5s_capture = block
+    nil
+  end
+
+  ##
+  # Yields the captured block (see {#capture}).
+  #
+  # @param *params parameters to pass to the block.
+  # @return A content of the captured block.
+  # @see capture
+  def yield_capture(*params)
+    @_html5s_capture.call(*params) if @_html5s_capture
+  end
+
+  ##
+  # Creates an HTML tag with the given name and optionally attributes. Can take
+  # a block that will run between the opening and closing tags.
+  #
+  # @param name [#to_s] the name of the tag.
+  # @param attributes [Hash] (default: {})
+  # @param content [#to_s] the content; +nil+ to call the block. (default: nil).
+  # @yield The block of Slim/HTML code within the tag (optional).
+  # @return [String] a rendered HTML element.
+  #
+  def html_tag(name, attributes = {}, content = nil)
+    attrs = attributes.inject([]) do |attrs, (k, v)|
+      next attrs if !v || v.nil_or_empty?
+      v = v.compact.join(' ') if v.is_a? Array
+      attrs << (v == true ? k : %(#{k}="#{v}"))
+    end
+    attrs_str = attrs.empty? ? '' : attrs.join(' ').prepend(' ')
+
+    if VOID_ELEMENTS.include? name.to_s
+      %(<#{name}#{attrs_str}>)
+    else
+      content ||= yield if block_given?
+      %(<#{name}#{attrs_str}>#{content}</#{name}>)
+    end
+  end
+
+  ##
+  # Conditionally wraps a block in an element. If condition is +true+ then it
+  # renders the specified tag with optional attributes and the given
+  # block inside, otherwise it just renders the block.
+  #
+  # For example:
+  #
+  #    = html_tag_if link?, 'a', {class: 'image', href: (attr :link)}
+  #      img src='./img/tux.png'
+  #
+  # will produce:
+  #
+  #    <a href="http://example.org" class="image">
+  #      <img src="./img/tux.png">
+  #    </a>
+  #
+  # if +link?+ is truthy, and just
+  #
+  #   <img src="./img/tux.png">
+  #
+  # otherwise.
+  #
+  # @param condition [Boolean] the condition to test to determine whether to
+  #        render the enclosing tag.
+  # @param name (see #html_tag)
+  # @param attributes (see #html_tag)
+  # @param content (see #html_tag)
+  # @yield (see #html_tag)
+  # @return [String] a rendered HTML fragment.
+  #
+  def html_tag_if(condition, name, attributes = {}, content = nil, &block)
+    if condition
+      html_tag name, attributes, content, &block
+    else
+      content || yield
+    end
+  end
+
+  ##
+  # Wraps a block in a div element with the specified class and optionally
+  # the node's +id+ and +role+(s). If the node's +title+ is not empty, then a
+  # nested div with the class "title" and the title's content is added as well.
+  #
+  # @example When @id, @role and @title attributes are set.
+  #   = block_with_title :class=>['quoteblock', 'center']
+  #     blockquote =content
+  #
+  #   <section id="myid" class="quoteblock center myrole1 myrole2">
+  #     <h6>Block Title</h6>
+  #     <blockquote>Lorem ipsum</blockquote>
+  #   </section>
+  #
+  # @example When @id, @role and @title attributes are empty.
+  #   = block_with_title :class=>'quoteblock center', :style=>style_value(float: 'left')
+  #     blockquote =content
+  #
+  #   <div class="quoteblock center" style="float: left;">
+  #     <blockquote>Lorem ipsum</blockquote>
+  #   </div>
+  #
+  # @example When shorthand style for class attribute is used.
+  #   = block_with_title 'quoteblock center'
+  #     blockquote =content
+  #
+  #   <div class="quoteblock center">
+  #     <blockquote>Lorem ipsum</blockquote>
+  #   </div>
+  #
+  # @param attrs [Hash, String] the tag's attributes as Hash),
+  #        or the tag's class if it's not a Hash.
+  # @param title [String, nil] the title.
+  # @yield The block of Slim/HTML code within the tag (optional).
+  # @return [String] a rendered HTML fragment.
+  #
+  def block_with_title(attrs = {}, title = @title, &block)
+    if (klass = attrs[:class]).is_a? String
+      klass = klass.split(' ')
+    end
+    attrs[:class] = [klass, role].flatten.uniq
+    attrs[:id] = id
+
+    if title.nil_or_empty?
+      # XXX quick hack
+      nested = is_a?(::Asciidoctor::List) &&
+          (parent.is_a?(::Asciidoctor::ListItem) || parent.is_a?(::Asciidoctor::List))
+      html_tag_if !nested, :div, attrs, yield
+    else
+      html_tag :section, attrs do
+        [html_tag(:h6, {}, title), yield].join("\n")
+      end
+    end
+  end
+
+  def block_with_caption(position = :bottom, attrs = {}, &block)
+    if (klass = attrs[:class]).is_a? String
+      klass = klass.split(' ')
+    end
+    attrs[:class] = [klass, role].flatten.uniq
+    attrs[:id] = id
+
+    if title.nil_or_empty?
+      html_tag :div, attrs, yield
+    else
+      html_tag :figure, attrs do
+        ary = [yield, html_tag(:figcaption) { captioned_title }]
+        ary.reverse! if position == :top
+        ary.compact.join("\n")
+      end
+    end
+  end
+
+  ##
+  # Delimite the given equation as a STEM of the specified type.
+  #
+  # @param equation [String] the equation to delimite.
+  # @param type [#to_sym] the type of the STEM renderer (latexmath, or asciimath).
+  # @return [String] the delimited equation.
+  #
+  def delimit_stem(equation, type)
+    if is_a? ::Asciidoctor::Block
+      open, close = ::Asciidoctor::BLOCK_MATH_DELIMITERS[type.to_sym]
+    else
+      open, close = ::Asciidoctor::INLINE_MATH_DELIMITERS[type.to_sym]
+    end
+
+    if !equation.start_with?(open) || !equation.end_with?(close)
+      equation = [open, equation, close].join
+    end
+    equation
+  end
+
+  ##
+  # Formats the given hash as CSS declarations for an inline style.
+  #
+  # @example
+  #   style_value(text_align: 'right', float: 'left')
+  #   => "text-align: right; float: left;"
+  #
+  #   style_value(text_align: nil, float: 'left')
+  #   => "float: left;"
+  #
+  #   style_value(width: [90, '%'], height: '50px')
+  #   => "width: 90%; height: 50px;"
+  #
+  #   style_value(width: ['120px', 'px'])
+  #   => "width: 90px;"
+  #
+  #   style_value(width: [nil, 'px'])
+  #   => nil
+  #
+  # @param declarations [Hash]
+  # @return [String, nil]
+  #
+  def style_value(declarations)
+    decls = []
+
+    declarations.each do |prop, value|
+      next if value.nil?
+
+      if value.is_a? Array
+        value, unit = value
+        next if value.nil?
+        value = value.to_s + unit unless value.end_with? unit
+      end
+      prop = prop.to_s.gsub('_', '-')
+      decls << "#{prop}: #{value}"
+    end
+
+    decls.empty? ? nil : decls.join('; ') + ';'
+  end
+
+  def urlize(*segments)
+    path = segments * '/'
+    if path.start_with? '//'
+      @_uri_scheme ||= document.attr('asset-uri-scheme', 'https')
+      path = "#{@_uri_scheme}:#{path}" unless @_uri_scheme.empty?
+    end
+    normalize_web_path path
+  end
+
+
+  ##
+  # Gets the value of the specified attribute in this node.
+  #
+  # This is just an alias for +attr+ method with disabled _inherit_ to make it
+  # more clear.
+  #
+  # @param name [String, Symbol] the name of the attribute to lookup.
+  # @param default_val the value to return if the attribute is not found.
+  # @return value of the attribute or +default_val+ if not found.
+  #
+  def local_attr(name, default_val = nil)
+    attr(name, default_val, false)
+  end
+
+  ##
+  # Checks if the attribute is defined on this node, optionally performing
+  # a comparison of its value if +expect_val+ is not nil.
+  #
+  # This is just an alias for +attr?+ method with disabled _inherit_ to make it
+  # more clear.
+  #
+  # @param name [String, Symbol] the name of the attribute to lookup.
+  # @param default_val the expected value of the attribute.
+  # @return [Boolean] whether the attribute exists and, if +expect_val+ is
+  #   specified, whether the value of the attribute matches the +expect_val+.
+  #
+  def local_attr?(name, expect_val = nil)
+    attr?(name, expect_val, false)
+  end
+
+  ##
+  # @param index [Integer] the footnote's index.
+  # @return [String] footnote id to be used in a link.
+  def footnote_id(index = local_attr(:index))
+    "_footnote_#{index}"
+  end
+
+  ##
+  # @param index (see #footnote_id)
+  # @return [String] footnoteref id to be used in a link.
+  def footnoteref_id(index = local_attr(:index))
+    "_footnoteref_#{index}"
+  end
+
+  def icons?
+    document.attr? :icons
+  end
+
+  def font_icons?
+    document.attr? :icons, 'font'
+  end
+
+  def nowrap?
+    'nowrap' if !document.attr?(:prewrap) || option?('nowrap')
+  end
+
+  def print_item_content(item)
+    wrap = item.blocks? && !item.blocks.all? { |b| b.is_a? ::Asciidoctor::List }
+    [ (html_tag_if(wrap, :p) { item.text } if item.text?), item.content ].join
+  end
+
+  ##
+  # Returns corrected section level.
+  #
+  # @param sec [Asciidoctor::Section] the section node (default: self).
+  # @return [Integer]
+  #
+  def section_level(sec = self)
+    @_section_level ||= (sec.level == 0 && sec.special) ? 1 : sec.level
+  end
+
+  ##
+  # Returns the captioned section's title, optionally numbered.
+  #
+  # @param sec [Asciidoctor::Section] the section node (default: self).
+  # @return [String]
+  #
+  def section_title(sec = self)
+    sectnumlevels = document.attr(:sectnumlevels, DEFAULT_SECTNUMLEVELS).to_i
+
+    if sec.numbered && !sec.caption && sec.level <= sectnumlevels
+      [sec.sectnum, sec.captioned_title].join(' ')
+    else
+      sec.captioned_title
+    end
+  end
+
+  def link_rel
+    'noopener' if option?('noopener') || attr(:window) == '_blank'
+  end
+
+  #--------------------------------------------------------
+  # block_admonition
+  #
+
+  ##
+  # @return [Boolean] should be this admonition wrapped in aside element?
+  def admonition_aside?
+    %w[note tip].include? attr(:name)
+  end
+
+  ##
+  # @return [String, nil] WAI-ARIA role of this admonition.
+  def admonition_aria
+    case attr(:name)
+    when 'note'
+      'note'  # https://www.w3.org/TR/wai-aria/roles#note
+    when 'tip'
+      'doc-tip'  # https://www.w3.org/TR/dpub-aria-1.0/#doc-tip
+    when 'caution', 'important', 'warning'
+      'doc-notice'  # https://www.w3.org/TR/dpub-aria-1.0/#doc-notice
+    end
+  end
+
+  #--------------------------------------------------------
+  # block_listing
+  #
+
+  ##
+  # @return [String] a canonical name of the source-highlighter to be used as
+  #         a style class.
+  def highlighter
+    @_highlighter ||=
+      case (highlighter = document.attr('source-highlighter'))
+      when 'coderay'; 'CodeRay'
+      when 'highlight.js'; 'highlightjs'
+      else highlighter
+      end
+  end
+
+  ##
+  # Returns the callout list attached to this listing node, or +nil+ if none.
+  #
+  # Note: This variable is set by extension
+  # {Asciidoctor::Html5s::AttachedColistTreeprocessor}.
+  #
+  # @return [Asciidoctor::List, nil]
+  def callout_list
+    @html5s_colist
+  end
+
+  def source_lang
+    local_attr :language, false
+  end
+
+  #--------------------------------------------------------
+  # block_open
+  #
+
+  ##
+  # Returns +true+ if an abstract block is allowed in this document type,
+  # otherwise prints warning and returns +false+.
+  def abstract_allowed?
+    if result = (parent == document && document.doctype == 'book')
+      puts 'asciidoctor: WARNING: abstract block cannot be used in a document
+without a title when doctype is book. Excluding block content.'
+    end
+    !result
+  end
+
+  ##
+  # Returns +true+ if a partintro block is allowed in this context, otherwise
+  # prints warning and returns +false+.
+  def partintro_allowed?
+    if result = (level != 0 || parent.context != :section || document.doctype != 'book')
+      puts "asciidoctor: ERROR: partintro block can only be used when doctype
+is book and it's a child of a book part. Excluding block content."
+    end
+    !result
+  end
+
+  #--------------------------------------------------------
+  # block_table
+  #
+
+  def autowidth?
+    option? :autowidth
+  end
+
+  def spread?
+    if !autowidth? || local_attr?('width')
+      'spread' if attr? :tablepcwidth, 100
+    end
+  end
+
+  #--------------------------------------------------------
+  # block_video
+  #
+
+  # @return [Boolean] +true+ if the video should be embedded in an iframe.
+  def video_iframe?
+    ['vimeo', 'youtube'].include? attr(:poster)
+  end
+
+  def video_uri
+    case attr(:poster, '').to_sym
+    when :vimeo
+      params = {
+        autoplay: (1 if option? 'autoplay'),
+        loop:     (1 if option? 'loop')
+      }
+      start_anchor = "#at=#{attr :start}" if attr? :start
+      "//player.vimeo.com/video/#{attr :target}#{start_anchor}#{url_query params}"
+
+    when :youtube
+      video_id, list_id = attr(:target).split('/', 2)
+      params = {
+        rel:      0,
+        start:    (attr :start),
+        end:      (attr :end),
+        list:     (attr :list, list_id),
+        autoplay: (1 if option? 'autoplay'),
+        loop:     (1 if option? 'loop'),
+        controls: (0 if option? 'nocontrols')
+      }
+      "//www.youtube.com/embed/#{video_id}#{url_query params}"
+    else
+      anchor = [attr(:start), attr(:end)].join(',').chomp(',')
+      anchor.prepend('#t=') unless anchor.empty?
+      media_uri "#{attr :target}#{anchor}"
+    end
+  end
+
+  # Formats URL query parameters.
+  def url_query(params)
+    str = params.map { |k, v|
+      next if v.nil? || v.to_s.empty?
+      [k, v] * '='
+    }.compact.join('&amp;')
+
+    str.prepend('?') unless str.empty?
+  end
+
+  #--------------------------------------------------------
+  # document
+  #
+
+  ##
+  # @return [String, nil] the revision date in ISO 8601, or nil if not
+  #   available or in invalid format.
+  def revdate_iso
+    ::Date.parse(revdate).iso8601
+  rescue ArgumentError
+    nil
+  end
+
+  ##
+  # Returns HTML meta tag if the given +content+ is not +nil+.
+  #
+  # @param name [#to_s] the name for the metadata.
+  # @param content [#to_s, nil] the value of the metadata, or +nil+.
+  # @return [String, nil] the meta tag, or +nil+ if the +content+ is +nil+.
+  #
+  def html_meta_if(name, content)
+    %(<meta name="#{name}" content="#{content}">) if content
+  end
+
+  # Returns formatted style/link and script tags for header.
+  def styles_and_scripts
+    scripts = []
+    styles = []
+    tags = []
+
+    stylesheet = attr :stylesheet
+    stylesdir = attr :stylesdir, ''
+    default_style = ::Asciidoctor::DEFAULT_STYLESHEET_KEYS.include? stylesheet
+    linkcss = attr?(:linkcss) || safe >= ::Asciidoctor::SafeMode::SECURE
+    ss = ::Asciidoctor::Stylesheets.instance
+
+    if linkcss
+      path = default_style ? ::Asciidoctor::DEFAULT_STYLESHEET_NAME : stylesheet
+      styles << { href: [stylesdir, path] }
+    elsif default_style
+      styles << { text: ss.primary_stylesheet_data }
+    else
+      styles << { text: read_asset(normalize_system_path(stylesheet, stylesdir), true) }
+    end
+
+    if attr? :icons, 'font'
+      if attr? 'iconfont-remote'
+        styles << { href: attr('iconfont-cdn', FONT_AWESOME_URI) }
+      else
+        styles << { href: [stylesdir, "#{attr 'iconfont-name', 'font-awesome'}.css"] }
+      end
+    end
+
+    if attr? 'stem'
+      scripts << { src: MATHJAX_JS_URI }
+      scripts << { type: 'text/x-mathjax-config', text: "MathJax.Hub.Config(#{MATHJAX_CONFIG});" }
+    end
+
+    case attr 'source-highlighter'
+    when 'coderay'
+      if attr('coderay-css', 'class') == 'class'
+        if linkcss
+          styles << { href: [stylesdir, ss.coderay_stylesheet_name] }
+        else
+          styles << { text: ss.coderay_stylesheet_data }
+        end
+      end
+
+    when 'highlightjs'
+      hjs_base = attr :highlightjsdir, HIGHLIGHTJS_BASE_URI
+      hjs_theme = attr 'highlightjs-theme', DEFAULT_HIGHLIGHTJS_THEME
+
+      scripts << { src: [hjs_base, 'highlight.min.js'] }
+      scripts << { src: [hjs_base, 'lang/common.min.js'] }
+      scripts << { text: 'hljs.initHighlightingOnLoad()' }
+      styles  << { href: [hjs_base, "styles/#{hjs_theme}.min.css"] }
+    end
+
+    styles.each do |item|
+      if item.key?(:text)
+        tags << html_tag(:style) { item[:text] }
+      else
+        tags << html_tag(:link, rel: 'stylesheet', href: urlize(*item[:href]))
+      end
+    end
+
+    scripts.each do |item|
+      if item.key? :text
+        tags << html_tag(:script, type: item[:type]) { item[:text] }
+      else
+        tags << html_tag(:script, type: item[:type], src: urlize(*item[:src]))
+      end
+    end
+
+    tags.join("\n")
+  end
+
+  #--------------------------------------------------------
+  # inline_anchor
+  #
+
+  # @return [String] text of the xref anchor.
+  def xref_text
+    str =
+      if text
+        text
+      elsif (path = local_attr :path)
+        path
+      elsif document.respond_to? :catalog  # Asciidoctor >=1.5.6
+        ref = document.catalog[:refs][attr :refid]
+        if ref.kind_of? Asciidoctor::AbstractNode
+          ref.xreftext((@_xrefstyle ||= document.attributes['xrefstyle']))
+        end
+      else  # Asciidoctor < 1.5.6
+        document.references[:ids][attr :refid || target]
+      end
+    (str || "[#{attr :refid}]").tr_s("\n", ' ')
+  end
+
+  # @return [String, nil] text of the bibref anchor, or +nil+ if not found.
+  def bibref_text
+    if document.respond_to? :catalog  # Asciidoctor >=1.5.6
+      # NOTE: Technically it should be `reftext`, but subs have already been applied to text.
+      text
+    else
+      "[#{target}]"
+    end
+  end
+
+  #--------------------------------------------------------
+  # inline_image
+  #
+
+  # @return [Array] style classes for a Font Awesome icon.
+  def icon_fa_classes
+    [ "fa fa-#{target}",
+      ("fa-#{attr :size}" if attr? :size),
+      ("fa-rotate-#{attr :rotate}" if attr? :rotate),
+      ("fa-flip-#{attr :flip}" if attr? :flip)
+    ].compact
+  end
+end