Public: Methods for managing blocks of Asciidoc content in a section.
Examples
block = Asciidoctor::Block.new(document, :paragraph, ["`This` is a <test>"]) block.content => ["<em>This</em> is a <test>"]
Public: Get/Set the original Array content for this section block.
Public: Initialize an Asciidoctor::Block object.
parent - The parent Asciidoc Object. context - The Symbol context name for the type of content. buffer - The Array buffer of source data (default: nil).
# File lib/asciidoctor/block.rb, line 23 def initialize(parent, context, buffer = nil) super(parent, context) @buffer = buffer end
Public: Get an HTML-ified version of the source buffer, with special Asciidoc characters and entities converted to their HTML equivalents.
Examples
doc = Asciidoctor::Document.new block = Asciidoctor::Block.new(doc, :paragraph, ['`This` is what happens when you <meet> a stranger in the <alps>!']) block.content => ["<em>This</em> is what happens when you <meet> a stranger in the <alps>!"]
# File lib/asciidoctor/block.rb, line 49 def content case @context when :preamble @blocks.map {|b| b.render }.join # lists get iterated in the template (for now) # list items recurse into this block when their text and content methods are called when :ulist, :olist, :dlist, :colist @buffer when :listing, :literal apply_literal_subs(@buffer) when :pass apply_passthrough_subs(@buffer) when :admonition, :example, :sidebar, :quote, :verse, :open if !@buffer.nil? apply_para_subs(@buffer) else @blocks.map {|b| b.render }.join end else apply_para_subs(@buffer) end end
Public: Get the rendered String content for this Block. If the block has child blocks, the content method should cause them to be rendered and returned as content that can be included in the parent block's template.
# File lib/asciidoctor/block.rb, line 32 def render @document.playback_attributes @attributes out = renderer.render("block_#{@context}", self) @document.callouts.next_list if @context == :colist out end
# File lib/asciidoctor/block.rb, line 72 def to_s "#{super.to_s} - #@context [blocks:#{(@blocks || []).size}]" end