nurettin-prawn 1.0.0.rc1
Sign up to get free protection for your applications and to get access to all the features.
- data/COPYING +2 -0
- data/GPLv2 +340 -0
- data/GPLv3 +674 -0
- data/Gemfile +18 -0
- data/LICENSE +56 -0
- data/README.md +98 -0
- data/Rakefile +45 -0
- data/data/encodings/win_ansi.txt +29 -0
- data/data/fonts/Action Man.dfont +0 -0
- data/data/fonts/Activa.ttf +0 -0
- data/data/fonts/Chalkboard.ttf +0 -0
- data/data/fonts/Courier-Bold.afm +342 -0
- data/data/fonts/Courier-BoldOblique.afm +342 -0
- data/data/fonts/Courier-Oblique.afm +342 -0
- data/data/fonts/Courier.afm +342 -0
- data/data/fonts/DejaVuSans.ttf +0 -0
- data/data/fonts/Dustismo_Roman.ttf +0 -0
- data/data/fonts/Helvetica-Bold.afm +2827 -0
- data/data/fonts/Helvetica-BoldOblique.afm +2827 -0
- data/data/fonts/Helvetica-Oblique.afm +3051 -0
- data/data/fonts/Helvetica.afm +3051 -0
- data/data/fonts/MustRead.html +19 -0
- data/data/fonts/Symbol.afm +213 -0
- data/data/fonts/Times-Bold.afm +2588 -0
- data/data/fonts/Times-BoldItalic.afm +2384 -0
- data/data/fonts/Times-Italic.afm +2667 -0
- data/data/fonts/Times-Roman.afm +2419 -0
- data/data/fonts/ZapfDingbats.afm +225 -0
- data/data/fonts/comicsans.ttf +0 -0
- data/data/fonts/gkai00mp.ttf +0 -0
- data/data/images/16bit.alpha +0 -0
- data/data/images/16bit.dat +0 -0
- data/data/images/16bit.png +0 -0
- data/data/images/arrow.png +0 -0
- data/data/images/arrow2.png +0 -0
- data/data/images/barcode_issue.png +0 -0
- data/data/images/dice.alpha +0 -0
- data/data/images/dice.dat +0 -0
- data/data/images/dice.png +0 -0
- data/data/images/dice_interlaced.png +0 -0
- data/data/images/fractal.jpg +0 -0
- data/data/images/letterhead.jpg +0 -0
- data/data/images/page_white_text.alpha +0 -0
- data/data/images/page_white_text.dat +0 -0
- data/data/images/page_white_text.png +0 -0
- data/data/images/pigs.jpg +0 -0
- data/data/images/prawn.png +0 -0
- data/data/images/rails.dat +0 -0
- data/data/images/rails.png +0 -0
- data/data/images/ruport.png +0 -0
- data/data/images/ruport_data.dat +0 -0
- data/data/images/ruport_transparent.png +0 -0
- data/data/images/ruport_type0.png +0 -0
- data/data/images/stef.jpg +0 -0
- data/data/images/tru256.bmp +0 -0
- data/data/images/web-links.dat +1 -0
- data/data/images/web-links.png +0 -0
- data/data/pdfs/complex_template.pdf +0 -0
- data/data/pdfs/contains_ttf_font.pdf +0 -0
- data/data/pdfs/encrypted.pdf +0 -0
- data/data/pdfs/form.pdf +820 -0
- data/data/pdfs/hexagon.pdf +61 -0
- data/data/pdfs/indirect_reference.pdf +86 -0
- data/data/pdfs/multipage_template.pdf +127 -0
- data/data/pdfs/nested_pages.pdf +118 -0
- data/data/pdfs/page_without_mediabox.pdf +193 -0
- data/data/pdfs/resources_as_indirect_object.pdf +83 -0
- data/data/pdfs/two_hexagons.pdf +90 -0
- data/data/pdfs/version_1_6.pdf +61 -0
- data/data/shift_jis_text.txt +1 -0
- data/lib/prawn.rb +29 -0
- data/lib/prawn/compatibility.rb +87 -0
- data/lib/prawn/core.rb +87 -0
- data/lib/prawn/core/annotations.rb +61 -0
- data/lib/prawn/core/byte_string.rb +9 -0
- data/lib/prawn/core/destinations.rb +90 -0
- data/lib/prawn/core/document_state.rb +79 -0
- data/lib/prawn/core/literal_string.rb +16 -0
- data/lib/prawn/core/name_tree.rb +177 -0
- data/lib/prawn/core/object_store.rb +320 -0
- data/lib/prawn/core/page.rb +212 -0
- data/lib/prawn/core/pdf_object.rb +125 -0
- data/lib/prawn/core/reference.rb +119 -0
- data/lib/prawn/core/text.rb +268 -0
- data/lib/prawn/core/text/formatted/arranger.rb +294 -0
- data/lib/prawn/core/text/formatted/line_wrap.rb +288 -0
- data/lib/prawn/core/text/formatted/wrap.rb +153 -0
- data/lib/prawn/document.rb +707 -0
- data/lib/prawn/document/bounding_box.rb +510 -0
- data/lib/prawn/document/column_box.rb +132 -0
- data/lib/prawn/document/graphics_state.rb +136 -0
- data/lib/prawn/document/internals.rb +173 -0
- data/lib/prawn/document/page_geometry.rb +136 -0
- data/lib/prawn/document/snapshot.rb +89 -0
- data/lib/prawn/document/span.rb +55 -0
- data/lib/prawn/encoding.rb +121 -0
- data/lib/prawn/errors.rb +99 -0
- data/lib/prawn/font.rb +386 -0
- data/lib/prawn/font/afm.rb +203 -0
- data/lib/prawn/font/dfont.rb +42 -0
- data/lib/prawn/font/ttf.rb +343 -0
- data/lib/prawn/graphics.rb +523 -0
- data/lib/prawn/graphics/cap_style.rb +46 -0
- data/lib/prawn/graphics/color.rb +231 -0
- data/lib/prawn/graphics/dash.rb +82 -0
- data/lib/prawn/graphics/join_style.rb +47 -0
- data/lib/prawn/graphics/patterns.rb +137 -0
- data/lib/prawn/graphics/transformation.rb +156 -0
- data/lib/prawn/graphics/transparency.rb +99 -0
- data/lib/prawn/images.rb +196 -0
- data/lib/prawn/images/image.rb +65 -0
- data/lib/prawn/images/jpg.rb +85 -0
- data/lib/prawn/images/png.rb +362 -0
- data/lib/prawn/layout.rb +20 -0
- data/lib/prawn/layout/grid.rb +259 -0
- data/lib/prawn/measurement_extensions.rb +46 -0
- data/lib/prawn/measurements.rb +71 -0
- data/lib/prawn/outline.rb +326 -0
- data/lib/prawn/repeater.rb +122 -0
- data/lib/prawn/security.rb +269 -0
- data/lib/prawn/soft_mask.rb +94 -0
- data/lib/prawn/stamp.rb +134 -0
- data/lib/prawn/table.rb +609 -0
- data/lib/prawn/table/cell.rb +776 -0
- data/lib/prawn/table/cell/image.rb +70 -0
- data/lib/prawn/table/cell/in_table.rb +27 -0
- data/lib/prawn/table/cell/span_dummy.rb +88 -0
- data/lib/prawn/table/cell/subtable.rb +65 -0
- data/lib/prawn/table/cell/text.rb +152 -0
- data/lib/prawn/table/cells.rb +260 -0
- data/lib/prawn/text.rb +420 -0
- data/lib/prawn/text/box.rb +141 -0
- data/lib/prawn/text/formatted.rb +4 -0
- data/lib/prawn/text/formatted/box.rb +563 -0
- data/lib/prawn/text/formatted/fragment.rb +253 -0
- data/lib/prawn/text/formatted/parser.rb +217 -0
- 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 +46 -0
- data/spec/annotations_spec.rb +90 -0
- data/spec/bounding_box_spec.rb +493 -0
- data/spec/cell_spec.rb +584 -0
- data/spec/column_box_spec.rb +33 -0
- data/spec/data/curves.pdf +66 -0
- data/spec/destinations_spec.rb +15 -0
- data/spec/document_spec.rb +736 -0
- data/spec/extensions/encoding_helpers.rb +6 -0
- data/spec/extensions/mocha.rb +44 -0
- data/spec/font_spec.rb +433 -0
- data/spec/formatted_text_arranger_spec.rb +421 -0
- data/spec/formatted_text_box_spec.rb +640 -0
- data/spec/formatted_text_fragment_spec.rb +298 -0
- data/spec/graphics_spec.rb +651 -0
- data/spec/grid_spec.rb +85 -0
- data/spec/images_spec.rb +140 -0
- data/spec/inline_formatted_text_parser_spec.rb +515 -0
- data/spec/jpg_spec.rb +25 -0
- data/spec/line_wrap_spec.rb +333 -0
- data/spec/measurement_units_spec.rb +23 -0
- data/spec/name_tree_spec.rb +112 -0
- data/spec/object_store_spec.rb +170 -0
- data/spec/outline_spec.rb +426 -0
- data/spec/pdf_object_spec.rb +172 -0
- data/spec/png_spec.rb +240 -0
- data/spec/reference_spec.rb +105 -0
- data/spec/repeater_spec.rb +158 -0
- data/spec/security_spec.rb +126 -0
- data/spec/snapshot_spec.rb +186 -0
- data/spec/soft_mask_spec.rb +117 -0
- data/spec/span_spec.rb +49 -0
- data/spec/spec_helper.rb +36 -0
- data/spec/stamp_spec.rb +159 -0
- data/spec/stroke_styles_spec.rb +193 -0
- data/spec/table_spec.rb +1209 -0
- data/spec/template_spec.rb +351 -0
- data/spec/text_at_spec.rb +129 -0
- data/spec/text_box_spec.rb +1029 -0
- data/spec/text_rendering_mode_spec.rb +45 -0
- data/spec/text_spacing_spec.rb +93 -0
- data/spec/text_spec.rb +421 -0
- data/spec/text_with_inline_formatting_spec.rb +35 -0
- data/spec/transparency_spec.rb +89 -0
- metadata +544 -0
@@ -0,0 +1,26 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# <code>Prawn::Table#initialize</code> takes a
|
4
|
+
# <code>:before_rendering_page</code> argument, to adjust the way an entire page
|
5
|
+
# of table cells is styled. This allows you to do things like draw a border
|
6
|
+
# around the entire table as displayed on a page.
|
7
|
+
#
|
8
|
+
# The callback is passed a Cells object that is numbered based on the order of
|
9
|
+
# the cells on the page (e.g., the first row on the page is
|
10
|
+
# <code>cells.row(0)</code>).
|
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::Example.generate(filename) do
|
17
|
+
table([["foo", "bar", "baz"]] * 40) do |t|
|
18
|
+
t.cells.border_width = 1
|
19
|
+
t.before_rendering_page do |page|
|
20
|
+
page.row(0).border_top_width = 3
|
21
|
+
page.row(-1).border_bottom_width = 3
|
22
|
+
page.column(0).border_left_width = 3
|
23
|
+
page.column(-1).border_right_width = 3
|
24
|
+
end
|
25
|
+
end
|
26
|
+
end
|
@@ -0,0 +1,24 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# The <code>border_lines</code> option accepts an array with the styles of the
|
4
|
+
# border sides. The default is <code>[:solid, :solid, :solid, :solid]</code>.
|
5
|
+
#
|
6
|
+
# <code>border_lines</code> must be set to an array.
|
7
|
+
#
|
8
|
+
require File.expand_path(File.join(File.dirname(__FILE__),
|
9
|
+
%w[.. example_helper]))
|
10
|
+
|
11
|
+
filename = File.basename(__FILE__).gsub('.rb', '.pdf')
|
12
|
+
Prawn::Example.generate(filename) do
|
13
|
+
data = [ ["Look at how the cell border lines can be mixed", "", ""],
|
14
|
+
["dotted top border", "", ""],
|
15
|
+
["solid right border", "", ""],
|
16
|
+
["dotted bottom border", "", ""],
|
17
|
+
["dashed left border", "", ""]
|
18
|
+
]
|
19
|
+
|
20
|
+
text "Cell :border_lines => [:dotted, :solid, :dotted, :dashed]"
|
21
|
+
|
22
|
+
table(data, :cell_style =>
|
23
|
+
{ :border_lines => [:dotted, :solid, :dotted, :dashed] })
|
24
|
+
end
|
@@ -0,0 +1,31 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# The <code>borders</code> option accepts an array with the border sides that
|
4
|
+
# will be drawn. The default is <code>[:top, :bottom, :left, :right]</code>.
|
5
|
+
#
|
6
|
+
# <code>border_width</code> may be set with a numeric value.
|
7
|
+
#
|
8
|
+
# Both <code>border_color</code> and <code>background_color</code> accept an
|
9
|
+
# HTML like RGB color string ("FF0000")
|
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::Example.generate(filename) do
|
16
|
+
data = [ ["Look at how the cells will look when styled", "", ""],
|
17
|
+
["They probably won't look the same", "", ""]
|
18
|
+
]
|
19
|
+
|
20
|
+
{ :borders => [:top, :left],
|
21
|
+
:border_width => 3,
|
22
|
+
:border_color => "FF0000"}.each do |property, value|
|
23
|
+
|
24
|
+
text "Cell #{property}: #{value.inspect}"
|
25
|
+
table(data, :cell_style => {property => value})
|
26
|
+
move_down 20
|
27
|
+
end
|
28
|
+
|
29
|
+
text "Cell background_color: FFFFCC"
|
30
|
+
table(data, :cell_style => {:background_color => "FFFFCC"})
|
31
|
+
end
|
@@ -0,0 +1,30 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# To style all the table cells you can use the <code>:cell_style</code> option
|
4
|
+
# with the table methods. It accepts a hash with the cell style options.
|
5
|
+
#
|
6
|
+
# Some straightforward options are <code>width</code>, <code>height</code>,
|
7
|
+
# and <code>padding</code>. All three accept numeric values to set the property.
|
8
|
+
#
|
9
|
+
# <code>padding</code> also accepts a four number array that defines the padding
|
10
|
+
# in a CSS like syntax setting the top, right, bottom, left sequentially. The
|
11
|
+
# default is 5pt for all sides.
|
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::Example.generate(filename) do
|
18
|
+
data = [ ["Look at how the cells will look when styled", "", ""],
|
19
|
+
["They probably won't look the same", "", ""]
|
20
|
+
]
|
21
|
+
|
22
|
+
{:width => 160, :height => 50, :padding => 12}.each do |property, value|
|
23
|
+
text "Cell's #{property}: #{value}"
|
24
|
+
table(data, :cell_style => {property => value})
|
25
|
+
move_down 20
|
26
|
+
end
|
27
|
+
|
28
|
+
text "Padding can also be set with an array: [0, 0, 0, 30]"
|
29
|
+
table(data, :cell_style => {:padding => [0, 0, 0, 30]})
|
30
|
+
end
|
@@ -0,0 +1,38 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# Text cells accept the following options: <code>align</code>,
|
4
|
+
# <code>font</code>, <code>font_style</code>, <code>inline_format</code>,
|
5
|
+
# <code>kerning</code>, <code>leading</code>, <code>min_font_size</code>,
|
6
|
+
# <code>overflow</code>, <code>rotate</code>, <code>rotate_around</code>,
|
7
|
+
# <code>single_line</code>, <code>size</code>, <code>text_color</code>,
|
8
|
+
# and <code>valign</code>.
|
9
|
+
#
|
10
|
+
# Most of these style options are direct translations from the text methods
|
11
|
+
# styling options.
|
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::Example.generate(filename) do
|
18
|
+
data = [ ["Look at how the cells will look when styled", "", ""],
|
19
|
+
["They probably won't look the same", "", ""]
|
20
|
+
]
|
21
|
+
|
22
|
+
table data, :cell_style => { :font => "Times-Roman", :font_style => :italic }
|
23
|
+
move_down 20
|
24
|
+
|
25
|
+
table data, :cell_style => { :size => 18, :text_color => "346842" }
|
26
|
+
move_down 20
|
27
|
+
|
28
|
+
table [["Just <font size='18'>some</font> <b><i>inline</i></b>", "", ""],
|
29
|
+
["<color rgb='FF00FF'>styles</color> being applied here", "", ""]],
|
30
|
+
:cell_style => { :inline_format => true }
|
31
|
+
move_down 20
|
32
|
+
|
33
|
+
table [["1", "2", "3", "rotate"]], :cell_style => { :rotate => 30 }
|
34
|
+
move_down 20
|
35
|
+
|
36
|
+
table data, :cell_style => { :overflow => :shrink_to_fit, :min_font_size => 8,
|
37
|
+
:width => 60, :height => 30 }
|
38
|
+
end
|
@@ -0,0 +1,30 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# Prawn will make its best attempt to identify the best width for the columns.
|
4
|
+
# If the end result isn't good, we can override it with some styling.
|
5
|
+
#
|
6
|
+
# Individual column widths can be set with the <code>:column_widths</code>
|
7
|
+
# option. Just provide an array with the sequential width values for the columns
|
8
|
+
# or a hash were each key-value pair represents the column 0-based index and its
|
9
|
+
# width.
|
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::Example.generate(filename) do
|
16
|
+
data = [ ["this is not quite as long as the others",
|
17
|
+
"here we have a line that is long but with smaller words",
|
18
|
+
"this is so very looooooooooooooooooooooooooooooong"] ]
|
19
|
+
|
20
|
+
text "Prawn trying to guess the column widths"
|
21
|
+
table(data)
|
22
|
+
move_down 20
|
23
|
+
|
24
|
+
text "Manually setting all the column widths"
|
25
|
+
table(data, :column_widths => [100, 200, 240])
|
26
|
+
move_down 20
|
27
|
+
|
28
|
+
text "Setting only the last column width"
|
29
|
+
table(data, :column_widths => {2 => 240})
|
30
|
+
end
|
@@ -0,0 +1,39 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# There are five kinds of objects which can be put in table cells:
|
4
|
+
# 1. String: produces a text cell (the most common usage)
|
5
|
+
# 2. <code>Prawn::Table::Cell</code>
|
6
|
+
# 3. <code>Prawn::Table</code>
|
7
|
+
# 4. Array
|
8
|
+
# 5. Images
|
9
|
+
#
|
10
|
+
# Whenever a table or an array is provided as a cell, a subtable will be created
|
11
|
+
# (a table within a cell).
|
12
|
+
#
|
13
|
+
# If you'd like to provide a cell or table directly, the best way is to
|
14
|
+
# use the <code>make_cell</code> and <code>make_table</code> methods as they
|
15
|
+
# don't call <code>draw</code> on the created object.
|
16
|
+
#
|
17
|
+
# To insert an image just provide a hash with an with an <code>:image</code> key
|
18
|
+
# pointing to the image path.
|
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::Example.generate(filename) do
|
25
|
+
cell_1 = make_cell(:content => "this row content comes directly ")
|
26
|
+
cell_2 = make_cell(:content => "from cell objects")
|
27
|
+
|
28
|
+
two_dimensional_array = [ ["..."], ["subtable from an array"], ["..."] ]
|
29
|
+
|
30
|
+
my_table = make_table([ ["..."], ["subtable from another table"], ["..."] ])
|
31
|
+
|
32
|
+
image_path = "#{Prawn::DATADIR}/images/stef.jpg"
|
33
|
+
|
34
|
+
table([ ["just a regular row", "", "", "blah blah blah"],
|
35
|
+
[cell_1, cell_2, "", ""],
|
36
|
+
["", "", two_dimensional_array, ""],
|
37
|
+
["just another regular row", "", "", ""],
|
38
|
+
[{:image => image_path}, "", my_table, ""]])
|
39
|
+
end
|
@@ -0,0 +1,27 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# Creating tables with Prawn is fairly easy. There are two methods that will
|
4
|
+
# create tables for us <code>table</code> and <code>make_table</code>.
|
5
|
+
#
|
6
|
+
# Both are wrappers that create a new <code>Prawn::Table</code> object. The
|
7
|
+
# difference is that <code>table</code> calls the <code>draw</code> method
|
8
|
+
# after creating the table and <code>make_table</code> only returns the created
|
9
|
+
# table, so you have to call the <code>draw</code> method yourself.
|
10
|
+
#
|
11
|
+
# The most simple table can be created by providing only an array of arrays
|
12
|
+
# containing your data where each inner array represents one row.
|
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::Example.generate(filename) do
|
19
|
+
t = make_table([ ["this is the first row"],
|
20
|
+
["this is the second row"] ])
|
21
|
+
t.draw
|
22
|
+
move_down 20
|
23
|
+
|
24
|
+
table([ ["short", "short", "loooooooooooooooooooong"],
|
25
|
+
["short", "loooooooooooooooooooong", "short"],
|
26
|
+
["loooooooooooooooooooong", "short", "short"] ])
|
27
|
+
end
|
@@ -0,0 +1,36 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# Another way to reduce the number of cells is to <code>filter</code> the table.
|
4
|
+
#
|
5
|
+
# <code>filter</code> is just like <code>Enumerable#select</code>. Pass it a
|
6
|
+
# block and it will iterate through the cells returning a new
|
7
|
+
# <code>Prawn::Table::Cells</code> instance containing only those cells for
|
8
|
+
# which the block was not false.
|
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::Example.generate(filename) do
|
15
|
+
data = [ ["Item", "Jan Sales", "Feb Sales"],
|
16
|
+
["Oven", 17, 89],
|
17
|
+
["Fridge", 62, 30],
|
18
|
+
["Microwave", 71, 47]
|
19
|
+
]
|
20
|
+
|
21
|
+
table(data) do
|
22
|
+
values = cells.columns(1..-1).rows(1..-1)
|
23
|
+
|
24
|
+
bad_sales = values.filter do |cell|
|
25
|
+
cell.content.to_i < 40
|
26
|
+
end
|
27
|
+
|
28
|
+
bad_sales.background_color = "FFAAAA"
|
29
|
+
|
30
|
+
good_sales = values.filter do |cell|
|
31
|
+
cell.content.to_i > 70
|
32
|
+
end
|
33
|
+
|
34
|
+
good_sales.background_color = "AAFFAA"
|
35
|
+
end
|
36
|
+
end
|
@@ -0,0 +1,17 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# If the table cannot fit on the current page it will flow to the next page just
|
4
|
+
# like free flowing text. If you would like to have the first row treated as a
|
5
|
+
# header which will be repeated on subsequent pages set the <code>:header</code>
|
6
|
+
# option to true.
|
7
|
+
#
|
8
|
+
require File.expand_path(File.join(File.dirname(__FILE__),
|
9
|
+
%w[.. example_helper]))
|
10
|
+
|
11
|
+
filename = File.basename(__FILE__).gsub('.rb', '.pdf')
|
12
|
+
Prawn::Example.generate(filename) do
|
13
|
+
data = [["This row should be repeated on every new page"]]
|
14
|
+
data += [["..."]] * 30
|
15
|
+
|
16
|
+
table(data, :header => true)
|
17
|
+
end
|
@@ -0,0 +1,33 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# Prawn can insert images into a table. Just pass a hash into
|
4
|
+
# <code>table()</code> with an <code>:image</code> key pointing to the image.
|
5
|
+
#
|
6
|
+
# You can pass the <code>:scale</code>, <code>:fit</code>,
|
7
|
+
# <code>:position</code>, and <code>:vposition</code> arguments in alongside
|
8
|
+
# <code>:image</code>; these will function just as in <code>image()</code>.
|
9
|
+
#
|
10
|
+
# The <code>:image_width</code> and <code>:image_height</code> arguments set
|
11
|
+
# the width/height of the image within the cell, as opposed to the
|
12
|
+
# <code>:width</code> and <code>:height</code> arguments, which set the table
|
13
|
+
# cell's dimensions.
|
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::Example.generate(filename) do
|
20
|
+
image = "#{Prawn::DATADIR}/images/prawn.png"
|
21
|
+
|
22
|
+
table [
|
23
|
+
["Standard image cell", {:image => image}],
|
24
|
+
[":scale => 0.5", {:image => image, :scale => 0.5}],
|
25
|
+
[":fit => [100, 200]", {:image => image, :fit => [100, 200]}],
|
26
|
+
[":image_height => 50,
|
27
|
+
:image_width => 100", {:image => image, :image_height => 50,
|
28
|
+
:image_width => 100}],
|
29
|
+
[":position => :center", {:image => image, :position => :center}],
|
30
|
+
[":vposition => :center", {:image => image, :vposition => :center,
|
31
|
+
:height => 200}]
|
32
|
+
], :width => bounds.width
|
33
|
+
end
|
@@ -0,0 +1,29 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# The <code>table()</code> method accepts a <code>:position</code> argument to
|
4
|
+
# determine horizontal position of the table within its bounding box. It can be
|
5
|
+
# <code>:left</code> (the default), <code>:center</code>, <code>:right</code>,
|
6
|
+
# or a number specifying a distance in PDF points from the left side.
|
7
|
+
#
|
8
|
+
require File.expand_path(File.join(File.dirname(__FILE__),
|
9
|
+
%w[.. example_helper]))
|
10
|
+
|
11
|
+
filename = File.basename(__FILE__).gsub('.rb', '.pdf')
|
12
|
+
Prawn::Example.generate(filename) do
|
13
|
+
data = [["The quick brown fox jumped over the lazy dogs."]] * 2
|
14
|
+
|
15
|
+
text "Left:"
|
16
|
+
table data, :position => :left
|
17
|
+
move_down 10
|
18
|
+
|
19
|
+
text "Center:"
|
20
|
+
table data, :position => :center
|
21
|
+
move_down 10
|
22
|
+
|
23
|
+
text "Right:"
|
24
|
+
table data, :position => :right
|
25
|
+
move_down 10
|
26
|
+
|
27
|
+
text "100pt:"
|
28
|
+
table data, :position => 100
|
29
|
+
end
|
@@ -0,0 +1,20 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# One of the most common table styling techniques is to stripe the rows with
|
4
|
+
# alternating colors.
|
5
|
+
#
|
6
|
+
# There is one helper just for that. Just provide the <code>:row_colors</code>
|
7
|
+
# option an array with color values.
|
8
|
+
#
|
9
|
+
require File.expand_path(File.join(File.dirname(__FILE__),
|
10
|
+
%w[.. example_helper]))
|
11
|
+
|
12
|
+
filename = File.basename(__FILE__).gsub('.rb', '.pdf')
|
13
|
+
Prawn::Example.generate(filename) do
|
14
|
+
data = [["This row should have one color"],
|
15
|
+
["And this row should have another"]]
|
16
|
+
|
17
|
+
data += [["..."]] * 10
|
18
|
+
|
19
|
+
table(data, :row_colors => ["F0F0F0", "FFFFCC"])
|
20
|
+
end
|
@@ -0,0 +1,30 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# Table cells can span multiple columns, rows, or both. When building a cell,
|
4
|
+
# use the hash argument constructor with a <code>:colspan</code> and/or
|
5
|
+
# <code>:rowspan</code> argument. Row or column spanning must be specified when
|
6
|
+
# building the data array; you can't set the span in the table's initialization
|
7
|
+
# block. This is because cells are laid out in the grid before that block is
|
8
|
+
# called, so that references to row and column numbers make sense.
|
9
|
+
#
|
10
|
+
# Cells are laid out in the order given, skipping any positions spanned by
|
11
|
+
# previously instantiated cells. Therefore, a cell with <code>rowspan: 2</code>
|
12
|
+
# will be missing at least one cell in the row below it. See the code and table
|
13
|
+
# below for an example.
|
14
|
+
#
|
15
|
+
# It is illegal to overlap cells via spanning. A
|
16
|
+
# <code>Prawn::Errors::InvalidTableSpan</code> error will be raised if spans
|
17
|
+
# would cause cells to overlap.
|
18
|
+
#
|
19
|
+
require File.expand_path(File.join(File.dirname(__FILE__),
|
20
|
+
%w[.. example_helper]))
|
21
|
+
|
22
|
+
filename = File.basename(__FILE__).gsub('.rb', '.pdf')
|
23
|
+
Prawn::Example.generate(filename) do
|
24
|
+
table([
|
25
|
+
["A", {:content => "2x1", :colspan => 2}, "B"],
|
26
|
+
[{:content => "1x2", :rowspan => 2}, "C", "D", "E"],
|
27
|
+
[{:content => "2x2", :colspan => 2, :rowspan => 2}, "F"],
|
28
|
+
["G", "H"]
|
29
|
+
])
|
30
|
+
end
|
@@ -0,0 +1,22 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
#
|
3
|
+
# We've seen how to apply styles to a selection of cells by setting the
|
4
|
+
# individual properties. Another option is to use the <code>style</code> method
|
5
|
+
#
|
6
|
+
# <code>style</code> lets us define multiple properties at once with a hash. It
|
7
|
+
# also accepts a block that will be called for each cell and can be used for
|
8
|
+
# some complex styling.
|
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::Example.generate(filename) do
|
15
|
+
table([[""] * 8] * 8) do
|
16
|
+
cells.style(:width => 24, :height => 24)
|
17
|
+
|
18
|
+
cells.style do |c|
|
19
|
+
c.background_color = ((c.row + c.column) % 2).zero? ? '000000' : 'ffffff'
|
20
|
+
end
|
21
|
+
end
|
22
|
+
end
|