asciidoctor 0.0.1

data/lib/asciidoctor/errors.rb

@@ -0,0 +1,5 @@
+# Base project exception
+module Asciidoctor
+  class ProjectError < StandardError; end
+end
+

data/lib/asciidoctor/list_item.rb

@@ -0,0 +1,19 @@
+# Public: Methods for managing items for Asciidoc olists, ulist, and dlists.
+class Asciidoctor::ListItem
+  # Public: Get the Array of Blocks from the list item's continuation.
+  attr_reader :blocks
+
+  # Public: Get/Set the String content.
+  attr_accessor :content
+
+  # Public: Get/Set the String list item anchor name.
+  attr_accessor :anchor
+
+  # Public: Initialize an Asciidoctor::ListItem object.
+  #
+  # content - the String content (default '')
+  def initialize(content='')
+    @content = content
+    @blocks  = []
+  end
+end

data/lib/asciidoctor/render_templates.rb

@@ -0,0 +1,219 @@
+class BaseTemplate
+  def initialize
+  end
+
+  def self.inherited(klass)
+    @template_classes ||= []
+    @template_classes << klass
+  end
+
+  def self.template_classes
+    @template_classes
+  end
+
+  # We're ignoring locals for now. Shut up.
+  def render(obj = Object.new, locals = {})
+    output = template.result(obj.instance_eval {binding})
+  end
+
+  def template
+    raise "You chilluns need to make your own template"
+  end
+end
+
+class DocumentTemplate < BaseTemplate
+  def template
+    @template ||= ::ERB.new <<-EOF
+      <div class='man-page'>
+      <div id='header'>
+        <% if header %>
+          <h1><%= header.name %></h1>
+          <div class='sectionbody'><%= header.content %></div>
+        <% elsif preamble %>
+          <div class=preamble'>
+            <div class='sectionbody'>
+              <%= preamble.content %>
+            </div>
+          </div>
+        <% end %>
+      </div>
+
+      <%= content %>
+
+    </div>
+    EOF
+  end
+end
+
+class SectionTemplate < BaseTemplate
+  def template
+    @template ||= ERB.new <<-EOF
+      <div class='sect<%= level %>'>
+        <% if !anchor.nil? %>
+          <a name='<%= anchor %>'></a>
+        <% end %>
+        <h<%= level + 1 %> id='<%= section_id %>'><%= name %></h<%= level + 1 %>>
+        <% if level == 1 %>
+          <div class='sectionbody'><%= content %></div>
+        <% else %>
+          <%= content %>
+        <% end %>
+      </div>
+    EOF
+  end
+end
+
+class SectionAnchorTemplate < BaseTemplate
+  def template
+    @template ||= ERB.new <<-EOF
+      <a name='<%= content %>'></a>
+    EOF
+  end
+end
+
+class SectionDlistTemplate < BaseTemplate
+  def template
+    @template ||= ERB.new <<-EOF
+      <div class='dlist'>
+        <dl>
+          <% content.each do |dt, dd| %>
+            <dt class='hdlist1'><%= dt %></dt>
+            <% unless dd.nil? || dd.empty? %>
+              <dd><%= dd %></dd>
+            <% end %>
+          <% end %>
+        </dl>
+      </div>
+    EOF
+  end
+end
+
+class SectionListingTemplate < BaseTemplate
+  def template
+    @template ||= ERB.new <<-EOF
+      <div class='listingblock'>
+        <div class='content'>
+          <div class='highlight'>
+            <pre><%= content %></pre>
+          </div>
+        </div>
+      </div>
+    EOF
+  end
+end
+
+class SectionLiteralTemplate < BaseTemplate
+  def template
+    @template ||= ERB.new <<-EOF
+      <div class='literalblock'>
+        <div class='content'>
+          <pre><tt><%= content %></tt></pre>
+        </div>
+      </div>
+    EOF
+  end
+end
+
+class SectionNoteTemplate < BaseTemplate
+  def template
+    @template ||= ERB.new <<-EOF
+      <div class='admonitionblock'>
+        <table>
+          <tr>
+            <td class='icon'></td>
+            <td class='content'>
+              <% if !title.nil? %>
+                <div class='title'><%= title %></div>
+              <% end %>
+              <%= content %>
+            </td>
+          </tr>
+        </table>
+      </div>
+    EOF
+  end
+end
+
+class SectionParagraphTemplate < BaseTemplate
+  def template
+    @template ||= ERB.new <<-EOF
+      <div class='paragraph'>
+        <% if !title.nil? %>
+          <div class='title'><%= title %></div>
+        <% end %>
+        <p><%= content %></p>
+      </div>
+    EOF
+  end
+end
+
+class SectionSidebarTemplate < BaseTemplate
+  def template
+    @template ||= ERB.new <<-EOF
+      <div class='sidebarblock'>
+        <div class='content'>
+          <p><%= content %></p>
+        </div>
+      </div>
+    EOF
+  end
+end
+
+class SectionUlistTemplate < BaseTemplate
+  def template
+    @template ||= ERB.new <<-EOF
+      <div class='ulist'>
+        <ul>
+          <% content.each do |li| %>
+            <li><p><%= li %></p></li>
+          <% end %>
+        </ul>
+      </div>
+    EOF
+  end
+end
+
+=begin
+../gitscm-next/templates/section_colist.html.erb
+<div class='colist arabic'>
+  <ol>
+    <% content.each do |li| %>
+      <li><p><%= li %></p></li>
+    <% end %>
+  </ol>
+</div>
+../gitscm-next/templates/section_example.html.erb
+<div class='exampleblock'>
+  <div class='content'>
+    <div class='literalblock'>
+      <div class='content'>
+        <pre><tt><%= content %></tt></pre>
+      </div>
+    </div>
+  </div>
+</div>
+../gitscm-next/templates/section_oblock.html.erb
+<div class='openblock'>
+  <div class='content'>
+    <%= content %>
+  </div>
+</div>
+../gitscm-next/templates/section_olist.html.erb
+<div class='olist arabic'>
+  <ol class='arabic'>
+    <% content.each do |li| %>
+      <li><p><%= li %></p></li>
+    <% end %>
+  </ol>
+</div>
+../gitscm-next/templates/section_quote.html.erb
+<div class='quoteblock'>
+  <div class='content'>
+    <%= content %>
+  </div>
+</div>
+../gitscm-next/templates/section_verse.html.erb
+<div class='verseblock'>
+  <pre class='content'><%= content %></pre>
+</div>
+=end

data/lib/asciidoctor/renderer.rb

@@ -0,0 +1,62 @@
+# Public: Methods for rendering Asciidoc Documents, Sections, and Blocks
+# using erb templates.
+class Asciidoctor::Renderer
+  # Public: Initialize an Asciidoctor::Renderer object.
+  #
+  def initialize(options={})
+    @debug = !!options[:debug]
+
+    @views = {}
+
+    # Load up all the template classes that we know how to render
+    BaseTemplate.template_classes.each do |tc|
+      view = tc.to_s.underscore.gsub(/_template$/, '')
+      @views[view] = tc.new
+    end
+
+    @render_stack = []
+  end
+
+  # Public: Render an Asciidoc object with a specified view template.
+  #
+  # view   - the String view template name.
+  # object - the Object to be used as an evaluation scope.
+  # locals - the optional Hash of locals to be passed to Tilt (default {}) (also ignored, really)
+  def render(view, object, locals = {})
+    @render_stack.push([view, object])
+    if @views[view].nil?
+      raise "Couldn't find a view in @views for #{view}"
+    else
+      Asciidoctor.debug "View for #{view} is #{@views[view]}, object is #{object}"
+    end
+    ret = @views[view].render(object, locals)
+
+    if @debug
+      prefix = ''
+      STDERR.puts '=' * 80
+      STDERR.puts "Rendering:"
+      @render_stack.each do |stack_view, stack_obj|
+        obj_info = case stack_obj
+                   when Section; "SECTION #{stack_obj.name}"
+                   when Block;
+                     if stack_obj.context == :dlist
+                       dt_list = stack_obj.buffer.map{|dt,dd| dt.content.strip}.join(', ')
+                       "BLOCK :dlist (#{dt_list})"
+                     else
+                       "BLOCK #{stack_obj.context.inspect}"
+                     end
+                   else stack_obj.class
+                   end
+        STDERR.puts "#{prefix}#{stack_view}: #{obj_info}"
+        prefix << '  '
+      end
+      STDERR.puts '-' * 80
+      STDERR.puts ret.inspect
+      STDERR.puts '=' * 80
+      STDERR.puts
+    end
+
+    @render_stack.pop
+    ret
+  end
+end

data/lib/asciidoctor/section.rb

@@ -0,0 +1,224 @@
+# Public: Methods for managing sections of Asciidoc content in a document.
+# The section responds as an Array of content blocks by delegating
+# block-related methods to its @blocks Array.
+#
+# Examples
+#
+#   section = Asciidoctor::Section.new
+#   section.name = 'DESCRIPTION'
+#   section.anchor = 'DESCRIPTION'
+#
+#   section.size
+#   => 0
+#
+#   section.section_id
+#   => "_description"
+#
+#   section << new_block
+#   section.size
+#   => 1
+class Asciidoctor::Section
+  # Public: Get/Set the Integer section level.
+  attr_accessor :level
+
+  # Public: Set the String section name.
+  attr_writer :name
+
+  # Public: Get/Set the String section title.
+  attr_accessor :title
+
+  # Public: Get/Set the String section caption.
+  attr_accessor :caption
+
+  # Public: Get/Set the String section anchor name.
+  attr_accessor :anchor
+
+  # Public: Get the Array of section blocks.
+  attr_reader :blocks
+
+  # Public: Initialize an Asciidoctor::Section object.
+  #
+  # parent - The parent Asciidoc Object.
+  def initialize(parent)
+    @parent = parent
+    @blocks = []
+  end
+
+  # Public: Get the String section name with intrinsics converted
+  #
+  # Examples
+  #
+  #   section.name = "git-web{litdd}browse(1) Manual Page"
+  #   section.name
+  #   => "git-web--browse(1) Manual Page"
+  #
+  # Returns the String section name
+  def name
+    @name && 
+    @name.gsub(/(^|[^\\])\{(\w[\w\-]+\w)\}/) { $1 + Asciidocs::INTRINSICS[$2] }.
+          gsub( /`([^`]+)`/, '<tt>\1</tt>' )
+  end
+
+  # Public: Get the String section id
+  #
+  # Examples
+  #
+  #   section = Section.new
+  #   section.name = "Foo"
+  #   section.section_id
+  #   => "_foo"
+  def section_id
+    "_#{name && name.downcase.gsub(' ','_')}"
+  end
+
+  # Public: Get the Asciidoctor::Document instance to which this Block belongs
+  def document
+    @parent.is_a?(Asciidoctor::Document) ? @parent : @parent.document
+  end
+
+  # Public: Get the Asciidoctor::Renderer instance being used for the ancestor
+  # Asciidoctor::Document instance.
+  def renderer
+    Asciidoctor.debug "Section#renderer:  Looking for my renderer up in #{@parent}"
+    @parent.renderer
+  end
+
+  # Public: Get the rendered String content for this Section and all its child
+  # Blocks.
+  def render
+    Asciidoctor.debug "Now rendering section for #{self}"
+    renderer.render('section', self)
+  end
+
+  # Public: Get the String section content by aggregating rendered section blocks.
+  #
+  # Examples
+  #
+  #   section = Section.new
+  #   section << 'foo'
+  #   section << 'bar'
+  #   section << 'baz'
+  #   section.content
+  #   "<div class=\"paragraph\"><p>foo</p></div>\n<div class=\"paragraph\"><p>bar</p></div>\n<div class=\"paragraph\"><p>baz</p></div>"
+  def content
+    @blocks.map do |block|
+      Asciidoctor.debug "Begin rendering block #{block.is_a?(Asciidoctor::Section) ? block.name : 'n/a'} #{block} (context: #{block.is_a?(Asciidoctor::Block) ? block.context : 'n/a' })"
+      poo = block.render
+      Asciidoctor.debug "===> Done rendering block #{block.is_a?(Asciidoctor::Section) ? block.name : 'n/a'} #{block} (context: #{block.is_a?(Asciidoctor::Block) ? block.context : 'n/a' })"
+      poo
+    end.join
+  end
+
+  # Public: Get the Integer number of blocks in the section.
+  #
+  # Examples
+  #
+  #   section = Section.new
+  #
+  #   section.size
+  #   => 0
+  #
+  #   section << 'foo'
+  #   section << 'bar'
+  #   section.size
+  #   => 2
+  def size
+    @blocks.size
+  end
+
+  # Public: Get the element at i in the array of section blocks.
+  #
+  # i - The Integer array index number.
+  #
+  #   section = Section.new
+  #
+  #   section << 'foo'
+  #   section << 'bar'
+  #   section[1]
+  #   => "bar"
+  def [](i)
+    @blocks[i]
+  end
+
+  # Public: Delete the element at i in the array of section blocks,
+  # returning that element or nil if i is out of range.
+  #
+  # i - The Integer array index number.
+  #
+  #   section = Section.new
+  #
+  #   section << 'foo'
+  #   section << 'bar'
+  #   section.delete_at(1)
+  #   => "bar"
+  #
+  #   section.blocks
+  #   => ["foo"]
+  def delete_at(i)
+    @blocks.delete_at(i)
+  end
+
+  # Public: Append a content block to this section's list of blocks.
+  #
+  # block - The new section block.
+  #
+  #   section = Section.new
+  #
+  #   section << 'foo'
+  #   section << 'bar'
+  #   section.blocks
+  #   => ["foo", "bar"]
+  def <<(block)
+    @blocks << block
+  end
+
+  # Public: Clear this Section's list of blocks.
+  #
+  #   section = Section.new
+  #
+  #   section << 'foo'
+  #   section << 'bar'
+  #   section.blocks
+  #   => ["foo", "bar"]
+  #   section.clear_blocks
+  #   section.blocks
+  #   => []
+  def clear_blocks
+    @blocks = []
+  end
+
+  # Public: Insert a content block at the specified index in this section's
+  # list of blocks.
+  #
+  # i - The Integer array index number.
+  # val = The content block to insert.
+  #
+  #   section = Section.new
+  #
+  #   section << 'foo'
+  #   section << 'baz'
+  #   section.insert(1, 'bar')
+  #   section.blocks
+  #   ["foo", "bar", "baz"]
+  def insert(i, block)
+    @blocks.insert(i, block)
+  end
+
+  # Public: Get the Integer index number of the first content block element
+  # for which the provided block returns true.  Returns nil if no match is
+  # found.
+  #
+  # block - A block that can be used to determine whether a supplied element
+  #         is a match.
+  #
+  #   section = Section.new
+  #
+  #   section << 'foo'
+  #   section << 'bar'
+  #   section << 'baz'
+  #   section.index{|el| el =~ /^ba/}
+  #   => 1
+  def index(&block)
+    @blocks.index(&block)
+  end
+end