prawn 1.0.0 → 1.1.0

data/manual/graphics/circle_and_ellipse.rb

@@ -11,12 +11,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
   stroke_axis
-  
+
   stroke_circle [100, 300], 100
-    
+
   fill_ellipse [200, 100], 100, 50
-    
+
   fill_ellipse [400, 100], 50
 end

data/manual/graphics/color.rb

@@ -7,18 +7,18 @@ 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
   stroke_axis
-  
+
   # Fill with Yellow using RGB
   fill_color "FFFFCC"
   fill_polygon [50, 150], [150, 200], [250, 150],
                [250, 50], [150, 0], [50, 50]
-  
+
   # Stroke with Purple using CMYK
   stroke_color 50, 100, 0, 0
   stroke_rectangle [300, 300], 200, 100
-  
+
   # Both together
   fill_and_stroke_circle [400, 100], 50
 end

data/manual/graphics/common_lines.rb

@@ -13,18 +13,18 @@ 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
   stroke_axis
 
   stroke_color "ff0000"
-  
+
   stroke do
     # just lower the current y position
-    move_down 50  
+    move_down 50
     horizontal_rule
-    
+
     vertical_line   100, 300, :at => 50
-  
+
     horizontal_line 200, 500, :at => 150
   end
 end

data/manual/graphics/fill_and_stroke.rb

@@ -22,20 +22,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
   stroke_axis
-  
+
   # No block
   line [0, 200], [100, 150]
   stroke
-  
+
   rectangle [0, 100], 100, 100
   fill
-  
+
   # With block
   stroke { line [200, 200], [300, 150] }
   fill   { rectangle [200, 100], 100, 100 }
-  
+
   # Method hook
   stroke_line [400, 200], [500, 150]
   fill_rectangle [400, 100], 100, 100

data/manual/graphics/fill_rules.rb

@@ -20,7 +20,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
   pentagram = [[181, 95], [0, 36], [111, 190], [111, 0], [0, 154]]
 
   stroke_color 'ff0000'

data/manual/graphics/gradients.rb

@@ -8,7 +8,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
   stroke_axis
   self.line_width = 10
 

data/manual/graphics/graphics.rb

@@ -5,15 +5,15 @@
 require File.expand_path(File.join(File.dirname(__FILE__),
                                    %w[.. example_helper]))
 
-Prawn::Example.generate("graphics.pdf", :page_size => "FOLIO") do
-  
+Prawn::ManualBuilder::Example.generate("graphics.pdf", :page_size => "FOLIO") do
+
   package "graphics" do |p|
-    
+
     p.section "Basics" do |s|
       s.example "helper"
       s.example "fill_and_stroke"
     end
-    
+
     p.section "Shapes" do |s|
       s.example "lines_and_curves"
       s.example "common_lines"
@@ -21,7 +21,7 @@ Prawn::Example.generate("graphics.pdf", :page_size => "FOLIO") do
       s.example "polygon"
       s.example "circle_and_ellipse"
     end
-    
+
     p.section "Fill and Stroke settings" do |s|
       s.example "line_width"
       s.example "stroke_cap"
@@ -33,13 +33,13 @@ Prawn::Example.generate("graphics.pdf", :page_size => "FOLIO") do
       s.example "soft_masks"
       s.example "fill_rules"
     end
-    
+
     p.section "Transformations" do |s|
       s.example "rotate"
       s.example "translate"
       s.example "scale"
     end
-    
+
     p.intro do
       prose("Here we show all the drawing methods provided by Prawn. Use them to draw the most beautiful imaginable things.
 
@@ -53,6 +53,6 @@ Prawn::Example.generate("graphics.pdf", :page_size => "FOLIO") do
             "How to apply transformations to your drawing space"
           )
     end
-    
+
   end
 end

data/manual/graphics/helper.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
   stroke_axis
   stroke_axis(:at => [70, 70], :height => 200, :step_length => 50,
               :negative_axes_length => 5, :color => '0000FF')

data/manual/graphics/line_width.rb

@@ -12,24 +12,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
   stroke_axis
-  
+
   y = 250
-  
+
   3.times do |i|
     case i
     when 0 then line_width = 10        # This call will have no effect
     when 1 then self.line_width = 10
     when 2 then self.line_width = 25
     end
-    
+
     stroke do
       horizontal_line 50, 150, :at => y
       rectangle [275, y + 25], 50, 50
       circle [500, y], 25
     end
-    
+
     y -= 100
   end
 end

data/manual/graphics/lines_and_curves.rb

@@ -19,20 +19,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
   stroke_axis
-  
+
   # line_to and curve_to
   stroke do
     move_to 0, 0
-  
+
     line_to 100, 100
     line_to 0, 100
-  
+
     curve_to [150, 250], :bounds => [[20, 200], [120, 200]]
     curve_to [200, 0],   :bounds => [[150, 200], [450, 10]]
   end
-  
+
   # line and curve
   stroke do
     line [300,200], [400,50]

data/manual/graphics/polygon.rb

@@ -11,19 +11,19 @@ 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
   stroke_axis
 
   # Triangle
   stroke_polygon [50, 200], [50, 300], [150, 300]
-  
+
   # Hexagon
   fill_polygon [50, 150], [150, 200], [250, 150],
                [250, 50], [150, 0], [50, 50]
-  
+
   # Pentagram
   pentagon_points = [500, 100], [430, 5], [319, 41], [319, 159], [430, 195]
   pentagram_points = [0, 2, 4, 1, 3].map{ |i| pentagon_points[i] }
-  
+
   stroke_rounded_polygon(20, *pentagram_points)
 end

data/manual/graphics/rectangle.rb

@@ -10,12 +10,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
   stroke_axis
-  
+
   stroke do
     rectangle [100, 300], 100, 200
-    
+
     rounded_rectangle [300, 300], 100, 200, 20
   end
 end

data/manual/graphics/rotate.rb

@@ -12,15 +12,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
   stroke_axis
-  
+
   fill_circle [250, 200], 2
-  
+
   12.times do |i|
-    
+
     rotate(i * 30, :origin => [250, 200]) do
-      
+
       stroke_rectangle [350, 225], 100, 50
       draw_text "Rotated #{i * 30}°", :size => 10, :at => [360, 205]
     end

data/manual/graphics/scale.rb

@@ -10,18 +10,18 @@ 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
   stroke_axis
-  
+
   width = 100
   height = 50
-  
+
   x = 50
   y = 200
 
   stroke_rectangle [x, y], width, height
   text_box "reference rectangle", :at => [x + 10, y - 10], :width => width - 20
-  
+
   scale(2, :origin => [x, y]) do
     stroke_rectangle [x, y], width, height
     text_box "rectangle scaled from upper-left corner",
@@ -32,7 +32,7 @@ Prawn::Example.generate(filename) do
 
   stroke_rectangle [x, y], width, height
   text_box "reference rectangle", :at => [x + 10, y - 10], :width => width - 20
-  
+
   scale(2, :origin => [x + width / 2, y - height / 2]) do
     stroke_rectangle [x, y], width, height
     text_box "rectangle scaled from center",

data/manual/graphics/soft_masks.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
   save_graphics_state do
     soft_mask do
       0.upto 15 do |i|

data/manual/graphics/stroke_cap.rb

@@ -16,14 +16,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
   stroke_axis
-  
+
   self.line_width = 25
 
   [:butt, :round, :projecting_square].each_with_index do |cap, i|
     self.cap_style = cap
-    
+
     y = 250 - i*100
     stroke_horizontal_line 100, 300, :at => y
     stroke_circle [400, y], 15

data/manual/graphics/stroke_dash.rb

@@ -17,7 +17,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
   stroke_axis
 
   dash([1, 2, 3, 2, 1, 5], :phase => 6)

data/manual/graphics/stroke_join.rb

@@ -11,14 +11,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
   stroke_axis
-  
+
   self.line_width = 25
-  
+
   [:miter, :round, :bevel].each_with_index do |style, i|
     self.join_style = style
-    
+
     y = 200 - i*100
     stroke do
       move_to(100, y)

data/manual/graphics/translate.rb

@@ -7,20 +7,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
   stroke_axis
-  
+
   1.upto(3) do |i|
-    
+
     x = i * 50
     y = i * 100
     translate(x, y) do
-      
+
       # Draw a point on the new origin
       fill_circle [0, 0], 2
       draw_text "New origin after translation to [#{x}, #{y}]",
                 :at => [5, -2], :size => 8
-      
+
       stroke_rectangle [100, 75], 100, 50
       text_box "Top left corner at [100,75]",
                 :at => [110, 65], :width => 80, :size => 8

data/manual/graphics/transparency.rb

@@ -12,24 +12,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
   stroke_axis
 
   self.line_width = 5
   fill_color "ff0000"
   fill_rectangle [0, 100], 500, 100
-  
+
   fill_color "000000"
   stroke_color "ffffff"
-  
+
   base_x = 100
   [[0.5, 1], 0.5, [1, 0.5]].each do |args|
-    
+
     transparent(*args) do
       fill_circle [base_x, 100], 50
       stroke_rectangle [base_x - 20, 100], 40, 80
     end
-    
+
     base_x += 150
   end
 end

data/manual/{manual/how_to_read_this_manual.rb → how_to_read_this_manual.rb}

@@ -1,40 +1,39 @@
 # encoding: utf-8
 #
-# Prawn manual how to read this manual page. 
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+# Prawn manual how to read this manual page.
+
+require_relative "example_helper"
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::Example.generate(filename) do
+Prawn::ManualBuilder::Example.generate(filename) do
   header("How to read this manual")
-  
+
   prose <<-END_TEXT
   This manual is a collection of examples categorized by theme and organized from the least to the most complex. While it covers most of the common use cases it is not a comprehensive guide.
-  
+
   The best way to read it depends on your previous knowledge of Prawn and what you need to accomplish.
-  
+
   If you are beginning with Prawn the first chapter will teach you the most basic concepts and how to create pdf documents. For an overview of the other features each chapter beyond the first either has a Basics section (which offer enough insight on the feature without showing all the advanced stuff you might never use) or is simple enough with only a few examples.
-  
+
   Once you understand the basics you might want to come back to this manual looking for examples that accomplish tasks you need.
-  
+
   Advanced users are encouraged to go beyond this manual and read the source code directly if any doubt is not directly covered on this manual.
   END_TEXT
-  
-  move_down(BOX_MARGIN)
+
+  move_down(Prawn::ManualBuilder::Example::BOX_MARGIN)
   header("Reading the examples")
-  
+
   prose <<-END_TEXT
   The title of each example is the relative path from the Prawn source manual/ folder.
-  
+
   The first body of text is the introductory text for the example. Generaly it is a short description of the features illustrated by the example.
-  
+
   Next comes the example source code block in fixed width font.
-  
+
   Most of the example snippets illustrate features that alter the page in place. The effect of these snippets is shown right below a dashed line. If it doesn't make sense to evaluate the snippet inline, a box with the link for the example file is shown instead.
 
   Note that the <code>stroke_axis</code> method, used occasionally in the manual, is not part of standard Prawn and is used for demonstrative purposes. It is defined in this file:
-  
+
   https://github.com/prawnpdf/prawn/blob/master/manual/example_helper.rb
   END_TEXT