asciidoctor-revealjs 3.0.0 → 4.1.0.rc3

data/templates/audio.html.slim

@@ -1,4 +1,4 @@
-.audioblock id=@id class=[@style,role]
+= html_tag('div', { :id => @id, :class => ['audioblock', @style, role] }.merge(data_attrs(@attributes)))
   - if title?
     .title=captioned_title
   .content

data/templates/colist.html.slim

@@ -1,4 +1,4 @@
-.colist id=@id class=[@style,role]
+= html_tag('div', { :id => @id, :class => ['colist', @style, role, ('fragment' if (option? :step) || (attr? 'step'))] }.merge(data_attrs(@attributes)))
   - if title?
     .title=title
   - if @document.attr? :icons

data/templates/dlist.html.slim

@@ -1,6 +1,6 @@
 - case @style
 - when 'qanda'
-  .qlist id=@id class=['qanda',role]
+  = html_tag('div', { :id => @id, :class => ['qlist', @style, role] }.merge(data_attrs(@attributes)))
     - if title?
       .title=title
     ol
@@ -14,7 +14,7 @@
             - if answer.blocks?
               =answer.content
 - when 'horizontal'
-  .hdlist id=@id class=role
+  = html_tag('div', { :id => @id, :class => ['hdlist', role] }.merge(data_attrs(@attributes)))
     - if title?
       .title=title
     table
@@ -38,7 +38,7 @@
               - if dd.blocks?
                 =dd.content
 - else
-  .dlist id=@id class=[@style,role]
+  = html_tag('div', { :id => @id, :class => ['dlist', @style, role] }.merge(data_attrs(@attributes)))
     - if title?
       .title=title
     dl

data/templates/document.html.slim

@@ -2,6 +2,10 @@ doctype 5
 html lang=(attr :lang, 'en' unless attr? :nolang)
   head
     meta charset="utf-8"
+    meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, minimal-ui"
+
+    title=(doctitle sanitize: true, use_fallback: true)
+
     - if RUBY_ENGINE == 'opal' && JAVASCRIPT_PLATFORM == 'node'
       - revealjsdir = (attr :revealjsdir, 'node_modules/reveal.js')
     - else
@@ -13,27 +17,31 @@ html lang=(attr :lang, 'en' unless attr? :nolang)
       - if attr? key
         meta name=key content=(attr key)
     - linkcss = (attr? 'linkcss')
-    title=(doctitle sanitize: true, use_fallback: true)
-    meta content="yes" name="apple-mobile-web-app-capable"
-    meta content="black-translucent" name="apple-mobile-web-app-status-bar-style"
-    meta content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, minimal-ui" name="viewport"
-    link href="#{revealjsdir}/css/reveal.css" rel="stylesheet"
+    link rel="stylesheet" href="#{revealjsdir}/css/reset.css"
+    link rel="stylesheet" href="#{revealjsdir}/css/reveal.css"
+
     / Default theme required even when using custom theme
-    - if attr? :revealjs_customtheme
-      link rel='stylesheet' href=(attr :revealjs_customtheme) id='theme'
-    - else
-      link rel='stylesheet' href='#{revealjsdir}/css/theme/#{attr 'revealjs_theme', 'black'}.css' id='theme'
-    include asciidoctor_revealjs.css.slim
+    link rel='stylesheet' href=(attr :revealjs_customtheme, %(#{revealjsdir}/css/theme/#{attr 'revealjs_theme', 'black'}.css)) id='theme'
+    /! This CSS is generated by the Asciidoctor reveal.js converter to further integrate AsciiDoc's existing semantic with reveal.js
+    style type="text/css"
+      include asciidoctor-compatibility.css
     - if attr? :icons, 'font'
       / iconfont-remote is implicitly set by Asciidoctor core. See https://github.com/asciidoctor/asciidoctor.org/issues/361
       - if attr? 'iconfont-remote'
-        link rel='stylesheet' href=(attr 'iconfont-cdn', %(#{cdn_base}/font-awesome/5.8.2/css/all.min.css))
+        - if (iconfont_cdn = (attr 'iconfont-cdn'))
+          link rel='stylesheet' href=iconfont_cdn
+        - else
+          / default icon font is Font Awesome
+          - font_awesome_version = (attr 'font-awesome-version', '5.15.1')
+          link rel='stylesheet' href=%(#{cdn_base}/font-awesome/#{font_awesome_version}/css/all.min.css)
+          link rel='stylesheet' href=%(#{cdn_base}/font-awesome/#{font_awesome_version}/css/v4-shims.min.css)
       - else
         link rel='stylesheet' href=(normalize_web_path %(#{attr 'iconfont-name', 'font-awesome'}.css), (attr 'stylesdir', ''), false)
     - if attr? :stem
       - eqnums_val = (attr 'eqnums', 'none')
       - eqnums_val = 'AMS' if eqnums_val == ''
       - eqnums_opt = %( equationNumbers: { autoNumber: "#{eqnums_val}" } )
+      - mathjaxdir = (attr 'mathjaxdir', "#{cdn_base}/mathjax/2.7.6")
       script type='text/x-mathjax-config'
         | MathJax.Hub.Config({
           tex2jax: {
@@ -47,60 +55,38 @@ html lang=(attr :lang, 'en' unless attr? :nolang)
           },
           TeX: {#{eqnums_opt}}
           });
-      script src='#{cdn_base}/mathjax/2.4.0/MathJax.js?config=TeX-MML-AM_HTMLorMML'
+      script src='#{mathjaxdir}/MathJax.js?config=TeX-MML-AM_HTMLorMML'
 
     - syntax_hl = self.syntax_highlighter
     - if syntax_hl && (syntax_hl.docinfo? :head)
       =syntax_hl.docinfo :head, self, cdn_base_url: cdn_base, linkcss: linkcss, self_closing_tag_slash: '/'
-    / If the query includes 'print-pdf', use the PDF print sheet
+
+    /! Printing and PDF exports
     javascript:
       var link = document.createElement( 'link' );
       link.rel = 'stylesheet';
       link.type = 'text/css';
       link.href = window.location.search.match( /print-pdf/gi ) ? "#{revealjsdir}/css/print/pdf.css" : "#{revealjsdir}/css/print/paper.css";
       document.getElementsByTagName( 'head' )[0].appendChild( link );
-    /[if lt IE 9]
-      <script src="#{revealjsdir}/lib/js/html5shiv.js"></script>
-    - unless (docinfo_content = docinfo :header, '.html').empty?
-      =docinfo_content
+
     - if attr? :customcss
       link rel='stylesheet' href=((customcss = attr :customcss).empty? ? 'asciidoctor-revealjs.css' : customcss)
+    - unless (_docinfo = docinfo :head, '-revealjs.html').empty?
+      =_docinfo
   body
     .reveal
       / Any section element inside of this container is displayed as a slide
       .slides
-        - unless notitle || !has_header?
-          - bg_image = (attr? 'title-slide-background-image') ? (image_uri(attr 'title-slide-background-image')) : nil
-          - bg_video = (attr? 'title-slide-background-video') ? (media_uri(attr 'title-slide-background-video')) : nil
-          section.title(class = role
-            data-state='title'
-            data-transition=(attr 'title-slide-transition')
-            data-transition-speed=(attr 'title-slide-transition-speed')
-            data-background=(attr 'title-slide-background')
-            data-background-size=(attr 'title-slide-background-size')
-            data-background-image=bg_image
-            data-background-video=bg_video
-            data-background-video-loop=(attr 'title-slide-background-video-loop')
-            data-background-video-muted=(attr 'title-slide-background-video-muted')
-            data-background-opacity=(attr "background-opacity")
-            data-background-iframe=(attr 'title-slide-background-iframe')
-            data-background-color=(attr 'title-slide-background-color')
-            data-background-repeat=(attr 'title-slide-background-repeat')
-            data-background-position=(attr 'title-slide-background-position')
-            data-background-transition=(attr 'title-slide-background-transition'))
-            - if (_title_obj = doctitle partition: true, use_fallback: true).subtitle?
-              h1=slice_text _title_obj.title, (_slice = header.option? :slice)
-              h2=slice_text _title_obj.subtitle, _slice
-            - else
-              h1=@header.title
-            - preamble = @document.find_by context: :preamble
-            - unless preamble.nil? or preamble.length == 0
-              div.preamble=preamble.pop.content
-            - unless author.nil?
-              p.author: small=author
-        =content
-    script src="#{revealjsdir}/lib/js/head.min.js"
+        - unless noheader
+          - unless (_docinfo = docinfo :header, '-revealjs.html').empty?
+            = _docinfo
+          - if header?
+            include title_slide.html.slim
+        = content
+        - unless (_docinfo = docinfo :footer, '-revealjs.html').empty?
+          = _docinfo
     script src="#{revealjsdir}/js/reveal.js"
+    / Supports easy AsciiDoc syntax for background color
     javascript:
       Array.prototype.slice.call(document.querySelectorAll('.slides section')).forEach(function(slide) {
         if (slide.getAttribute('data-background-color')) return;
@@ -111,9 +97,11 @@ html lang=(attr :lang, 'en' unless attr? :nolang)
           slide.setAttribute('data-background-color', bgColor);
           slide.style.backgroundColor = 'transparent';
         }
-      })
+      });
 
-      // See https://github.com/hakimel/reveal.js#configuration for a full list of configuration options
+      // More info about config & dependencies:
+      // - https://github.com/hakimel/reveal.js#configuration
+      // - https://github.com/hakimel/reveal.js#dependencies
       Reveal.initialize({
         // Display presentation control arrows
         controls: #{to_boolean(attr 'revealjs_controls', true)},
@@ -131,12 +119,17 @@ html lang=(attr :lang, 'en' unless attr? :nolang)
         slideNumber: #{to_valid_slidenumber(attr 'revealjs_slidenumber', false)},
         // Control which views the slide number displays on
         showSlideNumber: '#{attr 'revealjs_showslidenumber', 'all'}',
-        // Push each slide change to the browser history
+        // Add the current slide number to the URL hash so that reloading the
+        // page/copying the URL will return you to the same slide
+        hash: #{to_boolean(attr 'revealjs_hash', false)},
+        // Push each slide change to the browser history. Implies `hash: true`
         history: #{to_boolean(attr 'revealjs_history', false)},
         // Enable keyboard shortcuts for navigation
         keyboard: #{to_boolean(attr 'revealjs_keyboard', true)},
         // Enable the slide overview mode
         overview: #{to_boolean(attr 'revealjs_overview', true)},
+        // Disables the default reveal.js slide layout so that you can use custom CSS layout
+        disableLayout: #{to_boolean(attr 'revealjs_disablelayout', false)},
         // Vertical centering of slides
         center: #{to_boolean(attr 'revealjs_center', true)},
         // Enables touch navigation on devices with touch input
@@ -145,6 +138,8 @@ html lang=(attr :lang, 'en' unless attr? :nolang)
         loop: #{to_boolean(attr 'revealjs_loop', false)},
         // Change the presentation direction to be RTL
         rtl: #{to_boolean(attr 'revealjs_rtl', false)},
+        // See https://github.com/hakimel/reveal.js/#navigation-mode
+        navigationMode: '#{attr 'revealjs_navigationmode', 'default'}',
         // Randomizes the order of slides each time the presentation loads
         shuffle: #{to_boolean(attr 'revealjs_shuffle', false)},
         // Turns fragments on and off globally
@@ -165,6 +160,12 @@ html lang=(attr :lang, 'en' unless attr? :nolang)
         // - true: All media will autoplay, regardless of individual setting
         // - false: No media will autoplay, regardless of individual setting
         autoPlayMedia: #{attr 'revealjs_autoplaymedia', 'null'},
+        // Global override for preloading lazy-loaded iframes
+        // - null: Iframes with data-src AND data-preload will be loaded when within
+        //   the viewDistance, iframes with only data-src will be loaded when visible
+        // - true: All iframes with data-src will be loaded when within the viewDistance
+        // - false: All iframes with data-src will be loaded only when visible
+        preloadIframes: #{attr 'revealjs_preloadiframes', 'null'},
         // Number of milliseconds between automatically proceeding to the
         // next slide, disabled when set to 0, this value can be overwritten
         // by using a data-autoslide attribute on your slides
@@ -177,8 +178,23 @@ html lang=(attr :lang, 'en' unless attr? :nolang)
         // presenting each slide. This is used to show a pacing timer in the
         // speaker view
         defaultTiming: #{attr 'revealjs_defaulttiming', 120},
+        // Specify the total time in seconds that is available to
+        // present.  If this is set to a nonzero value, the pacing
+        // timer will work out the time available for each slide,
+        // instead of using the defaultTiming value
+        totalTime: #{attr 'revealjs_totaltime', 0},
+        // Specify the minimum amount of time you want to allot to
+        // each slide, if using the totalTime calculation method.  If
+        // the automated time allocation causes slide pacing to fall
+        // below this threshold, then you will see an alert in the
+        // speaker notes window
+        minimumTimePerSlide: #{attr 'revealjs_minimumtimeperslide', 0},
         // Enable slide navigation via mouse wheel
         mouseWheel: #{to_boolean(attr 'revealjs_mousewheel', false)},
+        // Hide cursor if inactive
+        hideInactiveCursor: #{to_boolean(attr 'revealjs_hideinactivecursor', true)},
+        // Time before the cursor is hidden (in ms)
+        hideCursorTime: #{attr 'revealjs_hidecursortime', 5000},
         // Hides the address bar on mobile devices
         hideAddressBar: #{to_boolean(attr 'revealjs_hideaddressbar', true)},
         // Opens links in an iframe preview overlay
@@ -193,6 +209,10 @@ html lang=(attr :lang, 'en' unless attr? :nolang)
         backgroundTransition: '#{attr 'revealjs_backgroundtransition', 'fade'}',
         // Number of slides away from the current that are visible
         viewDistance: #{attr 'revealjs_viewdistance', 3},
+        // Number of slides away from the current that are visible on mobile
+        // devices. It is advisable to set this to a lower number than
+        // viewDistance in order to save resources.
+        mobileViewDistance: #{attr 'revealjs_mobileviewdistance', 3},
         // Parallax background image (e.g., "'https://s3.amazonaws.com/hakim-static/reveal-js/reveal-parallax-1.jpg'")
         parallaxBackgroundImage: '#{attr 'revealjs_parallaxbackgroundimage', ''}',
         // Parallax background size in CSS syntax (e.g., "2100px 900px")
@@ -226,19 +246,16 @@ html lang=(attr :lang, 'en' unless attr? :nolang)
 
         // Optional libraries used to extend on reveal.js
         dependencies: [
-            { src: '#{revealjsdir}/lib/js/classList.js', condition: function() { return !document.body.classList; } },
-            #{(document.attr? 'source-highlighter', 'highlightjs') ? "{ src: '#{revealjsdir}/plugin/highlight/highlight.js', async: true, callback: function() { hljs.initHighlightingOnLoad(); } }," : nil}
-            #{(attr? 'revealjs_plugin_zoom', 'disabled') ? "" :  "{ src: '#{revealjsdir}/plugin/zoom-js/zoom.js', async: true }," }
-            #{(attr? 'revealjs_plugin_notes', 'disabled') ? "" :  "{ src: '#{revealjsdir}/plugin/notes/notes.js', async: true }," }
-            #{(attr? 'revealjs_plugin_marked', 'enabled') ? "{ src: '#{revealjsdir}/plugin/markdown/marked.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } }," : "" }
-            #{(attr? 'revealjs_plugin_markdown', 'enabled') ? "{ src: '#{revealjsdir}/plugin/markdown/markdown.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } }," : "" }
-            #{(attr? 'revealjs_plugin_pdf', 'enabled') ? "{ src: '#{revealjsdir}/plugin/print-pdf/print-pdf.js', async: true }," :  "" }
-            #{(attr? 'revealjs_plugins') ? File.read(attr('revealjs_plugins', '')) : ""}
+            #{revealjs_dependencies(document, self, revealjsdir)}
         ],
 
         #{(attr? 'revealjs_plugins_configuration') ? File.read(attr('revealjs_plugins_configuration', '')) : ""}
 
       });
+    / Workaround the "Only direct descendants of a slide section can be stretched" limitation in reveal.js
+    / https://github.com/hakimel/reveal.js/issues/2584
+    include stretch_nested_elements.js.slim
+
     - if syntax_hl && (syntax_hl.docinfo? :footer)
       =syntax_hl.docinfo :footer, self, cdn_base_url: cdn_base, linkcss: linkcss, self_closing_tag_slash: '/'
 

data/templates/example.html.slim

@@ -1,4 +1,4 @@
-.exampleblock id=@id class=role
+= html_tag('div', { :id => @id, :class => ['exampleblock', role, ('fragment' if (option? :step) || (attr? 'step'))] }.merge(data_attrs(@attributes)))
   - if title?
     .title=captioned_title
   .content=content

data/templates/helpers.rb

@@ -24,6 +24,23 @@ module Slim::Helpers
     val && val != 'false' && val.to_s != '0' || false
   end
 
+  # bool_data_attr
+  # If the AsciiDoc attribute doesn't exist, no HTML attribute is added
+  # If the AsciiDoc attribute exist and is a true value, HTML attribute is enabled (bool)
+  # If the AsciiDoc attribute exist and is a false value, HTML attribute is a false string
+  # Ex: a feature is enabled globally but can be disabled using a data- attribute on individual items
+  # :revealjs_previewlinks: True
+  # then link::example.com[Link text, preview=false]
+  # Here the template must have data-preview-link="false" not just no data-preview-link attribute
+  def bool_data_attr val
+    return false unless attr?(val)
+    if attr(val).downcase == 'false' || attr(val) == '0'
+      'false'
+    else
+      true
+    end
+  end
+
   # false needs to be verbatim everything else is a string.
   # Calling side isn't responsible for quoting so we are doing it here
   def to_valid_slidenumber val
@@ -55,25 +72,52 @@ module Slim::Helpers
   # @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?
+      next attrs unless v && (v == true || !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(' ')
 
-
     if VOID_ELEMENTS.include? name.to_s
       %(<#{name}#{attrs_str}>)
     else
-      content ||= yield if block_given?
+      content ||= (yield if block_given?)
       %(<#{name}#{attrs_str}>#{content}</#{name}>)
     end
   end
 
 
+  #
+  # Extracts data- attributes from the attributes.
+  # @param attributes [Hash] (default: {})
+  # @return [Hash] a Hash that contains only data- attributes
+  #
+  def data_attrs(attributes)
+    # key can be an Integer (for positional attributes)
+    attributes.map { |key, value| (key == 'step') ? ['data-fragment-index', value] : [key, value] }
+              .to_h
+              .select { |key, _| key.to_s.start_with?('data-') }
+  end
+
+
+  #
+  # Wrap an inline text in a <span> element if the node contains a role, an id or data- attributes.
+  # @param content [#to_s] the content; +nil+ to call the block. (default: nil).
+  # @return [String] the content or the content wrapped in a <span> element as string
+  #
+  def inline_text_container(content = nil)
+    data_attrs = data_attrs(@attributes)
+    classes = [role, ('fragment' if (option? :step) || (attr? 'step') || (roles.include? 'step'))].compact
+    if !roles.empty? || !data_attrs.empty? || !@id.nil?
+      html_tag('span', { :id => @id, :class => classes }.merge(data_attrs), (content || (yield if block_given?)))
+    else
+      content || (yield if block_given?)
+    end
+  end
+
+
   ##
   # Returns corrected section level.
   #
@@ -84,6 +128,52 @@ module Slim::Helpers
     @_section_level ||= (sec.level == 0 && sec.special) ? 1 : sec.level
   end
 
+  ##
+  # Display footnotes per slide
+  #
+  @@slide_footnotes = {}
+  @@section_footnotes = {}
+
+  def slide_footnote(footnote)
+    footnote_parent = footnote.parent
+    # footnotes declared on the section title are processed during the parsing/substitution.
+    # as a result, we need to store them to display them on the right slide/section
+    if footnote_parent.instance_of?(::Asciidoctor::Section)
+      footnote_parent_object_id = footnote_parent.object_id
+      section_footnotes = (@@section_footnotes[footnote_parent_object_id] || [])
+      footnote_index = section_footnotes.length + 1
+      attributes = footnote.attributes.merge({ 'index' => footnote_index })
+      inline_footnote = Asciidoctor::Inline.new(footnote_parent, footnote.context, footnote.text, :attributes => attributes)
+      section_footnotes << Asciidoctor::Document::Footnote.new(inline_footnote.attr(:index), inline_footnote.id, inline_footnote.text)
+      @@section_footnotes[footnote_parent_object_id] = section_footnotes
+      inline_footnote
+    else
+      parent = footnote.parent
+      until parent == nil || parent.instance_of?(::Asciidoctor::Section)
+        parent = parent.parent
+      end
+      # check if there is any footnote attached on the section title
+      section_footnotes = parent != nil ? @@section_footnotes[parent.object_id] || [] : []
+      initial_index = footnote.attr(:index)
+      # reset the footnote numbering to 1 on each slide
+      # make sure that if a footnote is used more than once it will use the same index/number
+      slide_index = (existing_footnote = @@slide_footnotes[initial_index]) ? existing_footnote.index : @@slide_footnotes.length + section_footnotes.length + 1
+      attributes = footnote.attributes.merge({ 'index' => slide_index })
+      inline_footnote = Asciidoctor::Inline.new(footnote_parent, footnote.context, footnote.text, :attributes => attributes)
+      @@slide_footnotes[initial_index] = Asciidoctor::Document::Footnote.new(inline_footnote.attr(:index), inline_footnote.id, inline_footnote.text)
+      inline_footnote
+    end
+  end
+
+  def clear_slide_footnotes
+    @@slide_footnotes = {}
+  end
+
+  def slide_footnotes(section)
+    section_object_id = section.object_id
+    section_footnotes = @@section_footnotes[section_object_id] || []
+    section_footnotes + @@slide_footnotes.values
+  end
 
   ##
   # Returns the captioned section's title, optionally numbered.
@@ -101,6 +191,20 @@ module Slim::Helpers
     end
   end
 
+  def revealjs_dependencies(document, node, revealjsdir)
+    dependencies = []
+    dependencies << "{ src: '#{revealjsdir}/plugin/zoom-js/zoom.js', async: true }" unless (node.attr? 'revealjs_plugin_zoom', 'disabled')
+    dependencies << "{ src: '#{revealjsdir}/plugin/notes/notes.js', async: true }" unless (node.attr? 'revealjs_plugin_notes', 'disabled')
+    dependencies << "{ src: '#{revealjsdir}/plugin/markdown/marked.js', async: true }" if (node.attr? 'revealjs_plugin_marked', 'enabled')
+    dependencies << "{ src: '#{revealjsdir}/plugin/markdown/markdown.js', async: true }" if (node.attr? 'revealjs_plugin_markdown', 'enabled')
+    if (node.attr? 'revealjs_plugins') &&
+        !(revealjs_plugins_file = (node.attr 'revealjs_plugins', '').strip).empty? &&
+        !(revealjs_plugins_content = (File.read revealjs_plugins_file).strip).empty?
+      dependencies << revealjs_plugins_content
+    end
+    dependencies.join(",\n      ")
+  end
+
 
   # Between delimiters (--) is code taken from asciidoctor-bespoke 1.0.0.alpha.1
   # Licensed under MIT, Copyright (C) 2015-2016 Dan Allen and the Asciidoctor Project
@@ -113,8 +217,69 @@ module Slim::Helpers
   def resolve_content
     @content_model == :simple ? %(<p>#{content}</p>) : content
   end
-  #--
 
+  # Capture nested template content and register it with the specified key, to
+  # be executed at a later time.
+  #
+  # This method must be invoked using the control code directive (i.e., -). By
+  # using a control code directive, the block is set up to append the result
+  # directly to the output buffer. (Integrations often hide the distinction
+  # between a control code directive and an output directive in this context).
+  #
+  # key   - The Symbol under which to save the template block.
+  # opts  - A Hash of options to control processing (default: {}):
+  #         * :append  - A Boolean that indicates whether to append this block
+  #                      to others registered with this key (default: false).
+  #         * :content - String content to be used if template content is not
+  #                      provided (optional).
+  # block - The template content (in Slim template syntax).
+  #
+  # Examples
+  #
+  #   - content_for :body
+  #     p content
+  #   - content_for :body, append: true
+  #     p more content
+  #
+  # Returns nothing.
+  def content_for key, opts = {}, &block
+    @content = {} unless defined? @content
+    (opts[:append] ? (@content[key] ||= []) : (@content[key] = [])) << (block_given? ? block : lambda { opts[:content] })
+    nil
+  end
+
+  # Checks whether deferred template content has been registered for the specified key.
+  #
+  # key - The Symbol under which to look for saved template blocks.
+  #
+  # Returns a Boolean indicating whether content has been registered for this key.
+  def content_for? key
+    (defined? @content) && (@content.key? key)
+  end
+
+  # Evaluates the deferred template content registered with the specified key.
+  #
+  # When the corresponding content_for method is invoked using a control code
+  # directive, the block is set up to append the result to the output buffer
+  # directly.
+  #
+  # key  - The Symbol under which to look for template blocks to yield.
+  # opts - A Hash of options to control processing (default: {}):
+  #        * :drain - A Boolean indicating whether to drain the key of blocks
+  #                   after calling them (default: true).
+  #
+  # Examples
+  #
+  #   - yield_content :body
+  #
+  # Returns nothing (assuming the content has been captured in the context of control code).
+  def yield_content key, opts = {}
+    if (defined? @content) && (blks = (opts.fetch :drain, true) ? (@content.delete key) : @content[key])
+      blks.map {|b| b.call }.join
+    end
+    nil
+  end
+  #--
 end
 
 # More custom functions can be added in another namespace if required