prawn 1.0.0 → 1.1.0

data/manual/images/absolute_position.rb

@@ -13,11 +13,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
   y_position = cursor
   text "The image won't go below this line of text."
-  
+
   image "#{Prawn::DATADIR}/images/fractal.jpg", :at => [200, y_position]
-  
+
   text "And this line of text will go just below the previous one."
 end

data/manual/images/fit.rb

@@ -10,9 +10,9 @@ 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
   size = 300
-  
+
   text "Using the fit option"
   bounding_box([0, cursor], :width => size, :height => size) do
     image "#{Prawn::DATADIR}/images/pigs.jpg", :fit => [size, size]

data/manual/images/horizontal.rb

@@ -10,15 +10,15 @@ 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
   bounding_box([50, cursor], :width => 400, :height => 450) do
     stroke_bounds
-    
+
     [:left, :center, :right].each do |position|
       text  "Image aligned to the #{position}."
       image "#{Prawn::DATADIR}/images/stef.jpg", :position => position
     end
-    
+
     text  "The next image has a 50 point offset from the left boundary"
     image "#{Prawn::DATADIR}/images/stef.jpg", :position => 50
   end

data/manual/images/images.rb

@@ -5,26 +5,26 @@
 require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
-Prawn::Example.generate("images.pdf", :page_size => "FOLIO") do
-  
+Prawn::ManualBuilder::Example.generate("images.pdf", :page_size => "FOLIO") do
+
   package "images" do |p|
-    
+
     p.section "Basics" do |s|
       s.example "plain_image"
       s.example "absolute_position"
     end
-    
+
     p.section "Relative Positioning" do |s|
       s.example "horizontal"
       s.example "vertical"
     end
-    
+
     p.section "Size" do |s|
       s.example "width_and_height"
       s.example "scale"
       s.example "fit"
     end
-    
+
     p.intro do
       prose("Embedding images on PDF documents is fairly easy. Prawn supports both JPG and PNG images.
 
@@ -35,6 +35,6 @@ Prawn::Example.generate("images.pdf", :page_size => "FOLIO") do
             "How to configure the image dimensions by setting the width and height or by scaling it"
           )
     end
-    
+
   end
 end

data/manual/images/plain_image.rb

@@ -12,7 +12,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 image will go right below this line of text."
   image "#{Prawn::DATADIR}/images/pigs.jpg"
 end

data/manual/images/scale.rb

@@ -8,15 +8,15 @@ 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 size"
   image "#{Prawn::DATADIR}/images/stef.jpg"
   move_down 20
-  
+
   text  "Scaled to 50%"
   image "#{Prawn::DATADIR}/images/stef.jpg", :scale => 0.5
   move_down 20
-  
+
   text  "Scaled to 200%"
   image "#{Prawn::DATADIR}/images/stef.jpg", :scale => 2
 end

data/manual/images/vertical.rb

@@ -10,16 +10,16 @@ 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
   bounding_box([0, cursor], :width => 500, :height => 450) do
     stroke_bounds
-    
+
     [:top, :center, :bottom].each do |vposition|
       text "Image vertically aligned to the #{vposition}.", :valign => vposition
       image "#{Prawn::DATADIR}/images/stef.jpg", :position  => 250,
                                                  :vposition => vposition
     end
-    
+
     text_box "The next image has a 100 point offset from the top boundary",
              :at => [bounds.width - 110, bounds.top - 10], :width => 100
     image "#{Prawn::DATADIR}/images/stef.jpg", :position  => :right,

data/manual/images/width_and_height.rb

@@ -11,15 +11,15 @@ 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  "Scale by setting only the width"
   image "#{Prawn::DATADIR}/images/pigs.jpg", :width => 150
   move_down 20
-  
+
   text  "Scale by setting only the height"
   image "#{Prawn::DATADIR}/images/pigs.jpg", :height => 100
   move_down 20
-  
+
   text  "Stretch to fit the width and height provided"
   image "#{Prawn::DATADIR}/images/pigs.jpg", :width => 500, :height => 100
 end

data/manual/layout/boxes.rb

@@ -12,16 +12,16 @@ 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
   # The grid only need to be defined once, but since all the examples should be
   # able to run alone we are repeating it on every example
   define_grid(:columns => 5, :rows => 8, :gutter => 10)
-  
+
   grid(4,0).show
   grid(5,1).show
-  
+
   grid([6,2], [7,3]).show
-  
+
   grid([4,4], [7,4]).show
   grid([7,0], [7,1]).show
 end

data/manual/layout/content.rb

@@ -10,15 +10,15 @@ 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
   # The grid only need to be defined once, but since all the examples should be
   # able to run alone we are repeating it on every example
   define_grid(:columns => 5, :rows => 8, :gutter => 10)
-  
+
   grid([5,0], [7,1]).bounding_box do
     text "Adding some content to this multi_box.\n" + " _ " * 200
   end
-  
+
   grid(6,3).bounding_box do
     text "Just a little snippet here.\n" + " _ " * 10
   end

data/manual/layout/layout.rb

@@ -5,14 +5,14 @@
 require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
-Prawn::Example.generate("layout.pdf", :page_size => "FOLIO") do
-  
+Prawn::ManualBuilder::Example.generate("layout.pdf", :page_size => "FOLIO") do
+
   package "layout" do |p|
-    
+
     p.example "simple_grid"
     p.example "boxes"
     p.example "content"
-    
+
     p.intro do
       prose("Prawn has support for two-dimensional grid based layouts out of the box.
 
@@ -23,6 +23,6 @@ Prawn::Example.generate("layout.pdf", :page_size => "FOLIO") do
             "How to create boxes according to the grid"
           )
     end
-    
+
   end
 end

data/manual/layout/simple_grid.rb

@@ -12,12 +12,12 @@ 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
   # The grid only need to be defined once, but since all the examples should be
   # able to run alone we are repeating it on every example
   define_grid(:columns => 5, :rows => 8, :gutter => 10)
   text "We defined the grid, roll over to the next page to see its outline"
-  
+
   start_new_page
   grid.show_all
 end

data/manual/outline/add_subsection_to.rb

@@ -21,20 +21,20 @@ 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
   # First we create 10 pages and some default outline
   (1..10).each do |index|
     text "Page #{index}"
     start_new_page
   end
-  
+
   outline.define do
-    section("Section 1", :destination => 1) do 
+    section("Section 1", :destination => 1) do
       page :title => "Page 2", :destination => 2
       page :title => "Page 3", :destination => 3
     end
   end
-  
+
   # Now we will start adding nodes to the previous outline
   outline.add_subsection_to("Section 1", :first) do
     outline.section("Added later - first position") do
@@ -42,17 +42,17 @@ Prawn::Example.generate(filename) do
       outline.page :title => "Page 5", :destination => 5
     end
   end
-  
+
   outline.add_subsection_to("Section 1") do
     outline.page :title => "Added later - last position",
                  :destination => 6
   end
-  
+
   outline.add_subsection_to("Added later - first position") do
     outline.page :title => "Another page added later",
                  :destination => 7
   end
-  
+
   # The title provided is for a page which will be converted into a section
   outline.add_subsection_to("Page 3") do
     outline.page :title => "Last page added",

data/manual/outline/insert_section_after.rb

@@ -13,20 +13,20 @@ 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
   # First we create 10 pages and some default outline
   (1..10).each do |index|
     text "Page #{index}"
     start_new_page
   end
-  
+
   outline.define do
-    section("Section 1", :destination => 1) do 
+    section("Section 1", :destination => 1) do
       page :title => "Page 2", :destination => 2
       page :title => "Page 3", :destination => 3
     end
   end
-  
+
   # Now we will start adding nodes to the previous outline
   outline.insert_section_after("Page 2") do
     outline.section("Section after Page 2") do
@@ -39,7 +39,7 @@ Prawn::Example.generate(filename) do
       outline.page :title => "Page 5", :destination => 5
     end
   end
-  
+
   # Adding just a page
   outline.insert_section_after("Page 3") do
     outline.page :title => "Page after Page 3", :destination => 6

data/manual/outline/outline.rb

@@ -5,19 +5,19 @@
 require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
-Prawn::Example.generate("outline.pdf", :page_size => "FOLIO") do
-  
+Prawn::ManualBuilder::Example.generate("outline.pdf", :page_size => "FOLIO") do
+
   package "outline" do |p|
-    
+
     p.section "Basics" do |s|
       s.example "sections_and_pages", :eval_source => false
     end
-    
+
     p.section "Adding nodes later" do |s|
       s.example "add_subsection_to",    :eval_source => false
       s.example "insert_section_after", :eval_source => false
     end
-    
+
     p.intro do
       prose("The outline of a PDF document is the table of contents tab you see to the right or left of your PDF viewer.
 
@@ -27,6 +27,6 @@ Prawn::Example.generate("outline.pdf", :page_size => "FOLIO") do
             "How to insert sections and/or pages to a previously defined outline structure"
           )
     end
-    
+
   end
 end

data/manual/outline/sections_and_pages.rb

@@ -28,39 +28,39 @@ 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
   # First we create 10 pages just to have something to link to
   (1..10).each do |index|
     text "Page #{index}"
     start_new_page
   end
-  
+
   outline.define do
-    section("Section 1", :destination => 1) do 
+    section("Section 1", :destination => 1) do
       page :title => "Page 2", :destination => 2
       page :title => "Page 3", :destination => 3
     end
-    
+
     section("Section 2", :destination => 4) do
       page :title => "Page 5", :destination => 5
-      
+
       section("Subsection 2.1", :destination => 6, :closed => true) do
         page :title => "Page 7", :destination => 7
       end
     end
   end
-  
+
   # Outside of the define block
   outline.section("Section 3", :destination => 8) do
     outline.page :title => "Page 9", :destination => 9
   end
-  
+
   outline.page :title => "Page 10", :destination => 10
-  
+
   # Section and Pages without links. While a section without a link may be
   # useful to group some pages, a page without a link is useless
   outline.update do  # update is an alias to define
-    section("Section without link") do 
+    section("Section without link") do
       page :title => "Page without link"
     end
   end

data/manual/repeatable_content/page_numbering.rb

@@ -25,9 +25,9 @@ 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 is the first page!"
-  
+
   10.times do
     start_new_page
     text "Here comes yet another page."
@@ -48,7 +48,7 @@ Prawn::Example.generate(filename) do
   options[:start_count_at] = 8
   options[:color]          = "333333"
   number_pages string, options
-  
+
   start_new_page
   text "See. This page isn't numbered and doesn't count towards the total."
 end

data/manual/repeatable_content/repeatable_content.rb

@@ -5,14 +5,14 @@
 require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
-Prawn::Example.generate("repeatable_content.pdf", :page_size => "FOLIO") do
-  
+Prawn::ManualBuilder::Example.generate("repeatable_content.pdf", :page_size => "FOLIO") do
+
   package "repeatable_content" do |p|
-    
+
     p.example "repeater",       :eval_source => false
     p.example "stamp"
     p.example "page_numbering", :eval_source => false
-    
+
     p.intro do
       prose("Prawn offers two ways to handle repeatable content blocks. Repeater is useful for content that gets repeated at well defined intervals while Stamp is more appropriate if you need better control of when to repeat it.
 
@@ -26,6 +26,6 @@ Prawn::Example.generate("repeatable_content.pdf", :page_size => "FOLIO") do
             "How to number the document pages with one simple call"
           )
     end
-    
+
   end
 end