asciidoctor 0.1.0 → 0.1.1

data/lib/asciidoctor/version.rb

@@ -1,3 +1,3 @@
 module Asciidoctor
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/man/asciidoctor.1

@@ -2,12 +2,12 @@
 .\"     Title: asciidoctor
 .\"    Author: [see the "AUTHORS" section]
 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
-.\"      Date: 01/30/2013
+.\"      Date: 02/18/2013
 .\"    Manual: \ \&
 .\"    Source: \ \&
 .\"  Language: English
 .\"
-.TH "ASCIIDOCTOR" "1" "01/30/2013" "\ \&" "\ \&"
+.TH "ASCIIDOCTOR" "1" "02/18/2013" "\ \&" "\ \&"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -47,19 +47,22 @@ Base directory containing the document and resources\&. Defaults to the director
 .PP
 \fB\-S, \-\-safe\-mode\fR=\fISAFE_MODE\fR
 .RS 4
-Set safe mode level explicity:
+Set safe mode level:
 \fIunsafe\fR,
 \fIsafe\fR,
-\fIsecure\fR\&. Defaults to
-\fIsecure\fR\&. Disables potentially dangerous macros in source files, such as include::[]\&.
+\fIserver\fR
+or
+\fIsecure\fR\&. Disables potentially dangerous macros in source files, such as include::[]\&. If not set, the safe mode level defaults to
+\fIunsafe\fR
+when Asciidoctor is invoked using this script\&.
 .RE
 .PP
 \fB\-\-safe\fR
 .RS 4
-Set safe mode to
-\fIsafe\fR
-from the default safe mode of
-\fIsecure\fR\&. Enables include macros, but restricts access to ancestor paths of source file\&. Provided for compatibility with the asciidoc command\&.
+Set safe mode level to
+\fIsafe\fR\&. Enables include macros, but restricts access to ancestor paths of source file\&. Provided for compatibility with the asciidoc command\&. If not set, the safe mode level defaults to
+\fIunsafe\fR
+when Asciidoctor is invoked using this script\&.
 .RE
 .SS "Document Settings"
 .PP
@@ -161,7 +164,7 @@ Suppress the document header and footer in the output\&.
 .PP
 \fB\-T, \-\-template\-dir\fR=\fIDIR\fR
 .RS 4
-Directory containing custom render templates that override one or more templates from the the built\-in set\&.
+Directory containing custom render templates that override one or more templates from the the built\-in set\&. If there is a folder in the directory that matches the backend, the templates from that folder will be used\&.
 .RE
 .SS "Processing Information"
 .PP
@@ -198,15 +201,21 @@ Failure (syntax or usage error; configuration error; document processing failure
 .RE
 .SH "BUGS"
 .sp
-See the \fBAsciidoctor\fR issue tracker: <\fBhttps://github\&.com/erebor/asciidoctor/issues?state=open\fR>
+See the \fBAsciidoctor\fR issue tracker: <\fBhttps://github\&.com/asciidoctor/asciidoctor/issues?state=open\fR>
 .SH "AUTHORS"
 .sp
-\fBAsciidoctor\fR was written by Ryan Waldron, Dan Allen and other contributors\&. \fBAsciiDoc\fR was written by Stuart Rackham and has received contributions from many other individuals\&.
+\fBAsciidoctor\fR was written by Ryan Waldron, Dan Allen and other contributors\&.
+.sp
+\fBAsciiDoc\fR was written by Stuart Rackham and has received contributions from many other individuals\&.
 .SH "RESOURCES"
 .sp
-Git source repository on GitHub: <\fBhttps://github\&.com/erebor/asciidoctor\fR>
+Git source repository on GitHub: <\fBhttps://github\&.com/asciidoctor/asciidoctor\fR>
+.sp
+Project web site: <\fBhttp://asciidoctor\&.org\fR>
+.sp
+GitHub organization: <\fBhttp://github\&.com/asciidoctor\fR>
 .sp
-Main web site: <\fBhttp://asciidoctor\&.org\fR>
+Mailinglist / forum: <\fBhttp://discuss\&.asciidoctor\&.org\fR>
 .SH "COPYING"
 .sp
 Copyright (C) Ryan Waldron\&. Free use of this software is granted under the terms of the MIT License\&.

data/man/asciidoctor.ad

@@ -34,14 +34,16 @@ Security Settings
     of the program.
 
 *-S, --safe-mode*='SAFE_MODE'::
-    Set safe mode level explicity: 'unsafe', 'safe', 'secure'. Defaults to
-    'secure'. Disables potentially dangerous macros in source files, such as
-    include::[].
+    Set safe mode level: 'unsafe', 'safe', 'server' or 'secure'. Disables
+    potentially dangerous macros in source files, such as include::[]. If not
+    set, the safe mode level defaults to 'unsafe' when Asciidoctor is invoked
+    using this script.
 
 *--safe*::
-    Set safe mode to 'safe' from the default safe mode of 'secure'. Enables
-    include macros, but restricts access to ancestor paths of source file.
-    Provided for compatibility with the asciidoc command.
+    Set safe mode level to 'safe'. Enables include macros, but restricts access
+    to ancestor paths of source file. Provided for compatibility with the
+    asciidoc command. If not set, the safe mode level defaults to 'unsafe' when
+    Asciidoctor is invoked using this script.
 
 Document Settings
 ~~~~~~~~~~~~~~~~~
@@ -97,7 +99,8 @@ Rendering Control
 
 *-T, --template-dir*='DIR'::
     Directory containing custom render templates that override one or more
-    templates from the the built-in set.
+    templates from the the built-in set. If there is a folder in the directory
+    that matches the backend, the templates from that folder will be used.
 
 Processing Information
 ~~~~~~~~~~~~~~~~~~~~~~
@@ -137,6 +140,7 @@ See the *Asciidoctor* issue tracker: <**https://github.com/asciidoctor/asciidoct
 AUTHORS
 -------
 *Asciidoctor* was written by Ryan Waldron, Dan Allen and other contributors.
+
 *AsciiDoc* was written by Stuart Rackham and has received contributions from
 many other individuals.
 
@@ -149,6 +153,8 @@ Project web site: <**http://asciidoctor.org**>
 
 GitHub organization: <**http://github.com/asciidoctor**>
 
+Mailinglist / forum: <**http://discuss.asciidoctor.org**>
+
 
 COPYING
 -------

data/test/attributes_test.rb

@@ -7,6 +7,11 @@ context 'Attributes' do
       assert_equal 'Tanglefoot', doc.attributes['frog']
     end
 
+    test 'requires a space after colon following attribute name' do
+      doc = document_from_string 'foo:bar'
+      assert_equal nil, doc.attributes['foo']
+    end
+
     test 'creates an attribute by fusing a multi-line value' do
       str = <<-EOS
 :description: This is the first      +
@@ -130,9 +135,15 @@ endif::holygrail[]
     end
 
     test "convert multi-word names and render" do
-      html = render_string("Main Header\n===========\n:My frog: Tanglefoot\n\nYo, {myfrog}!")
-      result = Nokogiri::HTML(html)
-      assert_equal 'Yo, Tanglefoot!', result.css("p").first.content.strip
+      input = <<-EOS
+Main Header
+===========
+:My frog: Tanglefoot
+
+Yo, {myfrog}!
+      EOS
+      output = render_string input
+      assert_xpath '(//p)[1][text()="Yo, Tanglefoot!"]', output, 1
     end
 
     test "ignores lines with bad attributes" do
@@ -182,11 +193,18 @@ To use {gem_name}, the first thing to do is to import it in your Ruby source fil
     end
 
     test 'renders attribute until it is deleted' do
-      pending 'This requires that we consume attributes as the document is being lexed, not up front'
-      #output = render_string(":foo: bar\n\nCrossing the {foo}\n\n:foo!:\nBelly up to the {foo}")
-      # result = Nokogiri::HTML(html)
-      # assert_match /Crossing the bar/, result.css("p").first.content.strip
-      # assert_no_match /Belly up to the bar/, result.css("p").last.content.strip
+      input = <<-EOS
+:foo: bar
+
+Crossing the {foo}.
+
+:foo!:
+
+Belly up to the {foo}.
+      EOS
+      output = render_embedded_string input
+      assert_xpath '//p[text()="Crossing the bar."]', output, 1
+      assert_xpath '//p[text()="Belly up to the bar."]', output, 0
     end
 
     test 'does not disturb attribute-looking things escaped with backslash' do
@@ -421,6 +439,22 @@ paragraph
       assert_equal 'coolio', subsec.id
     end
 
+    test 'block id above document title sets id on document' do
+      input = <<-EOS
+[[reference]]
+Reference Manual
+================
+:css-signature: refguide
+
+preamble
+      EOS
+      doc = document_from_string input
+      assert_equal 'reference', doc.id 
+      assert_equal 'refguide', doc.attr('css-signature')
+      output = doc.render
+      assert_xpath '//body[@id="reference"]', output, 1
+    end
+
     test "trailing block attributes tranfer to the following section" do
       input = <<-EOS
 [[one]]

data/test/blocks_test.rb

@@ -2,7 +2,7 @@ require 'test_helper'
 require 'pathname'
 
 context "Blocks" do
-  context "Rulers" do
+  context 'Line Breaks' do
     test "ruler" do
       output = render_string("'''")
       assert_xpath '//*[@id="content"]/hr', output, 1
@@ -15,6 +15,13 @@ context "Blocks" do
       assert_xpath '//*[@id="content"]/hr/preceding-sibling::*', output, 1
       assert_xpath '//*[@id="content"]/hr/following-sibling::*', output, 1
     end
+
+    test "page break" do
+      output = render_embedded_string("page 1\n\n<<<\n\npage 2")
+      assert_xpath '/*[@style="page-break-after: always"]', output, 1
+      assert_xpath '/*[@style="page-break-after: always"]/preceding-sibling::div/p[text()="page 1"]', output, 1
+      assert_xpath '/*[@style="page-break-after: always"]/following-sibling::div/p[text()="page 2"]', output, 1
+    end
   end
 
   context 'Comments' do
@@ -99,6 +106,15 @@ block comment
       assert_equal 1, d.blocks.size
       assert_xpath '//p', d.render, 1
     end
+
+    test 'line starting with three slashes should not be line comment' do
+      input = <<-EOS
+/// not a line comment
+      EOS
+
+      output = render_embedded_string input
+      assert !output.strip.empty?, "Line should be emitted => #{input.rstrip}"
+    end
   end
 
   context "Example Blocks" do
@@ -181,6 +197,72 @@ You just write.
       assert_xpath '(//*[@class="exampleblock"])[1]/*[@class="title"][text()="Look! Writing Docs with AsciiDoc"]', output, 1
       assert !doc.attributes.has_key?('example-number')
     end
+
+    test 'automatic caption can be turned off and on and modified' do
+      input = <<-EOS
+.first example
+====
+an example
+====
+
+:caption:
+
+.second example
+====
+another example
+====
+
+:caption!:
+:example-caption: Exhibit
+
+.third example
+====
+yet another example
+====
+      EOS
+
+      output = render_embedded_string input
+      assert_xpath '/*[@class="exampleblock"]', output, 3
+      assert_xpath '(/*[@class="exampleblock"])[1]/*[@class="title"][starts-with(text(), "Example ")]', output, 1
+      assert_xpath '(/*[@class="exampleblock"])[2]/*[@class="title"][text()="second example"]', output, 1
+      assert_xpath '(/*[@class="exampleblock"])[3]/*[@class="title"][starts-with(text(), "Exhibit ")]', output, 1
+    end
+  end
+
+  context 'Admonition Blocks' do
+    test 'caption block-level attribute should be used as caption' do
+       input = <<-EOS
+:tip-caption: Pro Tip
+
+[caption="Pro Tip"]
+TIP: Override the caption of an admonition block using an attribute entry
+       EOS
+
+       output = render_embedded_string input
+       assert_xpath '/*[@class="admonitionblock"]//*[@class="icon"]/*[@class="title"][text()="Pro Tip"]', output, 1
+    end
+
+    test 'can override caption of admonition block using document attribute' do
+       input = <<-EOS
+:tip-caption: Pro Tip
+
+TIP: Override the caption of an admonition block using an attribute entry
+       EOS
+
+       output = render_embedded_string input
+       assert_xpath '/*[@class="admonitionblock"]//*[@class="icon"]/*[@class="title"][text()="Pro Tip"]', output, 1
+    end
+
+    test 'blank caption document attribute should not blank admonition block caption' do
+       input = <<-EOS
+:caption:
+
+TIP: Override the caption of an admonition block using an attribute entry
+       EOS
+
+       output = render_embedded_string input
+       assert_xpath '/*[@class="admonitionblock"]//*[@class="icon"]/*[@class="title"][text()="Tip"]', output, 1
+    end
   end
 
   context "Preformatted Blocks" do
@@ -394,6 +476,30 @@ paragraph
       assert_xpath '//*[@class="paragraph"]/*[@class="title"][text() = "Title"]', output, 1
       assert_xpath '//*[@class="paragraph"]/p[text() = "paragraph"]', output, 1
     end
+
+    test 'block title above document title gets carried over to preamble' do
+      input = <<-EOS
+.Block title
+= Document Title
+
+preamble
+      EOS
+      output = render_string input
+      assert_xpath '//*[@id="preamble"]//*[@class="paragraph"]/*[@class="title"][text()="Block title"]', output, 1
+    end
+
+    test 'block title above document title gets carried over to first block in first section if no preamble' do
+      input = <<-EOS
+.Block title
+= Document Title
+
+== First Section 
+
+paragraph
+      EOS
+      output = render_string input
+      assert_xpath '//*[@class="sect1"]//*[@class="paragraph"]/*[@class="title"][text() = "Block title"]', output, 1
+    end
   end
 
   context "Images" do
@@ -446,6 +552,17 @@ image::images/tiger.png[Tiger]
       assert_equal 1, doc.attributes['figure-number']
     end
 
+    test 'should pass through image that is a uri reference' do
+      input = <<-EOS
+:imagesdir: images
+
+image::http://asciidoc.org/images/tiger.png[Tiger]
+      EOS
+
+      output = render_string input
+      assert_xpath '//*[@class="imageblock"]//img[@src="http://asciidoc.org/images/tiger.png"][@alt="Tiger"]', output, 1
+    end
+
     test 'can resolve image relative to imagesdir' do
       input = <<-EOS
 :imagesdir: images
@@ -593,6 +710,49 @@ image::asciidoctor.png[Asciidoctor]
   end
 
   context 'Source code' do
+    test 'should support fenced code block using backticks' do
+      input = <<-EOS
+```
+puts "Hello, World!"
+```
+      EOS
+
+      output = render_embedded_string input
+      assert_css '.listingblock', output, 1
+      assert_css '.listingblock pre code', output, 1
+      assert_css '.listingblock pre code:not([class])', output, 1
+    end
+
+    test 'should support fenced code block using tildes' do
+      input = <<-EOS
+~~~
+puts "Hello, World!"
+~~~
+      EOS
+
+      output = render_embedded_string input
+      assert_css '.listingblock', output, 1
+      assert_css '.listingblock pre code', output, 1
+      assert_css '.listingblock pre code:not([class])', output, 1
+    end
+
+    test 'should support fenced code blocks with languages' do
+      input = <<-EOS
+```ruby
+puts "Hello, World!"
+```
+
+~~~ javascript
+alert("Hello, World!")
+~~~
+      EOS
+
+      output = render_embedded_string input
+      assert_css '.listingblock', output, 2
+      assert_css '.listingblock pre code.ruby', output, 1
+      assert_css '.listingblock pre code.javascript', output, 1
+    end
+
     test 'should highlight source if source-highlighter attribute is coderay' do
       input = <<-EOS
 :source-highlighter: coderay

data/test/document_test.rb

@@ -3,7 +3,7 @@ require 'test_helper'
 context 'Document' do
 
   context 'Example document' do
-    test 'test_title' do
+    test 'document title' do
       doc = example_document(:asciidoc_index)
       assert_equal 'AsciiDoc Home Page', doc.doctitle
       assert_equal 'AsciiDoc Home Page', doc.name
@@ -219,7 +219,7 @@ preamble
       assert !renderer.nil?
       views = renderer.views
       assert !views.nil?
-      assert_equal 29, views.size
+      assert_equal 30, views.size
       assert views.has_key? 'document'
       assert views['document'].is_a?(Asciidoctor::HTML5::DocumentTemplate)
       assert_equal 'ERB', views['document'].eruby.to_s
@@ -235,7 +235,7 @@ preamble
       assert !renderer.nil?
       views = renderer.views
       assert !views.nil?
-      assert_equal 29, views.size
+      assert_equal 30, views.size
       assert views.has_key? 'document'
       assert views['document'].is_a?(Asciidoctor::DocBook45::DocumentTemplate)
       assert_equal 'ERB', views['document'].eruby.to_s
@@ -255,7 +255,7 @@ preamble
   end
 
   context 'Structure' do
-    test 'test_with_no_title' do
+    test 'document with no doctitle' do
       doc = document_from_string('Snorf')
       assert_nil doc.doctitle
       assert_nil doc.name
@@ -263,7 +263,22 @@ preamble
       assert_nil doc.header
     end
 
-    test 'test_with_explicit_title' do
+    test 'document with doctitle defined as attribute entry' do
+     input = <<-EOS
+:doctitle: Document Title
+
+preamble
+
+== First Section
+     EOS
+     doc = document_from_string input
+     assert_equal 'Document Title', doc.doctitle
+     assert doc.has_header?
+     assert_equal 'Document Title', doc.header.title
+     assert_equal 'Document Title', doc.first_section.title
+    end
+
+    test 'document with title attribute entry overrides doctitle' do
      input = <<-EOS
 = Title
 :title: Document Title
@@ -280,6 +295,23 @@ preamble
      assert_equal 'Title', doc.first_section.title
     end
 
+    test 'document with doctitle attribute entry overrides header title and doctitle' do
+     input = <<-EOS
+= Title
+:doctitle: Override
+
+preamble
+
+== First Section
+     EOS
+     doc = document_from_string input
+     assert_equal 'Override', doc.doctitle
+     assert_nil doc.title
+     assert doc.has_header?
+     assert_equal 'Override', doc.header.title
+     assert_equal 'Override', doc.first_section.title
+    end
+
     test 'should recognize document title when preceded by blank lines' do
       input = <<-EOS
 :doctype: book
@@ -297,15 +329,23 @@ text
       assert_css '#content h1', output, 0
     end
      
-    test 'test_empty_document' do
-      doc = document_from_string('')
+    test 'should not choke on empty source' do
+      doc = Asciidoctor::Document.new ''
+      assert doc.blocks.empty?
+      assert_nil doc.doctitle
+      assert !doc.has_header?
+      assert_nil doc.header
+    end
+
+    test 'should not choke on nil source' do
+      doc = Asciidoctor::Document.new nil
       assert doc.blocks.empty?
       assert_nil doc.doctitle
       assert !doc.has_header?
       assert_nil doc.header
     end
 
-    test 'test_with_metadata' do
+    test 'with metadata' do
       input = <<-EOS
 = AsciiDoc
 Stuart Rackham <founder@asciidoc.org>
@@ -323,20 +363,50 @@ more info...
       assert_xpath '//*[@id="header"]/span[@id="revremark"][text() = "See changelog."]', output, 1
     end
 
-    test 'test_with_header_footer' do
+    test 'with header footer' do
       result = render_string("= Title\n\npreamble")
       assert_xpath '/html', result, 1
       assert_xpath '//*[@id="header"]', result, 1
+      assert_xpath '//*[@id="header"]/h1', result, 1
       assert_xpath '//*[@id="footer"]', result, 1
       assert_xpath '//*[@id="preamble"]', result, 1
     end
 
-    test 'test_with_no_header_footer' do
+    test 'no header footer' do
       result = render_string("= Title\n\npreamble", :header_footer => false)
       assert_xpath '/html', result, 0
+      assert_xpath '/h1', result, 0
+      assert_xpath '/*[@id="header"]', result, 0
+      assert_xpath '/*[@id="footer"]', result, 0
+      assert_xpath '/*[@id="preamble"]', result, 1
+    end
+
+    test 'wip enable title when no header footer' do
+      result = render_string("= Title\n\npreamble", :header_footer => false, :attributes => {'notitle!' => ''})
+      assert_xpath '/html', result, 0
+      assert_xpath '/h1', result, 1
       assert_xpath '/*[@id="header"]', result, 0
       assert_xpath '/*[@id="footer"]', result, 0
       assert_xpath '/*[@id="preamble"]', result, 1
+      assert_xpath '(/*)[1]/self::h1', result, 1
+      assert_xpath '(/*)[2]/self::*[@id="preamble"]', result, 1
+    end
+
+    test 'parse header only' do
+      input = <<-EOS
+= Document Title
+Author Name
+:foo: bar
+
+preamble
+      EOS
+
+      doc = document_from_string input, :parse_header_only => true
+      assert_equal 'Document Title', doc.doctitle
+      assert_equal 'Author Name', doc.author
+      assert_equal 'bar', doc.attributes['foo']
+      # there would be at least 1 block had it parsed beyond the header
+      assert_equal 0, doc.blocks.size
     end
 
     test 'renders footnotes in footer' do
@@ -361,7 +431,7 @@ finally a reference to the second footnote footnoteref:[note2].
   end
 
   context 'Backends and Doctypes' do 
-    test 'test_html5_backend_doctype_article' do
+    test 'html5 backend doctype article' do
       result = render_string("= Title\n\npreamble", :attributes => {'backend' => 'html5'})
       assert_xpath '/html', result, 1
       assert_xpath '/html/body[@class="article"]', result, 1
@@ -369,7 +439,7 @@ finally a reference to the second footnote footnoteref:[note2].
       assert_xpath '/html//*[@id="preamble"]//p[text() = "preamble"]', result, 1
     end
 
-    test 'test_html5_backend_doctype_book' do
+    test 'html5 backend doctype book' do
       result = render_string("= Title\n\npreamble", :attributes => {'backend' => 'html5', 'doctype' => 'book'})
       assert_xpath '/html', result, 1
       assert_xpath '/html/body[@class="book"]', result, 1
@@ -377,7 +447,7 @@ finally a reference to the second footnote footnoteref:[note2].
       assert_xpath '/html//*[@id="preamble"]//p[text() = "preamble"]', result, 1
     end
 
-    test 'test_docbook45_backend_doctype_article' do
+    test 'docbook45 backend doctype article' do
       input = <<-EOS
 = Title
 
@@ -396,14 +466,14 @@ section body
       assert_xpath '/article/section[@id = "_first_section"]/simpara[text() = "section body"]', result, 1
     end
 
-    test 'test_docbook45_backend_doctype_article_no_title' do
+    test 'docbook45 backend doctype article no title' do
       result = render_string('text', :attributes => {'backend' => 'docbook45'})
       assert_xpath '/article', result, 1
       assert_xpath '/article/articleinfo/date', result, 1
       assert_xpath '/article/simpara[text() = "text"]', result, 1
     end
 
-    test 'test_docbook45_backend_doctype_book' do
+    test 'docbook45 backend doctype book' do
       input = <<-EOS
 = Title
 
@@ -422,13 +492,33 @@ chapter body
       assert_xpath '/book/chapter[@id = "_first_chapter"]/simpara[text() = "chapter body"]', result, 1
     end
 
-    test 'test_docbook45_backend_doctype_book_no_title' do
+    test 'docbook45 backend doctype book no title' do
       result = render_string('text', :attributes => {'backend' => 'docbook45', 'doctype' => 'book'})
       assert_xpath '/book', result, 1
       assert_xpath '/book/bookinfo/date', result, 1
       assert_xpath '/book/simpara[text() = "text"]', result, 1
     end
 
+    test 'should be able to set backend using :backend option key' do
+      doc = Asciidoctor::Document.new([], :backend => 'html5')
+      assert_equal 'html5', doc.attributes['backend']
+    end
+
+    test ':backend option should override backend attribute' do
+      doc = Asciidoctor::Document.new([], :backend => 'html5', :attributes => {'backend' => 'docbook45'})
+      assert_equal 'html5', doc.attributes['backend']
+    end
+
+    test 'should be able to set doctype using :doctype option key' do
+      doc = Asciidoctor::Document.new([], :doctype => 'book')
+      assert_equal 'book', doc.attributes['doctype']
+    end
+
+    test ':doctype option should override doctype attribute' do
+      doc = Asciidoctor::Document.new([], :doctype => 'book', :attributes => {'doctype' => 'article'})
+      assert_equal 'book', doc.attributes['doctype']
+    end
+
     test 'do not override explicit author initials' do
       input = <<-EOS
 = AsciiDoc
@@ -440,5 +530,33 @@ more info...
       output = render_string input, :attributes => {'backend' => 'docbook45'}
       assert_xpath '/article/articleinfo/authorinitials[text()="SJR"]', output, 1
     end
+
+    test 'attribute entry can appear immediately after document title' do
+      input = <<-EOS
+Reference Guide
+===============
+:toc:
+
+preamble
+      EOS
+      doc = document_from_string input
+      assert doc.attr?('toc')
+      assert_equal '', doc.attr('toc')
+    end
+
+    test 'attribute entry can appear before author line under document title' do
+      input = <<-EOS
+Reference Guide
+===============
+:toc:
+Dan Allen
+
+preamble
+      EOS
+      doc = document_from_string input
+      assert doc.attr?('toc')
+      assert_equal '', doc.attr('toc')
+      assert_equal 'Dan Allen', doc.attr('author')
+    end
   end
 end