prawn 1.0.0.rc1 → 1.0.0.rc2
Sign up to get free protection for your applications and to get access to all the features.
- data/Gemfile +18 -0
- data/README.md +5 -3
- data/Rakefile +8 -14
- data/data/pdfs/nested_pages.pdf +13 -13
- data/lib/prawn.rb +3 -1
- data/lib/prawn/compatibility.rb +46 -10
- data/lib/prawn/core.rb +3 -1
- data/lib/prawn/core/document_state.rb +2 -1
- data/lib/prawn/core/object_store.rb +61 -5
- data/lib/prawn/core/page.rb +3 -6
- data/lib/prawn/core/pdf_object.rb +21 -4
- data/lib/prawn/core/reference.rb +6 -2
- data/lib/prawn/core/text.rb +4 -4
- data/lib/prawn/core/text/formatted/line_wrap.rb +23 -8
- data/lib/prawn/document.rb +21 -15
- data/lib/prawn/document/bounding_box.rb +3 -3
- data/lib/prawn/document/column_box.rb +22 -4
- data/lib/prawn/document/snapshot.rb +1 -1
- data/lib/prawn/encoding.rb +1 -1
- data/lib/prawn/errors.rb +4 -0
- data/lib/prawn/font.rb +1 -1
- data/lib/prawn/font/afm.rb +30 -72
- data/lib/prawn/font/ttf.rb +6 -33
- data/lib/prawn/graphics.rb +148 -23
- data/lib/prawn/graphics/color.rb +8 -1
- data/lib/prawn/graphics/patterns.rb +137 -0
- data/lib/prawn/images.rb +25 -19
- data/lib/prawn/images/jpg.rb +4 -4
- data/lib/prawn/images/png.rb +18 -12
- data/lib/prawn/security.rb +6 -4
- data/lib/prawn/soft_mask.rb +94 -0
- data/lib/prawn/table.rb +136 -31
- data/lib/prawn/table/cell.rb +260 -29
- data/lib/prawn/table/cell/span_dummy.rb +88 -0
- data/lib/prawn/table/cell/text.rb +36 -14
- data/lib/prawn/table/cells.rb +91 -41
- data/lib/prawn/text.rb +3 -2
- data/lib/prawn/text/formatted/box.rb +14 -5
- data/lib/prawn/text/formatted/fragment.rb +33 -22
- data/lib/prawn/text/formatted/parser.rb +5 -2
- data/lib/prawn/utilities.rb +44 -0
- data/manual/basic_concepts/adding_pages.rb +27 -0
- data/manual/basic_concepts/basic_concepts.rb +34 -0
- data/manual/basic_concepts/creation.rb +39 -0
- data/manual/basic_concepts/cursor.rb +33 -0
- data/manual/basic_concepts/measurement.rb +25 -0
- data/manual/basic_concepts/origin.rb +38 -0
- data/manual/basic_concepts/other_cursor_helpers.rb +40 -0
- data/manual/bounding_box/bounding_box.rb +39 -0
- data/manual/bounding_box/bounds.rb +49 -0
- data/manual/bounding_box/canvas.rb +24 -0
- data/manual/bounding_box/creation.rb +23 -0
- data/manual/bounding_box/indentation.rb +46 -0
- data/manual/bounding_box/nesting.rb +45 -0
- data/manual/bounding_box/russian_boxes.rb +40 -0
- data/manual/bounding_box/stretchy.rb +31 -0
- data/manual/document_and_page_options/background.rb +27 -0
- data/manual/document_and_page_options/document_and_page_options.rb +31 -0
- data/manual/document_and_page_options/metadata.rb +23 -0
- data/manual/document_and_page_options/page_margins.rb +38 -0
- data/manual/document_and_page_options/page_size.rb +34 -0
- data/manual/example_file.rb +116 -0
- data/manual/example_helper.rb +430 -0
- data/manual/example_package.rb +53 -0
- data/manual/example_section.rb +46 -0
- data/manual/graphics/circle_and_ellipse.rb +22 -0
- data/manual/graphics/color.rb +24 -0
- data/manual/graphics/common_lines.rb +28 -0
- data/manual/graphics/fill_and_stroke.rb +42 -0
- data/manual/graphics/fill_rules.rb +37 -0
- data/manual/graphics/gradients.rb +37 -0
- data/manual/graphics/graphics.rb +58 -0
- data/manual/graphics/helper.rb +17 -0
- data/manual/graphics/line_width.rb +35 -0
- data/manual/graphics/lines_and_curves.rb +41 -0
- data/manual/graphics/polygon.rb +29 -0
- data/manual/graphics/rectangle.rb +21 -0
- data/manual/graphics/rotate.rb +28 -0
- data/manual/graphics/scale.rb +41 -0
- data/manual/graphics/soft_masks.rb +46 -0
- data/manual/graphics/stroke_cap.rb +31 -0
- data/manual/graphics/stroke_dash.rb +43 -0
- data/manual/graphics/stroke_join.rb +30 -0
- data/manual/graphics/translate.rb +29 -0
- data/manual/graphics/transparency.rb +35 -0
- data/manual/images/absolute_position.rb +23 -0
- data/manual/images/fit.rb +21 -0
- data/manual/images/horizontal.rb +25 -0
- data/manual/images/images.rb +40 -0
- data/manual/images/plain_image.rb +18 -0
- data/manual/images/scale.rb +22 -0
- data/manual/images/vertical.rb +28 -0
- data/manual/images/width_and_height.rb +25 -0
- data/manual/layout/boxes.rb +27 -0
- data/manual/layout/content.rb +25 -0
- data/manual/layout/layout.rb +28 -0
- data/manual/layout/simple_grid.rb +23 -0
- data/manual/manual/cover.rb +26 -0
- data/manual/manual/foreword.rb +13 -0
- data/manual/manual/how_to_read_this_manual.rb +41 -0
- data/manual/manual/manual.rb +36 -0
- data/manual/outline/add_subsection_to.rb +61 -0
- data/manual/outline/insert_section_after.rb +47 -0
- data/manual/outline/outline.rb +32 -0
- data/manual/outline/sections_and_pages.rb +67 -0
- data/manual/repeatable_content/page_numbering.rb +54 -0
- data/manual/repeatable_content/repeatable_content.rb +31 -0
- data/manual/repeatable_content/repeater.rb +55 -0
- data/manual/repeatable_content/stamp.rb +41 -0
- data/manual/security/encryption.rb +31 -0
- data/manual/security/permissions.rb +38 -0
- data/manual/security/security.rb +28 -0
- data/manual/syntax_highlight.rb +52 -0
- data/manual/table/basic_block.rb +53 -0
- data/manual/table/before_rendering_page.rb +26 -0
- data/manual/table/cell_border_lines.rb +24 -0
- data/manual/table/cell_borders_and_bg.rb +31 -0
- data/manual/table/cell_dimensions.rb +30 -0
- data/manual/table/cell_text.rb +38 -0
- data/manual/table/column_widths.rb +30 -0
- data/manual/table/content_and_subtables.rb +39 -0
- data/manual/table/creation.rb +27 -0
- data/manual/table/filtering.rb +36 -0
- data/manual/table/flow_and_header.rb +17 -0
- data/manual/table/image_cells.rb +33 -0
- data/manual/table/position.rb +29 -0
- data/manual/table/row_colors.rb +20 -0
- data/manual/table/span.rb +30 -0
- data/manual/table/style.rb +22 -0
- data/manual/table/table.rb +52 -0
- data/manual/table/width.rb +27 -0
- data/manual/templates/full_template.rb +23 -0
- data/manual/templates/page_template.rb +47 -0
- data/manual/templates/templates.rb +26 -0
- data/manual/text/alignment.rb +44 -0
- data/manual/text/color.rb +24 -0
- data/manual/text/column_box.rb +32 -0
- data/manual/text/fallback_fonts.rb +37 -0
- data/manual/text/font.rb +41 -0
- data/manual/text/font_size.rb +45 -0
- data/manual/text/font_style.rb +23 -0
- data/manual/text/formatted_callbacks.rb +60 -0
- data/manual/text/formatted_text.rb +50 -0
- data/manual/text/free_flowing_text.rb +51 -0
- data/manual/text/group.rb +29 -0
- data/manual/text/inline.rb +43 -0
- data/manual/text/kerning_and_character_spacing.rb +39 -0
- data/manual/text/leading.rb +25 -0
- data/manual/text/line_wrapping.rb +41 -0
- data/manual/text/paragraph_indentation.rb +26 -0
- data/manual/text/positioned_text.rb +38 -0
- data/manual/text/registering_families.rb +48 -0
- data/manual/text/rendering_and_color.rb +37 -0
- data/manual/text/right_to_left_text.rb +43 -0
- data/manual/text/rotation.rb +43 -0
- data/manual/text/single_usage.rb +37 -0
- data/manual/text/text.rb +75 -0
- data/manual/text/text_box_excess.rb +32 -0
- data/manual/text/text_box_extensions.rb +45 -0
- data/manual/text/text_box_overflow.rb +44 -0
- data/manual/text/utf8.rb +28 -0
- data/manual/text/win_ansi_charset.rb +59 -0
- data/prawn.gemspec +10 -7
- data/spec/bounding_box_spec.rb +107 -17
- data/spec/cell_spec.rb +66 -40
- data/spec/column_box_spec.rb +33 -0
- data/spec/document_spec.rb +45 -24
- data/spec/extensions/encoding_helpers.rb +6 -0
- data/spec/extensions/mocha.rb +1 -0
- data/spec/font_spec.rb +71 -53
- data/spec/formatted_text_arranger_spec.rb +19 -19
- data/spec/formatted_text_box_spec.rb +16 -16
- data/spec/formatted_text_fragment_spec.rb +6 -6
- data/spec/graphics_spec.rb +96 -31
- data/spec/grid_spec.rb +2 -2
- data/spec/images_spec.rb +18 -10
- data/spec/jpg_spec.rb +1 -1
- data/spec/line_wrap_spec.rb +14 -14
- data/spec/measurement_units_spec.rb +2 -2
- data/spec/name_tree_spec.rb +6 -6
- data/spec/object_store_spec.rb +17 -17
- data/spec/outline_spec.rb +35 -17
- data/spec/pdf_object_spec.rb +3 -1
- data/spec/png_spec.rb +22 -19
- data/spec/reference_spec.rb +24 -1
- data/spec/repeater_spec.rb +9 -9
- data/spec/security_spec.rb +3 -3
- data/spec/snapshot_spec.rb +3 -3
- data/spec/soft_mask_spec.rb +117 -0
- data/spec/span_spec.rb +4 -4
- data/spec/spec_helper.rb +12 -6
- data/spec/stamp_spec.rb +12 -12
- data/spec/stroke_styles_spec.rb +5 -5
- data/spec/table_spec.rb +458 -88
- data/spec/template_spec.rb +108 -54
- data/spec/text_at_spec.rb +17 -17
- data/spec/text_box_spec.rb +76 -45
- data/spec/text_rendering_mode_spec.rb +5 -5
- data/spec/text_spacing_spec.rb +4 -4
- data/spec/text_spec.rb +44 -40
- metadata +419 -250
- data/lib/prawn/graphics/gradient.rb +0 -84
- data/lib/prawn/security/arcfour.rb +0 -51
@@ -0,0 +1,430 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# Helper for organizing examples
|
4
|
+
#
|
5
|
+
|
6
|
+
$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
|
7
|
+
require 'prawn'
|
8
|
+
require 'prawn/security'
|
9
|
+
require 'prawn/layout'
|
10
|
+
|
11
|
+
require 'enumerator'
|
12
|
+
|
13
|
+
require File.expand_path(File.join(File.dirname(__FILE__), 'example_file'))
|
14
|
+
require File.expand_path(File.join(File.dirname(__FILE__), 'example_section'))
|
15
|
+
require File.expand_path(File.join(File.dirname(__FILE__), 'example_package'))
|
16
|
+
require File.expand_path(File.join(File.dirname(__FILE__), 'syntax_highlight'))
|
17
|
+
|
18
|
+
Prawn.debug = true
|
19
|
+
|
20
|
+
module Prawn
|
21
|
+
|
22
|
+
# The Prawn::Example class holds all the helper methods used to generate the
|
23
|
+
# Prawn by example manual.
|
24
|
+
#
|
25
|
+
# The overall structure is to have single example files grouped by package
|
26
|
+
# folders. Each package has a package builder file (with the same name as the
|
27
|
+
# package folder) that defines the inner structure of subsections and
|
28
|
+
# examples. The manual is then built by loading all the packages and some
|
29
|
+
# standalone pages.
|
30
|
+
#
|
31
|
+
# To see one of the examples check manual/basic_concepts/cursor.rb
|
32
|
+
#
|
33
|
+
# To see one of the package builders check
|
34
|
+
# manual/basic_concepts/basic_concepts.rb
|
35
|
+
#
|
36
|
+
# To see how the manual is built check manual/manual/manual.rb (Yes that's a
|
37
|
+
# whole load of manuals)
|
38
|
+
#
|
39
|
+
class Example < Prawn::Document
|
40
|
+
|
41
|
+
# Values used for the manual design:
|
42
|
+
|
43
|
+
# This is the default value for the margin box
|
44
|
+
#
|
45
|
+
BOX_MARGIN = 36
|
46
|
+
|
47
|
+
# Additional indentation to keep the line measure with a reasonable size
|
48
|
+
#
|
49
|
+
INNER_MARGIN = 30
|
50
|
+
|
51
|
+
# Vertical Rhythm settings
|
52
|
+
#
|
53
|
+
RHYTHM = 10
|
54
|
+
LEADING = 2
|
55
|
+
|
56
|
+
# Colors
|
57
|
+
#
|
58
|
+
BLACK = "000000"
|
59
|
+
LIGHT_GRAY = "F2F2F2"
|
60
|
+
GRAY = "DDDDDD"
|
61
|
+
DARK_GRAY = "333333"
|
62
|
+
BROWN = "A4441C"
|
63
|
+
ORANGE = "F28157"
|
64
|
+
LIGHT_GOLD = "FBFBBE"
|
65
|
+
DARK_GOLD = "EBE389"
|
66
|
+
BLUE = "0000D0"
|
67
|
+
|
68
|
+
# Used to generate the url for the example files
|
69
|
+
#
|
70
|
+
MANUAL_URL = "http://github.com/prawnpdf/prawn/tree/master/manual"
|
71
|
+
|
72
|
+
|
73
|
+
# Loads a package. Used on the manual.
|
74
|
+
#
|
75
|
+
def load_package(package)
|
76
|
+
load_file(package, package)
|
77
|
+
end
|
78
|
+
|
79
|
+
# Loads a page with outline support. Used on the manual.
|
80
|
+
#
|
81
|
+
def load_page(page)
|
82
|
+
load_file("manual", page)
|
83
|
+
|
84
|
+
outline.define do
|
85
|
+
section(page.gsub("_", " ").capitalize, :destination => page_number)
|
86
|
+
end
|
87
|
+
end
|
88
|
+
|
89
|
+
# Opens a file in a given package and evals the source
|
90
|
+
#
|
91
|
+
def load_file(package, file)
|
92
|
+
start_new_page
|
93
|
+
example = ExampleFile.new(package, "#{file}.rb")
|
94
|
+
eval example.generate_block_source
|
95
|
+
end
|
96
|
+
|
97
|
+
|
98
|
+
# Creates a new ExamplePackage object and yields it to a block in order for
|
99
|
+
# it to be populated with examples, sections and some introduction text.
|
100
|
+
# Used on the package files.
|
101
|
+
#
|
102
|
+
def package(package, &block)
|
103
|
+
ep = ExamplePackage.new(package)
|
104
|
+
ep.instance_eval(&block)
|
105
|
+
ep.render(self)
|
106
|
+
end
|
107
|
+
|
108
|
+
# Renders an ExamplePackage cover page.
|
109
|
+
#
|
110
|
+
# Starts a new page and renders the package introduction text.
|
111
|
+
#
|
112
|
+
def render_package_cover(package)
|
113
|
+
header(package.name)
|
114
|
+
instance_eval &(package.intro_block)
|
115
|
+
|
116
|
+
outline.define do
|
117
|
+
section(package.name, :destination => page_number, :closed => true)
|
118
|
+
end
|
119
|
+
end
|
120
|
+
|
121
|
+
# Add the ExampleSection to the document outline within the appropriate
|
122
|
+
# package.
|
123
|
+
#
|
124
|
+
def render_section(section)
|
125
|
+
outline.add_subsection_to(section.package_name) do
|
126
|
+
outline.section(section.name, :closed => true)
|
127
|
+
end
|
128
|
+
end
|
129
|
+
|
130
|
+
# Renders an ExampleFile.
|
131
|
+
#
|
132
|
+
# Starts a new page and renders an introductory text, the example source and
|
133
|
+
# evaluates the example source inline whenever that is appropriate according
|
134
|
+
# to the ExampleFile directives.
|
135
|
+
#
|
136
|
+
def render_example(example)
|
137
|
+
start_new_page
|
138
|
+
|
139
|
+
outline.add_subsection_to(example.parent_name) do
|
140
|
+
outline.page(:destination => page_number, :title => example.name)
|
141
|
+
end
|
142
|
+
|
143
|
+
example_header(example.parent_folder_name, example.filename)
|
144
|
+
|
145
|
+
prose(example.introduction_text)
|
146
|
+
|
147
|
+
code(example.source)
|
148
|
+
|
149
|
+
if example.eval?
|
150
|
+
eval_code(example.source)
|
151
|
+
else
|
152
|
+
source_link(example)
|
153
|
+
end
|
154
|
+
|
155
|
+
reset_settings
|
156
|
+
end
|
157
|
+
|
158
|
+
# Render the example header. Used on the example pages of the manual
|
159
|
+
#
|
160
|
+
def example_header(package, example)
|
161
|
+
header_box do
|
162
|
+
register_fonts
|
163
|
+
font('DejaVu', :size => 18) do
|
164
|
+
formatted_text([ { :text => package, :color => BROWN },
|
165
|
+
{ :text => "/", :color => BROWN },
|
166
|
+
{ :text => example, :color => ORANGE }
|
167
|
+
], :valign => :center)
|
168
|
+
end
|
169
|
+
end
|
170
|
+
end
|
171
|
+
|
172
|
+
# Register fonts used on the manual
|
173
|
+
#
|
174
|
+
def register_fonts
|
175
|
+
kai_file = "#{Prawn::DATADIR}/fonts/gkai00mp.ttf"
|
176
|
+
font_families["Kai"] = {
|
177
|
+
:normal => { :file => kai_file, :font => "Kai" }
|
178
|
+
}
|
179
|
+
|
180
|
+
dejavu_file = "#{Prawn::DATADIR}/fonts/DejaVuSans.ttf"
|
181
|
+
font_families["DejaVu"] = {
|
182
|
+
:normal => { :file => dejavu_file, :font => "DejaVu" }
|
183
|
+
}
|
184
|
+
end
|
185
|
+
|
186
|
+
# Render a block of text after processing code tags and URLs to be used with
|
187
|
+
# the inline_format option.
|
188
|
+
#
|
189
|
+
# Used on the introducory text for example pages of the manual and on
|
190
|
+
# package pages intro
|
191
|
+
#
|
192
|
+
def prose(str)
|
193
|
+
|
194
|
+
# Process the <code> tags
|
195
|
+
str.gsub!(/<code>([^<]+?)<\/code>/,
|
196
|
+
"<font name='Courier'><b>\\1<\/b><\/font>")
|
197
|
+
|
198
|
+
# Process the links
|
199
|
+
str.gsub!(/(https?:\/\/\S+)/,
|
200
|
+
"<color rgb='#{BLUE}'><link href=\"\\1\">\\1</link></color>")
|
201
|
+
|
202
|
+
inner_box do
|
203
|
+
font("Helvetica", :size => 11) do
|
204
|
+
str.split(/\n\n+/).each do |paragraph|
|
205
|
+
|
206
|
+
text(paragraph.gsub(/\s+/," "),
|
207
|
+
:align => :justify,
|
208
|
+
:inline_format => true,
|
209
|
+
:leading => LEADING,
|
210
|
+
:color => DARK_GRAY)
|
211
|
+
|
212
|
+
move_down(RHYTHM)
|
213
|
+
end
|
214
|
+
end
|
215
|
+
end
|
216
|
+
|
217
|
+
move_down(RHYTHM)
|
218
|
+
end
|
219
|
+
|
220
|
+
# Render a code block. Used on the example pages of the manual
|
221
|
+
#
|
222
|
+
def code(str)
|
223
|
+
pre_text = str.gsub(' ', Prawn::Text::NBSP)
|
224
|
+
pre_text = ::CodeRay.scan(pre_text, :ruby).to_prawn
|
225
|
+
|
226
|
+
font('Courier', :size => 9.5) do
|
227
|
+
colored_box(pre_text, :fill_color => DARK_GRAY)
|
228
|
+
end
|
229
|
+
end
|
230
|
+
|
231
|
+
# Renders a dashed line and evaluates the code inline
|
232
|
+
#
|
233
|
+
def eval_code(source)
|
234
|
+
move_down(RHYTHM)
|
235
|
+
|
236
|
+
dash(3)
|
237
|
+
stroke_color(BROWN)
|
238
|
+
stroke_horizontal_line(-BOX_MARGIN, bounds.width + BOX_MARGIN)
|
239
|
+
stroke_color(BLACK)
|
240
|
+
undash
|
241
|
+
|
242
|
+
move_down(RHYTHM*3)
|
243
|
+
begin
|
244
|
+
eval(source)
|
245
|
+
rescue => e
|
246
|
+
puts "Error evaluating example: #{e.message}"
|
247
|
+
puts
|
248
|
+
puts "---- Source: ----"
|
249
|
+
puts source
|
250
|
+
end
|
251
|
+
end
|
252
|
+
|
253
|
+
# Renders a box with the link for the example file
|
254
|
+
#
|
255
|
+
def source_link(example)
|
256
|
+
url = "#{MANUAL_URL}/#{example.parent_folder_name}/#{example.filename}"
|
257
|
+
|
258
|
+
reason = [{ :text => "This code snippet was not evaluated inline. " +
|
259
|
+
"You may see its output by running the " +
|
260
|
+
"example file located here:\n",
|
261
|
+
:color => DARK_GRAY },
|
262
|
+
|
263
|
+
{ :text => url,
|
264
|
+
:color => BLUE,
|
265
|
+
:link => url}
|
266
|
+
]
|
267
|
+
|
268
|
+
font('Helvetica', :size => 9) do
|
269
|
+
colored_box(reason,
|
270
|
+
:fill_color => LIGHT_GOLD,
|
271
|
+
:stroke_color => DARK_GOLD,
|
272
|
+
:leading => LEADING*3)
|
273
|
+
end
|
274
|
+
end
|
275
|
+
|
276
|
+
# Render a page header. Used on the manual lone pages and package
|
277
|
+
# introductory pages
|
278
|
+
#
|
279
|
+
def header(str)
|
280
|
+
header_box do
|
281
|
+
register_fonts
|
282
|
+
font('DejaVu', :size => 24) do
|
283
|
+
text(str, :color => BROWN, :valign => :center)
|
284
|
+
end
|
285
|
+
end
|
286
|
+
end
|
287
|
+
|
288
|
+
# Render the arguments as a bulleted list. Used on the manual package
|
289
|
+
# introductory pages
|
290
|
+
#
|
291
|
+
def list(*items)
|
292
|
+
move_up(RHYTHM)
|
293
|
+
|
294
|
+
inner_box do
|
295
|
+
font("Helvetica", :size => 11) do
|
296
|
+
items.each do |li|
|
297
|
+
float { text("•", :color => DARK_GRAY) }
|
298
|
+
indent(RHYTHM) do
|
299
|
+
text(li.gsub(/\s+/," "),
|
300
|
+
:inline_format => true,
|
301
|
+
:color => DARK_GRAY,
|
302
|
+
:leading => LEADING)
|
303
|
+
end
|
304
|
+
|
305
|
+
move_down(RHYTHM)
|
306
|
+
end
|
307
|
+
end
|
308
|
+
end
|
309
|
+
end
|
310
|
+
|
311
|
+
# Renders the page-wide headers
|
312
|
+
#
|
313
|
+
def header_box(&block)
|
314
|
+
bounding_box([-bounds.absolute_left, cursor + BOX_MARGIN],
|
315
|
+
:width => bounds.absolute_left + bounds.absolute_right,
|
316
|
+
:height => BOX_MARGIN*2 + RHYTHM*2) do
|
317
|
+
|
318
|
+
fill_color LIGHT_GRAY
|
319
|
+
fill_rectangle([bounds.left, bounds.top],
|
320
|
+
bounds.right,
|
321
|
+
bounds.top - bounds.bottom)
|
322
|
+
fill_color BLACK
|
323
|
+
|
324
|
+
indent(BOX_MARGIN + INNER_MARGIN, &block)
|
325
|
+
end
|
326
|
+
|
327
|
+
stroke_color GRAY
|
328
|
+
stroke_horizontal_line(-BOX_MARGIN, bounds.width + BOX_MARGIN, :at => cursor)
|
329
|
+
stroke_color BLACK
|
330
|
+
|
331
|
+
move_down(RHYTHM*3)
|
332
|
+
end
|
333
|
+
|
334
|
+
# Renders a Bounding Box for the inner margin
|
335
|
+
#
|
336
|
+
def inner_box(&block)
|
337
|
+
bounding_box([INNER_MARGIN, cursor],
|
338
|
+
:width => bounds.width - INNER_MARGIN*2,
|
339
|
+
&block)
|
340
|
+
end
|
341
|
+
|
342
|
+
# Renders a Bounding Box with some background color and the formatted text
|
343
|
+
# inside it
|
344
|
+
#
|
345
|
+
def colored_box(box_text, options={})
|
346
|
+
options = { :fill_color => DARK_GRAY,
|
347
|
+
:stroke_color => nil,
|
348
|
+
:text_color => LIGHT_GRAY,
|
349
|
+
:leading => LEADING
|
350
|
+
}.merge(options)
|
351
|
+
|
352
|
+
register_fonts
|
353
|
+
text_options = { :leading => options[:leading],
|
354
|
+
:fallback_fonts => ["DejaVu", "Kai"]
|
355
|
+
}
|
356
|
+
|
357
|
+
box_height = height_of_formatted(box_text, text_options)
|
358
|
+
|
359
|
+
bounding_box([INNER_MARGIN + RHYTHM, cursor],
|
360
|
+
:width => bounds.width - (INNER_MARGIN+RHYTHM)*2) do
|
361
|
+
|
362
|
+
fill_color options[:fill_color]
|
363
|
+
stroke_color options[:stroke_color] || options[:fill_color]
|
364
|
+
fill_and_stroke_rounded_rectangle(
|
365
|
+
[bounds.left - RHYTHM, cursor],
|
366
|
+
bounds.left + bounds.right + RHYTHM*2,
|
367
|
+
box_height + RHYTHM*2,
|
368
|
+
5
|
369
|
+
)
|
370
|
+
fill_color BLACK
|
371
|
+
stroke_color BLACK
|
372
|
+
|
373
|
+
pad(RHYTHM) do
|
374
|
+
formatted_text(box_text, text_options)
|
375
|
+
end
|
376
|
+
end
|
377
|
+
|
378
|
+
move_down(RHYTHM*2)
|
379
|
+
end
|
380
|
+
|
381
|
+
# Draws X and Y axis rulers beginning at the margin box origin. Used on
|
382
|
+
# examples.
|
383
|
+
#
|
384
|
+
def stroke_axis(options={})
|
385
|
+
options = { :height => (cursor - 20).to_i,
|
386
|
+
:width => bounds.width.to_i
|
387
|
+
}.merge(options)
|
388
|
+
|
389
|
+
dash(1, :space => 4)
|
390
|
+
stroke_horizontal_line(-21, options[:width], :at => 0)
|
391
|
+
stroke_vertical_line(-21, options[:height], :at => 0)
|
392
|
+
undash
|
393
|
+
|
394
|
+
fill_circle [0, 0], 1
|
395
|
+
|
396
|
+
(100..options[:width]).step(100) do |point|
|
397
|
+
fill_circle [point, 0], 1
|
398
|
+
draw_text point, :at => [point-5, -10], :size => 7
|
399
|
+
end
|
400
|
+
|
401
|
+
(100..options[:height]).step(100) do |point|
|
402
|
+
fill_circle [0, point], 1
|
403
|
+
draw_text point, :at => [-17, point-2], :size => 7
|
404
|
+
end
|
405
|
+
end
|
406
|
+
|
407
|
+
# Reset some of the Prawn settings including graphics and text to their
|
408
|
+
# defaults.
|
409
|
+
#
|
410
|
+
# Used after rendering examples so that each new example starts with a clean
|
411
|
+
# slate.
|
412
|
+
#
|
413
|
+
def reset_settings
|
414
|
+
|
415
|
+
# Text settings
|
416
|
+
font("Helvetica", :size => 12)
|
417
|
+
default_leading 0
|
418
|
+
self.text_direction = :ltr
|
419
|
+
|
420
|
+
# Graphics settings
|
421
|
+
self.line_width = 1
|
422
|
+
self.cap_style = :butt
|
423
|
+
self.join_style = :miter
|
424
|
+
undash
|
425
|
+
fill_color BLACK
|
426
|
+
stroke_color BLACK
|
427
|
+
end
|
428
|
+
|
429
|
+
end
|
430
|
+
end
|
@@ -0,0 +1,53 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
|
3
|
+
module Prawn
|
4
|
+
|
5
|
+
# The Prawn::ExamplePackage class is a utility class to handle the packaging
|
6
|
+
# of individual examples within a hierarchy when building the manual
|
7
|
+
#
|
8
|
+
class ExamplePackage
|
9
|
+
attr_reader :intro_block, :folder_name
|
10
|
+
|
11
|
+
def initialize(folder_name)
|
12
|
+
@folder_name = folder_name
|
13
|
+
@hierarchy = []
|
14
|
+
end
|
15
|
+
|
16
|
+
# Stores a new ExampleSection in the hierarchy and yields it to a block
|
17
|
+
#
|
18
|
+
def section(name)
|
19
|
+
s = ExampleSection.new(self, name)
|
20
|
+
yield s
|
21
|
+
@hierarchy << s
|
22
|
+
end
|
23
|
+
|
24
|
+
# Stores a new ExampleFile in the hierarchy
|
25
|
+
#
|
26
|
+
def example(filename, options={})
|
27
|
+
@hierarchy << ExampleFile.new(self, "#{filename}.rb", options)
|
28
|
+
end
|
29
|
+
|
30
|
+
# Stores a block with code to be evaluated when rendering the package cover
|
31
|
+
#
|
32
|
+
def intro(&block)
|
33
|
+
@intro_block = block
|
34
|
+
end
|
35
|
+
|
36
|
+
# Returns a human friendly version of the package name
|
37
|
+
#
|
38
|
+
def name
|
39
|
+
@name ||= @folder_name.gsub("_", " ").capitalize
|
40
|
+
end
|
41
|
+
|
42
|
+
# Renders a cover page for the package to a pdf and iterates the examples
|
43
|
+
# hierarchy delegating the examples and sections to be rendered as well
|
44
|
+
#
|
45
|
+
def render(pdf)
|
46
|
+
pdf.render_package_cover(self)
|
47
|
+
|
48
|
+
@hierarchy.each do |node|
|
49
|
+
node.render(pdf)
|
50
|
+
end
|
51
|
+
end
|
52
|
+
end
|
53
|
+
end
|