prawn-git 2.0.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (252) hide show
  1. checksums.yaml +7 -0
  2. data/.yardopts +10 -0
  3. data/COPYING +2 -0
  4. data/GPLv2 +340 -0
  5. data/GPLv3 +674 -0
  6. data/Gemfile +11 -0
  7. data/LICENSE +56 -0
  8. data/Rakefile +55 -0
  9. data/data/fonts/Courier-Bold.afm +342 -0
  10. data/data/fonts/Courier-BoldOblique.afm +342 -0
  11. data/data/fonts/Courier-Oblique.afm +342 -0
  12. data/data/fonts/Courier.afm +342 -0
  13. data/data/fonts/Helvetica-Bold.afm +2827 -0
  14. data/data/fonts/Helvetica-BoldOblique.afm +2827 -0
  15. data/data/fonts/Helvetica-Oblique.afm +3051 -0
  16. data/data/fonts/Helvetica.afm +3051 -0
  17. data/data/fonts/MustRead.html +19 -0
  18. data/data/fonts/Symbol.afm +213 -0
  19. data/data/fonts/Times-Bold.afm +2588 -0
  20. data/data/fonts/Times-BoldItalic.afm +2384 -0
  21. data/data/fonts/Times-Italic.afm +2667 -0
  22. data/data/fonts/Times-Roman.afm +2419 -0
  23. data/data/fonts/ZapfDingbats.afm +225 -0
  24. data/data/images/16bit.alpha +0 -0
  25. data/data/images/16bit.color +0 -0
  26. data/data/images/16bit.png +0 -0
  27. data/data/images/arrow.png +0 -0
  28. data/data/images/arrow2.png +0 -0
  29. data/data/images/dice.alpha +0 -0
  30. data/data/images/dice.color +0 -0
  31. data/data/images/dice.png +0 -0
  32. data/data/images/dice_interlaced.png +0 -0
  33. data/data/images/fractal.jpg +0 -0
  34. data/data/images/indexed_color.dat +0 -0
  35. data/data/images/indexed_color.png +0 -0
  36. data/data/images/letterhead.jpg +0 -0
  37. data/data/images/license.md +8 -0
  38. data/data/images/page_white_text.alpha +0 -0
  39. data/data/images/page_white_text.color +0 -0
  40. data/data/images/page_white_text.png +0 -0
  41. data/data/images/pal_bk.png +0 -0
  42. data/data/images/pigs.jpg +0 -0
  43. data/data/images/prawn.png +0 -0
  44. data/data/images/ruport.png +0 -0
  45. data/data/images/ruport_data.dat +0 -0
  46. data/data/images/ruport_transparent.png +0 -0
  47. data/data/images/ruport_type0.png +0 -0
  48. data/data/images/stef.jpg +0 -0
  49. data/data/images/tru256.bmp +0 -0
  50. data/data/images/web-links.dat +1 -0
  51. data/data/images/web-links.png +0 -0
  52. data/data/pdfs/complex_template.pdf +0 -0
  53. data/data/pdfs/contains_ttf_font.pdf +0 -0
  54. data/data/pdfs/encrypted.pdf +0 -0
  55. data/data/pdfs/form.pdf +820 -0
  56. data/data/pdfs/hexagon.pdf +61 -0
  57. data/data/pdfs/indirect_reference.pdf +86 -0
  58. data/data/pdfs/multipage_template.pdf +127 -0
  59. data/data/pdfs/nested_pages.pdf +118 -0
  60. data/data/pdfs/page_without_mediabox.pdf +193 -0
  61. data/data/pdfs/resources_as_indirect_object.pdf +83 -0
  62. data/data/pdfs/two_hexagons.pdf +90 -0
  63. data/data/pdfs/version_1_6.pdf +61 -0
  64. data/data/shift_jis_text.txt +1 -0
  65. data/lib/prawn.rb +89 -0
  66. data/lib/prawn/document.rb +706 -0
  67. data/lib/prawn/document/bounding_box.rb +539 -0
  68. data/lib/prawn/document/column_box.rb +144 -0
  69. data/lib/prawn/document/internals.rb +58 -0
  70. data/lib/prawn/document/span.rb +57 -0
  71. data/lib/prawn/encoding.rb +87 -0
  72. data/lib/prawn/errors.rb +80 -0
  73. data/lib/prawn/font.rb +413 -0
  74. data/lib/prawn/font/afm.rb +256 -0
  75. data/lib/prawn/font/dfont.rb +43 -0
  76. data/lib/prawn/font/ttf.rb +355 -0
  77. data/lib/prawn/font_metric_cache.rb +46 -0
  78. data/lib/prawn/graphics.rb +646 -0
  79. data/lib/prawn/graphics/cap_style.rb +47 -0
  80. data/lib/prawn/graphics/color.rb +232 -0
  81. data/lib/prawn/graphics/dash.rb +109 -0
  82. data/lib/prawn/graphics/join_style.rb +49 -0
  83. data/lib/prawn/graphics/patterns.rb +126 -0
  84. data/lib/prawn/graphics/transformation.rb +157 -0
  85. data/lib/prawn/graphics/transparency.rb +101 -0
  86. data/lib/prawn/grid.rb +279 -0
  87. data/lib/prawn/image_handler.rb +44 -0
  88. data/lib/prawn/images.rb +199 -0
  89. data/lib/prawn/images/image.rb +49 -0
  90. data/lib/prawn/images/jpg.rb +91 -0
  91. data/lib/prawn/images/png.rb +290 -0
  92. data/lib/prawn/measurement_extensions.rb +50 -0
  93. data/lib/prawn/measurements.rb +77 -0
  94. data/lib/prawn/outline.rb +289 -0
  95. data/lib/prawn/repeater.rb +124 -0
  96. data/lib/prawn/security.rb +288 -0
  97. data/lib/prawn/security/arcfour.rb +54 -0
  98. data/lib/prawn/soft_mask.rb +94 -0
  99. data/lib/prawn/stamp.rb +136 -0
  100. data/lib/prawn/text.rb +437 -0
  101. data/lib/prawn/text/box.rb +141 -0
  102. data/lib/prawn/text/formatted.rb +7 -0
  103. data/lib/prawn/text/formatted/arranger.rb +290 -0
  104. data/lib/prawn/text/formatted/box.rb +614 -0
  105. data/lib/prawn/text/formatted/fragment.rb +264 -0
  106. data/lib/prawn/text/formatted/line_wrap.rb +277 -0
  107. data/lib/prawn/text/formatted/parser.rb +224 -0
  108. data/lib/prawn/text/formatted/wrap.rb +160 -0
  109. data/lib/prawn/utilities.rb +46 -0
  110. data/lib/prawn/version.rb +5 -0
  111. data/lib/prawn/view.rb +91 -0
  112. data/manual/absolute_position.pdf +0 -0
  113. data/manual/basic_concepts/adding_pages.rb +27 -0
  114. data/manual/basic_concepts/basic_concepts.rb +36 -0
  115. data/manual/basic_concepts/creation.rb +39 -0
  116. data/manual/basic_concepts/cursor.rb +33 -0
  117. data/manual/basic_concepts/measurement.rb +25 -0
  118. data/manual/basic_concepts/origin.rb +38 -0
  119. data/manual/basic_concepts/other_cursor_helpers.rb +40 -0
  120. data/manual/basic_concepts/view.rb +42 -0
  121. data/manual/bounding_box/bounding_box.rb +39 -0
  122. data/manual/bounding_box/bounds.rb +49 -0
  123. data/manual/bounding_box/canvas.rb +24 -0
  124. data/manual/bounding_box/creation.rb +23 -0
  125. data/manual/bounding_box/indentation.rb +46 -0
  126. data/manual/bounding_box/nesting.rb +45 -0
  127. data/manual/bounding_box/russian_boxes.rb +40 -0
  128. data/manual/bounding_box/stretchy.rb +31 -0
  129. data/manual/contents.rb +29 -0
  130. data/manual/cover.rb +39 -0
  131. data/manual/document_and_page_options/background.rb +27 -0
  132. data/manual/document_and_page_options/document_and_page_options.rb +32 -0
  133. data/manual/document_and_page_options/metadata.rb +23 -0
  134. data/manual/document_and_page_options/page_margins.rb +38 -0
  135. data/manual/document_and_page_options/page_size.rb +34 -0
  136. data/manual/document_and_page_options/print_scaling.rb +20 -0
  137. data/manual/example_helper.rb +7 -0
  138. data/manual/graphics/circle_and_ellipse.rb +22 -0
  139. data/manual/graphics/color.rb +24 -0
  140. data/manual/graphics/common_lines.rb +30 -0
  141. data/manual/graphics/fill_and_stroke.rb +42 -0
  142. data/manual/graphics/fill_rules.rb +37 -0
  143. data/manual/graphics/gradients.rb +37 -0
  144. data/manual/graphics/graphics.rb +58 -0
  145. data/manual/graphics/helper.rb +24 -0
  146. data/manual/graphics/line_width.rb +35 -0
  147. data/manual/graphics/lines_and_curves.rb +41 -0
  148. data/manual/graphics/polygon.rb +29 -0
  149. data/manual/graphics/rectangle.rb +21 -0
  150. data/manual/graphics/rotate.rb +28 -0
  151. data/manual/graphics/scale.rb +41 -0
  152. data/manual/graphics/soft_masks.rb +46 -0
  153. data/manual/graphics/stroke_cap.rb +31 -0
  154. data/manual/graphics/stroke_dash.rb +48 -0
  155. data/manual/graphics/stroke_join.rb +30 -0
  156. data/manual/graphics/translate.rb +29 -0
  157. data/manual/graphics/transparency.rb +35 -0
  158. data/manual/how_to_read_this_manual.rb +40 -0
  159. data/manual/images/absolute_position.rb +23 -0
  160. data/manual/images/fit.rb +21 -0
  161. data/manual/images/horizontal.rb +25 -0
  162. data/manual/images/images.rb +40 -0
  163. data/manual/images/plain_image.rb +18 -0
  164. data/manual/images/scale.rb +22 -0
  165. data/manual/images/vertical.rb +28 -0
  166. data/manual/images/width_and_height.rb +25 -0
  167. data/manual/layout/boxes.rb +27 -0
  168. data/manual/layout/content.rb +25 -0
  169. data/manual/layout/layout.rb +28 -0
  170. data/manual/layout/simple_grid.rb +23 -0
  171. data/manual/outline/add_subsection_to.rb +61 -0
  172. data/manual/outline/insert_section_after.rb +47 -0
  173. data/manual/outline/outline.rb +32 -0
  174. data/manual/outline/sections_and_pages.rb +67 -0
  175. data/manual/repeatable_content/alternate_page_numbering.rb +32 -0
  176. data/manual/repeatable_content/page_numbering.rb +54 -0
  177. data/manual/repeatable_content/repeatable_content.rb +32 -0
  178. data/manual/repeatable_content/repeater.rb +55 -0
  179. data/manual/repeatable_content/stamp.rb +41 -0
  180. data/manual/security/encryption.rb +31 -0
  181. data/manual/security/permissions.rb +38 -0
  182. data/manual/security/security.rb +28 -0
  183. data/manual/table.rb +16 -0
  184. data/manual/text/alignment.rb +44 -0
  185. data/manual/text/color.rb +24 -0
  186. data/manual/text/column_box.rb +32 -0
  187. data/manual/text/fallback_fonts.rb +37 -0
  188. data/manual/text/font.rb +41 -0
  189. data/manual/text/font_size.rb +45 -0
  190. data/manual/text/font_style.rb +23 -0
  191. data/manual/text/formatted_callbacks.rb +60 -0
  192. data/manual/text/formatted_text.rb +50 -0
  193. data/manual/text/free_flowing_text.rb +51 -0
  194. data/manual/text/inline.rb +41 -0
  195. data/manual/text/kerning_and_character_spacing.rb +39 -0
  196. data/manual/text/leading.rb +25 -0
  197. data/manual/text/line_wrapping.rb +41 -0
  198. data/manual/text/paragraph_indentation.rb +34 -0
  199. data/manual/text/positioned_text.rb +38 -0
  200. data/manual/text/registering_families.rb +48 -0
  201. data/manual/text/rendering_and_color.rb +37 -0
  202. data/manual/text/right_to_left_text.rb +47 -0
  203. data/manual/text/rotation.rb +43 -0
  204. data/manual/text/single_usage.rb +37 -0
  205. data/manual/text/text.rb +73 -0
  206. data/manual/text/text_box_excess.rb +32 -0
  207. data/manual/text/text_box_extensions.rb +45 -0
  208. data/manual/text/text_box_overflow.rb +48 -0
  209. data/manual/text/utf8.rb +28 -0
  210. data/manual/text/win_ansi_charset.rb +60 -0
  211. data/prawn.gemspec +45 -0
  212. data/spec/acceptance/png.rb +25 -0
  213. data/spec/annotations_spec.rb +74 -0
  214. data/spec/bounding_box_spec.rb +510 -0
  215. data/spec/column_box_spec.rb +65 -0
  216. data/spec/data/curves.pdf +66 -0
  217. data/spec/destinations_spec.rb +15 -0
  218. data/spec/document_spec.rb +748 -0
  219. data/spec/extensions/encoding_helpers.rb +11 -0
  220. data/spec/extensions/mocha.rb +46 -0
  221. data/spec/font_metric_cache_spec.rb +52 -0
  222. data/spec/font_spec.rb +474 -0
  223. data/spec/formatted_text_arranger_spec.rb +421 -0
  224. data/spec/formatted_text_box_spec.rb +705 -0
  225. data/spec/formatted_text_fragment_spec.rb +298 -0
  226. data/spec/graphics_spec.rb +683 -0
  227. data/spec/grid_spec.rb +96 -0
  228. data/spec/image_handler_spec.rb +54 -0
  229. data/spec/images_spec.rb +153 -0
  230. data/spec/inline_formatted_text_parser_spec.rb +564 -0
  231. data/spec/jpg_spec.rb +25 -0
  232. data/spec/line_wrap_spec.rb +367 -0
  233. data/spec/measurement_units_spec.rb +25 -0
  234. data/spec/outline_spec.rb +430 -0
  235. data/spec/png_spec.rb +245 -0
  236. data/spec/reference_spec.rb +25 -0
  237. data/spec/repeater_spec.rb +160 -0
  238. data/spec/security_spec.rb +158 -0
  239. data/spec/soft_mask_spec.rb +79 -0
  240. data/spec/span_spec.rb +44 -0
  241. data/spec/spec_helper.rb +54 -0
  242. data/spec/stamp_spec.rb +160 -0
  243. data/spec/stroke_styles_spec.rb +211 -0
  244. data/spec/text_at_spec.rb +143 -0
  245. data/spec/text_box_spec.rb +1043 -0
  246. data/spec/text_rendering_mode_spec.rb +45 -0
  247. data/spec/text_spacing_spec.rb +93 -0
  248. data/spec/text_spec.rb +557 -0
  249. data/spec/text_with_inline_formatting_spec.rb +35 -0
  250. data/spec/transparency_spec.rb +91 -0
  251. data/spec/view_spec.rb +43 -0
  252. metadata +509 -0
@@ -0,0 +1,50 @@
1
+ # encoding: utf-8
2
+ #
3
+ # There are two other text methods available: <code>formatted_text</code> and
4
+ # <code>formatted_text_box</code>.
5
+ #
6
+ # These are useful when the provided text has numerous portions that need to be
7
+ # formatted differently. As you might imply from their names the first should
8
+ # be used for free flowing text just like the <code>text</code> method and the
9
+ # last should be used for positioned text just like <code>text_box</code>.
10
+ #
11
+ # The main difference between these methods and the <code>text</code> and
12
+ # <code>text_box</code> methods is how the text is provided. The
13
+ # <code>formatted_text</code> and <code>formatted_text_box</code> methods accept
14
+ # an array of hashes. Each hash must provide a <code>:text</code> option which
15
+ # is the text string and may provide the following options: <code>:styles</code>
16
+ # (an array of symbols), <code>:size</code> (the font size),
17
+ # <code>:character_spacing</code> (additional space between the characters),
18
+ # <code>:font</code> (the name of a registered font), <code>:color</code> (the
19
+ # same input accepted by <code>fill_color</code> and <code>stroke_color</code>),
20
+ # <code>:link</code> (an URL to create a link), and <code>:local</code>
21
+ # (a link to a local file).
22
+
23
+ require File.expand_path(File.join(File.dirname(__FILE__),
24
+ %w[.. example_helper]))
25
+
26
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
27
+ Prawn::ManualBuilder::Example.generate(filename) do
28
+ formatted_text [ { :text => "Some bold. ", :styles => [:bold] },
29
+ { :text => "Some italic. ", :styles => [:italic] },
30
+ { :text => "Bold italic. ", :styles => [:bold, :italic] },
31
+ { :text => "Bigger Text. ", :size => 20 },
32
+ { :text => "More spacing. ", :character_spacing => 3 },
33
+ { :text => "Different Font. ", :font => "Courier" },
34
+ { :text => "Some coloring. ", :color => "FF00FF" },
35
+ { :text => "Link to the wiki. ",
36
+ :color => "0000FF",
37
+ :link => "https://github.com/prawnpdf/prawn/wiki" },
38
+ { :text => "Link to a local file. ",
39
+ :color => "0000FF",
40
+ :local => "./local_file.txt" }
41
+ ]
42
+
43
+ formatted_text_box [ { :text => "Just your regular" },
44
+ { :text => " text_box ", :font => "Courier" },
45
+ { :text => "with some additional formatting options " +
46
+ "added to the mix.",
47
+ :color => [50, 100, 0, 0],
48
+ :styles => [:italic] }
49
+ ], :at => [100, 100], :width => 200, :height => 100
50
+ end
@@ -0,0 +1,51 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Text rendering can be as simple or as complex as you want.
4
+ #
5
+ # This example covers the most basic method: <code>text</code>. It is meant for
6
+ # free flowing text. The provided string will flow according to the current
7
+ # bounding box width and height. It will also flow onto the next page if the
8
+ # bottom of the bounding box is reached.
9
+ #
10
+ # The text will start being rendered on the current cursor position. When it
11
+ # finishes rendering, the cursor is left directly below the text.
12
+ #
13
+ # This example also shows text flowing across pages following the margin box and
14
+ # other bounding boxes.
15
+ #
16
+ require File.expand_path(File.join(File.dirname(__FILE__),
17
+ %w[.. example_helper]))
18
+
19
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
20
+ Prawn::ManualBuilder::Example.generate(filename) do
21
+ move_cursor_to 50
22
+ text "This text will flow to the next page. " * 20
23
+
24
+ y_position = cursor - 50
25
+ bounding_box([0, y_position], :width => 200, :height => 150) do
26
+ transparent(0.5) { stroke_bounds }
27
+ text "This text will flow along this bounding box we created for it. " * 5
28
+ end
29
+
30
+ bounding_box([300, y_position], :width => 200, :height => 150) do
31
+ transparent(0.5) { stroke_bounds } # This will stroke on one page
32
+
33
+ text "Now look what happens when the free flowing text reaches the end " +
34
+ "of a bounding box that is narrower than the margin box." +
35
+ " . " * 200 +
36
+ "It continues on the next page as if the previous bounding box " +
37
+ "was cloned. If we want it to have the same border as the one on " +
38
+ "the previous page we will need to stroke the boundaries again."
39
+
40
+ transparent(0.5) { stroke_bounds } # And this will stroke on the next
41
+ end
42
+
43
+ move_cursor_to 200
44
+ span(350, :position => :center) do
45
+ text "Span is a different kind of bounding box as it lets the text " +
46
+ "flow gracefully onto the next page. It doesn't matter if the text " +
47
+ "started on the middle of the previous page, when it flows to the " +
48
+ "next page it will start at the beginning." + " _ " * 500 +
49
+ "I told you it would start on the beginning of this page."
50
+ end
51
+ end
@@ -0,0 +1,41 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Inline formatting gives you the option to format specific portions of a text.
4
+ # It uses HTML-esque syntax inside the text string. Supported tags are:
5
+ # <code>b</code> (bold), <code>i</code> (italic), <code>u</code> (underline),
6
+ # <code>strikethrough</code>, <code>sub</code> (subscript), <code>sup</code>
7
+ # (superscript)
8
+ #
9
+ # The following tags accept specific attributes: <code>font</code> accepts
10
+ # <code>size</code>, <code>name</code>, and <code>character_spacing</code>;
11
+ # <code>color</code> accepts <code>rgb</code> and <code>cmyk</code>;
12
+ # <code>link</code> accepts <code>href</code> for external links.
13
+ #
14
+ require File.expand_path(File.join(File.dirname(__FILE__),
15
+ %w[.. example_helper]))
16
+
17
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
18
+ Prawn::ManualBuilder::Example.generate(filename) do
19
+ %w[b i u strikethrough sub sup].each do |tag|
20
+ text "Just your regular text <#{tag}>except this portion</#{tag}> " +
21
+ "is using the #{tag} tag",
22
+ :inline_format => true
23
+ move_down 10
24
+ end
25
+
26
+ text "This <font size='18'>line</font> uses " +
27
+ "<font name='Courier'>all the font tag</font> attributes in " +
28
+ "<font character_spacing='2'>a single line</font>. ",
29
+ :inline_format => true
30
+ move_down 10
31
+
32
+ text "Coloring in <color rgb='FF00FF'>both RGB</color> " +
33
+ "<color c='100' m='0' y='0' k='0'>and CMYK</color>",
34
+ :inline_format => true
35
+ move_down 10
36
+
37
+ text "This an external link to the " +
38
+ "<u><link href='https://github.com/prawnpdf/prawn/wiki'>Prawn wiki" +
39
+ "</link></u>",
40
+ :inline_format => true
41
+ end
@@ -0,0 +1,39 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Kerning is the process of adjusting the spacing between characters in a
4
+ # proportional font. It is usually done with specific letter pairs. We can
5
+ # switch it on and off if it is available with the current font. Just pass a
6
+ # boolean value to the <code>:kerning</code> option of the text methods.
7
+ #
8
+ # Character Spacing is the space between characters. It can be increased or
9
+ # decreased and will have effect on the whole text. Just pass a number to the
10
+ # <code>:character_spacing</code> option from the text methods.
11
+ #
12
+ require File.expand_path(File.join(File.dirname(__FILE__),
13
+ %w[.. example_helper]))
14
+
15
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
16
+ Prawn::ManualBuilder::Example.generate(filename) do
17
+ font_size(30) do
18
+ text_box "With kerning:", :kerning => true, :at => [0, y - 40]
19
+ text_box "Without kerning:", :kerning => false, :at => [0, y - 80]
20
+
21
+ text_box "Tomato", :kerning => true, :at => [250, y - 40]
22
+ text_box "Tomato", :kerning => false, :at => [250, y - 80]
23
+
24
+ text_box "WAR", :kerning => true, :at => [400, y - 40]
25
+ text_box "WAR", :kerning => false, :at => [400, y - 80]
26
+
27
+ text_box "F.", :kerning => true, :at => [500, y - 40]
28
+ text_box "F.", :kerning => false, :at => [500, y - 80]
29
+ end
30
+
31
+ move_down 80
32
+
33
+ string = "What have you done to the space between the characters?"
34
+ [-2, -1, 0, 0.5, 1, 2].each do |spacing|
35
+ move_down 20
36
+ text "#{string} (character_spacing: #{spacing})",
37
+ :character_spacing => spacing
38
+ end
39
+ end
@@ -0,0 +1,25 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Leading is the additional space between lines of text.
4
+ #
5
+ # The leading can be set using the <code>default_leading</code> method which
6
+ # applies to the rest of the document or until it is changed, or inline in the
7
+ # text methods with the <code>:leading</code> option.
8
+ #
9
+ # The default leading is <code>0</code>.
10
+ #
11
+ require File.expand_path(File.join(File.dirname(__FILE__),
12
+ %w[.. example_helper]))
13
+
14
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
15
+ Prawn::ManualBuilder::Example.generate(filename) do
16
+ string = "Hey, what did you do with the space between my lines? " * 10
17
+ text string, :leading => 0
18
+
19
+ move_down 20
20
+ default_leading 5
21
+ text string
22
+
23
+ move_down 20
24
+ text string, :leading => 10
25
+ end
@@ -0,0 +1,41 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Line wrapping happens on white space or hyphens. Soft hyphens can be used to
4
+ # indicate where words can be hyphenated. Non-breaking spaces can be used to
5
+ # display space without allowing for a break.
6
+ #
7
+ # For writing styles that do not make use of spaces, the zero width space serves
8
+ # to mark word boundaries. Zero width spaces are available only with TTF fonts.
9
+ #
10
+ require File.expand_path(File.join(File.dirname(__FILE__),
11
+ %w[.. example_helper]))
12
+
13
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
14
+ Prawn::ManualBuilder::Example.generate(filename) do
15
+ text "Hard hyphens:\n" +
16
+ "Slip-sliding away, slip sliding awaaaay. You know the " +
17
+ "nearer your destination the more you're slip-sliding away."
18
+ move_down 20
19
+
20
+ shy = Prawn::Text::SHY
21
+ text "Soft hyphens:\n" +
22
+ "Slip slid#{shy}ing away, slip slid#{shy}ing away. You know the " +
23
+ "nearer your destinat#{shy}ion the more you're slip slid#{shy}ing away."
24
+ move_down 20
25
+
26
+ nbsp = Prawn::Text::NBSP
27
+ text "Non-breaking spaces:\n" +
28
+ "Slip#{nbsp}sliding away, slip#{nbsp}sliding awaaaay. You know the " +
29
+ "nearer your destination the more you're slip#{nbsp}sliding away."
30
+ move_down 20
31
+
32
+ font("#{Prawn::DATADIR}/fonts/gkai00mp.ttf", :size => 16) do
33
+ long_text = "No word boundaries:\n更可怕的是,同质化竞争对手可以按照URL中后面这个ID来遍历您的DB中的内容,写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事,这样的话,你就非常被动了。更可怕的是,同质化竞争对手可以按照URL中后面这个ID来遍历您的DB中的内容,写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事,这样的话,你就非常被动了。"
34
+ text long_text
35
+ move_down 20
36
+
37
+ zwsp = Prawn::Text::ZWSP
38
+ 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}被动了。"
39
+ text long_text
40
+ end
41
+ end
@@ -0,0 +1,34 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Prawn strips all whitespace from the beginning and the end of strings so there
4
+ # are two ways to indent paragraphs:
5
+ #
6
+ # One is to use non-breaking spaces which Prawn won't strip. One shortcut to
7
+ # using them is the <code>Prawn::Text::NBSP</code>.
8
+ #
9
+ # The other is to use the <code>:indent_paragraphs</code> option with the text
10
+ # methods. Just pass a number with the space to indent the first line in each
11
+ # paragraph.
12
+ #
13
+ require File.expand_path(File.join(File.dirname(__FILE__),
14
+ %w[.. example_helper]))
15
+
16
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
17
+ Prawn::ManualBuilder::Example.generate(filename) do
18
+ # Using non-breaking spaces
19
+ text " " * 10 + "This paragraph won't be indented. " * 10 +
20
+ "\n#{Prawn::Text::NBSP * 10}" + "This one will with NBSP. " * 10
21
+
22
+ move_down 20
23
+ text "This paragraph will be indented. " * 10 +
24
+ "\n" + "This one will too. " * 10,
25
+ :indent_paragraphs => 60
26
+
27
+ move_down 20
28
+
29
+ text "FROM RIGHT TO LEFT:"
30
+ text "This paragraph will be indented. " * 10 +
31
+ "\n" + "This one will too. " * 10,
32
+ :indent_paragraphs => 60, :direction => :rtl
33
+
34
+ end
@@ -0,0 +1,38 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Sometimes we want the text on a specific position on the page. The
4
+ # <code>text</code> method just won't help us.
5
+ #
6
+ # There are two other methods for this task: <code>draw_text</code> and
7
+ # <code>text_box</code>.
8
+ #
9
+ # <code>draw_text</code> is very simple. It will render text starting at the
10
+ # position provided to the <code>:at</code> option. It won't flow to a new line
11
+ # even if it hits the document boundaries so it is best suited for short text.
12
+ #
13
+ # <code>text_box</code> gives us much more control over the output. Just provide
14
+ # <code>:width</code> and <code>:height</code> options and the text will flow
15
+ # accordingly. Even if you don't provide a <code>:width</code> option the text
16
+ # will flow to a new line if it reaches the right border.
17
+ #
18
+ # Given that, <code>text_box</code> is the better option available.
19
+ #
20
+ require File.expand_path(File.join(File.dirname(__FILE__),
21
+ %w[.. example_helper]))
22
+
23
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
24
+ Prawn::ManualBuilder::Example.generate(filename) do
25
+ draw_text "This draw_text line is absolute positioned. However don't " +
26
+ "expect it to flow even if it hits the document border",
27
+ :at => [200, 300]
28
+
29
+ text_box "This is a text box, you can control where it will flow by " +
30
+ "specifying the :height and :width options",
31
+ :at => [100, 250],
32
+ :height => 100,
33
+ :width => 100
34
+
35
+ text_box "Another text box with no :width option passed, so it will " +
36
+ "flow to a new line whenever it reaches the right margin. ",
37
+ :at => [200, 100]
38
+ end
@@ -0,0 +1,48 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Registering font families will help you when you want to use a font over and
4
+ # over or if you would like to take advantage of the <code>:style</code> option
5
+ # of the text methods and the <code>b</code> and <code>i</code> tags when using
6
+ # inline formatting.
7
+ #
8
+ # To register a font family update the <code>font_families</code>
9
+ # hash with the font path for each style you want to use.
10
+ #
11
+ require File.expand_path(File.join(File.dirname(__FILE__),
12
+ %w[.. example_helper]))
13
+
14
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
15
+ Prawn::ManualBuilder::Example.generate(filename) do
16
+ # Registering a single TTF font
17
+ font_families.update("DejaVu Sans" => {
18
+ :normal => "#{Prawn::DATADIR}/fonts/DejaVuSans.ttf"
19
+ })
20
+
21
+ font("DejaVu Sans") do
22
+ text "Using the DejaVu Sans font providing only its name to the font method"
23
+ end
24
+ move_down 20
25
+
26
+ # Registering a DFONT package
27
+ font_path = "#{Prawn::DATADIR}/fonts/Panic+Sans.dfont"
28
+ font_families.update("Panic Sans" => {
29
+ :normal => { :file => font_path, :font => "PanicSans" },
30
+ :italic => { :file => font_path, :font => "PanicSans-Italic" },
31
+ :bold => { :file => font_path, :font => "PanicSans-Bold" },
32
+ :bold_italic => { :file => font_path, :font => "PanicSans-BoldItalic" }
33
+ })
34
+
35
+ font "Panic Sans"
36
+ text "Also using Panic Sans by providing only its name"
37
+ move_down 20
38
+
39
+ text "Taking <b>advantage</b> of the <i>inline formatting</i>",
40
+ :inline_format => true
41
+ move_down 20
42
+
43
+ [:bold, :bold_italic, :italic, :normal].each do |style|
44
+ text "Using the #{style} style option.",
45
+ :style => style
46
+ move_down 10
47
+ end
48
+ end
@@ -0,0 +1,37 @@
1
+ # encoding: utf-8
2
+ #
3
+ # You have already seen how to set the text color using both inline formatting
4
+ # and the format text methods. There is another way by using the graphics
5
+ # methods <code>fill_color</code> and <code>stroke_color</code>.
6
+ #
7
+ # When reading the graphics reference you learned about fill and stroke. If you
8
+ # haven't read it before, read it now before continuing.
9
+ #
10
+ # Text can be rendered by
11
+ # being filled (the default mode) or just stroked or both filled and stroked.
12
+ # This can be set using the <code>text_rendering_mode</code> method or the
13
+ # <code>:mode</code> option on the text methods.
14
+ #
15
+ require File.expand_path(File.join(File.dirname(__FILE__),
16
+ %w[.. example_helper]))
17
+
18
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
19
+ Prawn::ManualBuilder::Example.generate(filename) do
20
+ fill_color "00ff00"
21
+ stroke_color "0000ff"
22
+
23
+ font_size(40) do
24
+ # normal rendering mode: fill
25
+ text "This text is filled with green."
26
+ move_down 20
27
+
28
+ # inline rendering mode: stroke
29
+ text "This text is stroked with blue", :mode => :stroke
30
+ move_down 20
31
+
32
+ # block rendering mode: fill and stroke
33
+ text_rendering_mode(:fill_stroke) do
34
+ text "This text is filled with green and stroked with blue"
35
+ end
36
+ end
37
+ end
@@ -0,0 +1,47 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Prawn can be used with right-to-left text. The direction can be set
4
+ # document-wide, on particular text, or on a text-box. Setting the direction to
5
+ # <code>:rtl</code> automatically changes the default alignment to
6
+ # <code>:right</code>
7
+ #
8
+ # You can even override direction on an individual fragment. The one caveat is
9
+ # that two fragments going against the main direction cannot be placed next to
10
+ # each other without appearing in the wrong order.
11
+ #
12
+ # Writing bidirectional text that combines both left-to-right and right-to-left
13
+ # languages is easy using the <code>bidi</code> Ruby Gem and its
14
+ # <code>render_visual</code> function. See https://github.com/elad/ruby-bidi for
15
+ # instructions and an example using Prawn.
16
+ require File.expand_path(File.join(File.dirname(__FILE__),
17
+ %w[.. example_helper]))
18
+
19
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
20
+ Prawn::ManualBuilder::Example.generate(filename) do
21
+ # set the direction document-wide
22
+ self.text_direction = :rtl
23
+
24
+ font("#{Prawn::DATADIR}/fonts/gkai00mp.ttf", :size => 16) do
25
+ long_text = "写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小"
26
+ text long_text
27
+ move_down 20
28
+
29
+ text "You can override the document direction.", :direction => :ltr
30
+ move_down 20
31
+
32
+ formatted_text [{ :text => "更可怕的是,同质化竞争对手可以按照" },
33
+ { :text => "URL", :direction => :ltr },
34
+ { :text => "中后面这个" },
35
+ { :text => "ID", :direction => :ltr },
36
+ { :text => "来遍历您的" },
37
+ { :text => "DB", :direction => :ltr },
38
+ { :text => "中的内容,写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事,这样的话,你就非常被动了。" }]
39
+ move_down 20
40
+
41
+ formatted_text [{ :text => "更可怕的是,同质化竞争对手可以按照" },
42
+ { :text => "this", :direction => :ltr },
43
+ { :text => "won't", :direction => :ltr, :size => 24 },
44
+ { :text => "work", :direction => :ltr },
45
+ { :text => "中的内容,写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事" }]
46
+ end
47
+ end