prawn 1.0.0 → 1.1.0

data/manual/table/width.rb

@@ -9,11 +9,11 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   text "Normal width:"
   table [%w[A B C]]
   move_down 20
-  
+
   text "Fixed width:"
   table([%w[A B C]], :width => 300)
   move_down 20
@@ -21,7 +21,7 @@ Prawn::Example.generate(filename) do
   text "Normal width:"
   table([["A", "Blah " * 20, "C"]])
   move_down 20
-  
+
   text "Fixed width:"
   table([["A", "Blah " * 20, "C"]], :width => 300)
 end

data/manual/text/alignment.rb

@@ -16,7 +16,7 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   text "This text should be left aligned"
   text "This text should be centered",      :align => :center
   text "This text should be right aligned", :align => :right

data/manual/text/color.rb

@@ -7,7 +7,7 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   text "Default color is black"
   move_down 25
 

data/manual/text/column_box.rb

@@ -9,7 +9,7 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   text "The Prince",          :align => :center, :size => 18
   text "Niccolò Machiavelli", :align => :center, :size => 14
   move_down 12

data/manual/text/fallback_fonts.rb

@@ -8,17 +8,17 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   file = "#{Prawn::DATADIR}/fonts/gkai00mp.ttf"
   font_families["Kai"] = {
     :normal => { :file => file, :font => "Kai" }
   }
-  
+
   file = "#{Prawn::DATADIR}/fonts/Panic+Sans.dfont"
   font_families["Panic Sans"] = {
     :normal => { :file => file, :font => "PanicSans" },
   }
-  
+
   font("Panic Sans") do
     text("When fallback fonts are included, each glyph will be rendered " +
          "using the first font that includes the glyph, starting with the " +

data/manual/text/font.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
-# 
+#
 # The <code>font</code> method can be used in three different ways.
 #
 # If we don't pass it any arguments it will return the current font being used
@@ -17,24 +17,24 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   text "Let's see which font we are using: #{font.inspect}"
-  
+
   move_down 20
   font "Times-Roman"
   text "Written in Times."
-  
+
   move_down 20
   font("Courier") do
     text "Written in Courier because we are inside the block."
   end
-  
+
   move_down 20
   text "Written in Times again as we left the previous block."
-  
+
   move_down 20
   text "Let's see which font we are using again: #{font.inspect}"
-  
+
   move_down 20
   font "Helvetica"
   text "Back to normal."

data/manual/text/font_size.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
-# 
+#
 # The <code>font_size</code> method works just like the <code>font</code>
 # method.
 #
@@ -15,30 +15,30 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   text "Let's see which is the current font_size: #{font_size.inspect}"
-  
+
   move_down 10
   font_size 16
   text "Yeah, something bigger!"
-  
+
   move_down 10
   font_size(25) { text "Even bigger!" }
-  
+
   move_down 10
   text "Back to 16 again."
-  
+
   move_down 10
   text "Single line on 20 using the :size option.", :size => 20
-  
+
   move_down 10
   text "Back to 16 once more."
-  
+
   move_down 10
   font("Courier", :size => 10) do
     text "Yeah, using Courier 10 courtesy of the font method."
   end
-  
+
   move_down 10
   font("Helvetica", :size => 12)
   text "Back to normal"

data/manual/text/font_style.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
-# 
+#
 # Most font families come with some styles other than normal. Most common are
 # <code>bold</code>, <code>italic</code> and <code>bold_italic</code>.
 #
@@ -11,10 +11,10 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   ["Courier", "Helvetica", "Times-Roman"].each do |example_font|
     move_down 20
-    
+
     [:bold, :bold_italic, :italic, :normal].each do |style|
       font example_font, :style => style
       text "I'm writing in #{example_font} (#{style})"

data/manual/text/formatted_callbacks.rb

@@ -15,7 +15,7 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   class HighlightCallback
     def initialize(options)
       @color    = options[:color]
@@ -40,7 +40,7 @@ Prawn::Example.generate(filename) do
     def render_in_front(fragment)
       @document.stroke_polygon(fragment.top_left, fragment.top_right,
                                fragment.bottom_right, fragment.bottom_left)
-      
+
       @document.fill_circle(fragment.top_left,     @radius)
       @document.fill_circle(fragment.top_right,    @radius)
       @document.fill_circle(fragment.bottom_right, @radius)
@@ -50,7 +50,7 @@ Prawn::Example.generate(filename) do
 
   highlight = HighlightCallback.new(:color => 'ffff00', :document => self)
   border    = ConnectedBorderCallback.new(:radius => 2.5, :document => self)
-  
+
   formatted_text [ { :text => "hello", :callback => highlight },
                    { :text => "     " },
                    { :text => "world", :callback => border },

data/manual/text/formatted_text.rb

@@ -17,14 +17,14 @@
 # <code>:character_spacing</code> (additional space between the characters),
 # <code>:font</code> (the name of a registered font), <code>:color</code> (the
 # same input accepted by <code>fill_color</code> and <code>stroke_color</code>),
-# <code>:link</code> (an URL to create a link), and <code>:local</code> 
+# <code>:link</code> (an URL to create a link), and <code>:local</code>
 # (a link to a local file).
 
 require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   formatted_text [ { :text => "Some bold. ",      :styles => [:bold] },
                    { :text => "Some italic. ",    :styles => [:italic] },
                    { :text => "Bold italic. ",    :styles => [:bold, :italic] },
@@ -39,7 +39,7 @@ Prawn::Example.generate(filename) do
                      :color => "0000FF",
                      :local => "./local_file.txt" }
                  ]
-  
+
   formatted_text_box [ { :text => "Just your regular" },
                        { :text => " text_box ", :font => "Courier" },
                        { :text => "with some additional formatting options " +

data/manual/text/free_flowing_text.rb

@@ -17,29 +17,29 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   move_cursor_to 50
   text "This text will flow to the next page. " * 20
-  
+
   y_position = cursor - 50
   bounding_box([0, y_position], :width => 200, :height => 150) do
     transparent(0.5) { stroke_bounds }
     text "This text will flow along this bounding box we created for it. " * 5
   end
-  
+
   bounding_box([300, y_position], :width => 200, :height => 150) do
     transparent(0.5) { stroke_bounds }  # This will stroke on one page
-    
+
     text "Now look what happens when the free flowing text reaches the end " +
          "of a bounding box that is narrower than the margin box." +
          " . " * 200 +
          "It continues on the next page as if the previous bounding box " +
          "was cloned. If we want it to have the same border as the one on " +
          "the previous page we will need to stroke the boundaries again."
-    
+
     transparent(0.5) { stroke_bounds }  # And this will stroke on the next
   end
-  
+
   move_cursor_to 200
   span(350, :position => :center) do
     text "Span is a different kind of bounding box as it lets the text " +

data/manual/text/inline.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
-# 
+#
 # Inline formatting gives you the option to format specific portions of a text.
 # It uses HTML-esque syntax inside the text string. Supported tags are:
 # <code>b</code> (bold), <code>i</code> (italic), <code>u</code> (underline),
@@ -15,25 +15,25 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   %w[b i u strikethrough sub sup].each do |tag|
     text "Just your regular text <#{tag}>except this portion</#{tag}> " +
          "is using the #{tag} tag",
          :inline_format => true
     move_down 10
   end
-  
+
   text "This <font size='18'>line</font> uses " +
        "<font name='Courier'>all the font tag</font> attributes in " +
        "<font character_spacing='2'>a single line</font>. ",
        :inline_format => true
   move_down 10
-  
+
   text "Coloring in <color rgb='FF00FF'>both RGB</color> " +
        "<color c='100' m='0' y='0' k='0'>and CMYK</color>",
        :inline_format => true
   move_down 10
-  
+
   text "This an external link to the " +
        "<u><link href='https://github.com/prawnpdf/prawn/wiki'>Prawn wiki" +
        "</link></u>",

data/manual/text/kerning_and_character_spacing.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
-# 
+#
 # Kerning is the process of adjusting the spacing between characters in a
 # proportional font. It is usually done with specific letter pairs. We can
 # switch it on and off if it is available with the current font. Just pass a
@@ -13,23 +13,23 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   font_size(30) do
     text_box "With kerning:",    :kerning => true,  :at => [0, y - 40]
     text_box "Without kerning:", :kerning => false, :at => [0, y - 80]
-    
+
     text_box "Tomato", :kerning => true,  :at => [250, y - 40]
     text_box "Tomato", :kerning => false, :at => [250, y - 80]
-    
+
     text_box "WAR", :kerning => true,  :at => [400, y - 40]
     text_box "WAR", :kerning => false, :at => [400, y - 80]
-    
+
     text_box "F.", :kerning => true,  :at => [500, y - 40]
     text_box "F.", :kerning => false, :at => [500, y - 80]
   end
-  
+
   move_down 80
-  
+
   string = "What have you done to the space between the characters?"
   [-2, -1, 0, 0.5, 1, 2].each do |spacing|
     move_down 20

data/manual/text/leading.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
-# 
+#
 # Leading is the additional space between lines of text.
 #
 # The leading can be set using the <code>default_leading</code> method which
@@ -12,14 +12,14 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   string = "Hey, what did you do with the space between my lines? " * 10
   text string, :leading => 0
-  
+
   move_down 20
   default_leading 5
   text string
-  
+
   move_down 20
   text string, :leading => 10
 end

data/manual/text/line_wrapping.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
-# 
+#
 # Line wrapping happens on white space or hyphens. Soft hyphens can be used to
 # indicate where words can be hyphenated. Non-breaking spaces can be used to
 # display space without allowing for a break.
@@ -11,7 +11,7 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   text "Hard hyphens:\n" +
        "Slip-sliding away, slip sliding awaaaay. You know the " +
        "nearer your destination the more you're slip-sliding away."
@@ -22,7 +22,7 @@ Prawn::Example.generate(filename) do
        "Slip slid#{shy}ing away, slip slid#{shy}ing away. You know the " +
        "nearer your destinat#{shy}ion the more you're slip slid#{shy}ing away."
   move_down 20
-  
+
   nbsp = Prawn::Text::NBSP
   text "Non-breaking spaces:\n" +
        "Slip#{nbsp}sliding away, slip#{nbsp}sliding awaaaay. You know the " +
@@ -33,7 +33,7 @@ Prawn::Example.generate(filename) do
     long_text = "No word boundaries:\n更可怕的是，同质化竞争对手可以按照URL中后面这个ID来遍历您的DB中的内容，写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事，这样的话，你就非常被动了。更可怕的是，同质化竞争对手可以按照URL中后面这个ID来遍历您的DB中的内容，写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事，这样的话，你就非常被动了。"
     text long_text
     move_down 20
-    
+
     zwsp = Prawn::Text::ZWSP
     long_text = "Invisible word boundaries:\n更#{zwsp}可怕的#{zwsp}是，#{zwsp}同质化#{zwsp}竞争#{zwsp}对#{zwsp}手#{zwsp}可以#{zwsp}按照#{zwsp}URL#{zwsp}中#{zwsp}后面#{zwsp}这个#{zwsp}ID#{zwsp}来#{zwsp}遍历#{zwsp}您的#{zwsp}DB#{zwsp}中的#{zwsp}内容，#{zwsp}写个#{zwsp}小爬虫#{zwsp}把#{zwsp}你的#{zwsp}页面#{zwsp}上的#{zwsp}关#{zwsp}键#{zwsp}信#{zwsp}息顺#{zwsp}次#{zwsp}爬#{zwsp}下来#{zwsp}也#{zwsp}不是#{zwsp}什么#{zwsp}难事，#{zwsp}这样的话，#{zwsp}你#{zwsp}就#{zwsp}非常#{zwsp}被动了。#{zwsp}更#{zwsp}可怕的#{zwsp}是，#{zwsp}同质化#{zwsp}竞争#{zwsp}对#{zwsp}手#{zwsp}可以#{zwsp}按照#{zwsp}URL#{zwsp}中#{zwsp}后面#{zwsp}这个#{zwsp}ID#{zwsp}来#{zwsp}遍历#{zwsp}您的#{zwsp}DB#{zwsp}中的#{zwsp}内容，#{zwsp}写个#{zwsp}小爬虫#{zwsp}把#{zwsp}你的#{zwsp}页面#{zwsp}上的#{zwsp}关#{zwsp}键#{zwsp}信#{zwsp}息顺#{zwsp}次#{zwsp}爬#{zwsp}下来#{zwsp}也#{zwsp}不是#{zwsp}什么#{zwsp}难事，#{zwsp}这样的话，#{zwsp}你#{zwsp}就#{zwsp}非常#{zwsp}被动了。"
     text long_text

data/manual/text/paragraph_indentation.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
-# 
+#
 # Prawn strips all whitespace from the beginning and the end of strings so there
 # are two ways to indent paragraphs:
 #
@@ -14,11 +14,11 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   # Using non-breaking spaces
   text " " * 10 + "This paragraph won't be indented. " * 10 +
        "\n#{Prawn::Text::NBSP * 10}" + "This one will with NBSP. " * 10
-  
+
   move_down 20
   text "This paragraph will be indented. " * 10 +
        "\n" + "This one will too. " * 10,

data/manual/text/positioned_text.rb

@@ -21,17 +21,17 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   draw_text "This draw_text line is absolute positioned. However don't " +
             "expect it to flow even if it hits the document border",
             :at => [200, 300]
-  
+
   text_box "This is a text box, you can control where it will flow by " +
            "specifying the :height and :width options",
            :at => [100, 250],
            :height => 100,
            :width => 100
-  
+
   text_box "Another text box with no :width option passed, so it will " +
            "flow to a new line whenever it reaches the right margin. ",
            :at => [200, 100]

data/manual/text/registering_families.rb

@@ -12,17 +12,17 @@ require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   # Registering a single TTF font
   font_families.update("DejaVu Sans" => {
     :normal => "#{Prawn::DATADIR}/fonts/DejaVuSans.ttf"
   })
-  
+
   font("DejaVu Sans") do
     text "Using the DejaVu Sans font providing only its name to the font method"
   end
   move_down 20
-  
+
   # Registering a DFONT package
   font_path = "#{Prawn::DATADIR}/fonts/Panic+Sans.dfont"
   font_families.update("Panic Sans" => {
@@ -31,15 +31,15 @@ Prawn::Example.generate(filename) do
     :bold        => { :file => font_path, :font => "PanicSans-Bold" },
     :bold_italic => { :file => font_path, :font => "PanicSans-BoldItalic" }
   })
-  
+
   font "Panic Sans"
   text "Also using Panic Sans by providing only its name"
   move_down 20
-  
+
   text "Taking <b>advantage</b> of the <i>inline formatting</i>",
        :inline_format => true
   move_down 20
-  
+
   [:bold, :bold_italic, :italic, :normal].each do |style|
     text "Using the #{style} style option.",
          :style => style