prawn 2.3.0 → 2.5.0

data/manual/text/text.rb

@@ -1,75 +0,0 @@
-# frozen_string_literal: true
-
-# Examples for text rendering.
-
-require '../example_helper'
-
-Prawn::ManualBuilder::Example.generate('text.pdf', page_size: 'FOLIO') do
-  package 'text' do |p|
-    p.section 'Basics' do |s|
-      s.example 'free_flowing_text'
-      s.example 'positioned_text'
-      s.example 'text_box_overflow'
-      s.example 'text_box_excess'
-      s.example 'column_box'
-    end
-
-    p.section 'Styling' do |s|
-      s.example 'font'
-      s.example 'font_size'
-      s.example 'font_style'
-      s.example 'color'
-      s.example 'alignment'
-      s.example 'leading'
-      s.example 'kerning_and_character_spacing'
-      s.example 'paragraph_indentation'
-      s.example 'rotation'
-    end
-
-    p.section 'Advanced Styling' do |s|
-      s.example 'inline'
-      s.example 'formatted_text'
-      s.example 'formatted_callbacks'
-      s.example 'rendering_and_color'
-      s.example 'text_box_extensions'
-    end
-
-    p.section 'External Fonts' do |s|
-      s.example 'single_usage'
-      s.example 'registering_families'
-    end
-
-    p.section 'Multilingualization' do |s|
-      s.example 'utf8'
-      s.example 'line_wrapping'
-      s.example 'right_to_left_text'
-      s.example 'fallback_fonts'
-      s.example 'win_ansi_charset'
-    end
-
-    p.intro do
-      prose <<-TEXT
-        This is probably the feature people will use the most. There is no
-        shortage of options when it comes to text. You'll be hard pressed to
-        find a use case that is not covered by one of the text methods and
-        configurable options.
-
-        The examples show:
-      TEXT
-
-      list(
-        'Text that flows from page to page automatically starting new pages when necessary',
-        'How to use text boxes and place them on specific positions',
-        'What to do when a text box is too small to fit its content',
-        'Flowing text in columns',
-        'How to change the text style configuring font, size, alignment and many other settings',
-        'How to style specific portions of a text with inline styling and formatted text',
-        'How to define formatted callbacks to reuse common styling definitions',
-        'How to use the different rendering modes available for the text methods',
-        'How to create your custom text box extensions',
-        'How to use external fonts on your pdfs',
-        'What happens when rendering text in different languages'
-      )
-    end
-  end
-end

data/manual/text/text_box_excess.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-# Whenever the <code>text_box</code> method truncates text, this truncated bit
-# is not lost, it is the method return value and we can take advantage of that.
-#
-# We just need to take some precautions.
-#
-# This example renders as much of the text as will fit in a larger font inside
-# one text_box and then proceeds to render the remaining text in the default
-# size in a second text_box.
-
-require '../example_helper'
-
-filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::ManualBuilder::Example.generate(filename) do
-  string = 'This is the beginning of the text. It will be cut somewhere and ' \
-    'the rest of the text will procede to be rendered this time by ' \
-    'calling another method.' + ' . ' * 50
-
-  y_position = cursor - 20
-  excess_text = text_box(
-    string,
-    width: 300,
-    height: 50,
-    overflow: :truncate,
-    at: [100, y_position],
-    size: 18
-  )
-
-  text_box(
-    excess_text,
-    width: 300,
-    at: [100, y_position - 100]
-  )
-end

data/manual/text/text_box_extensions.rb

@@ -1,48 +0,0 @@
-# frozen_string_literal: true
-
-# We've already seen one way of using text boxes with the <code>text_box</code>
-# method. Turns out this method is just a convenience for using the
-# <code>Prawn::Text::Box</code> class as it creates a new object and call
-# <code>render</code> on it.
-#
-# Knowing that any extensions we add to <code>Prawn::Text::Box</code> will take
-# effect when we use the <code>text_box</code> method. To add an extension all
-# we need to do is append the <code>Prawn::Text::Box.extensions</code> array
-# with a module.
-
-require '../example_helper'
-
-filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::ManualBuilder::Example.generate(filename) do
-  module TriangleBox
-    def available_width
-      height + 25
-    end
-  end
-
-  y_position = cursor - 10
-  width = 100
-  height = 100
-
-  Prawn::Text::Box.extensions << TriangleBox
-  stroke_rectangle([0, y_position], width, height)
-  text_box(
-    'A' * 100,
-    at: [0, y_position],
-    width: width,
-    height: height
-  )
-
-  Prawn::Text::Formatted::Box.extensions << TriangleBox
-  stroke_rectangle([200, y_position], width, height)
-  formatted_text_box(
-    [text: 'A' * 100, color: '009900'],
-    at: [200, y_position],
-    width: width,
-    height: height
-  )
-
-  # Here we clear the extensions array
-  Prawn::Text::Box.extensions.clear
-  Prawn::Text::Formatted::Box.extensions.clear
-end

data/manual/text/text_box_overflow.rb

@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-
-# The <code>text_box</code> method accepts both <code>:width</code> and
-# <code>:height</code> options. So what happens if the text doesn't fit the box?
-#
-# The default behavior is to truncate the text but this can be changed with
-# the <code>:overflow</code> option. Available modes are <code>:expand</code>
-# (the box will increase to fit the text) and <code>:shrink_to_fit</code>
-# (the text font size will be shrunk to fit).
-#
-# If <code>:shrink_to_fit</code> mode is used with the
-# <code>:min_font_size</code> option set, the font size will not be reduced to
-# less than the value provided even if it means truncating some text.
-#
-# If the <code>:disable_wrap_by_char</code> is set to <code>true</code>
-# then any text wrapping done while using the <code>:shrink_to_fit</code>
-# mode will not break up the middle of words.
-
-require_relative '../example_helper'
-
-filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::ManualBuilder::Example.generate(filename) do
-  string = 'This is the sample text used for the text boxes. See how it ' \
-    'behave with the various overflow options used.'
-
-  text string
-
-  y_position = cursor - 20
-  %i[truncate expand shrink_to_fit].each_with_index do |mode, i|
-    text_box string, at: [i * 150, y_position],
-                     width: 100,
-                     height: 50,
-                     overflow: mode
-  end
-
-  string = 'If the box is too small for the text, :shrink_to_fit ' \
-    'can render the text in a really small font size.'
-
-  move_down 120
-  text string
-  y_position = cursor - 20
-  [nil, 8, 10, 12].each_with_index do |value, index|
-    text_box string, at: [index * 150, y_position],
-                     width: 50,
-                     height: 50,
-                     overflow: :shrink_to_fit,
-                     min_font_size: value
-  end
-end

data/manual/text/utf8.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-# Multilingualization isn't much of a problem on Prawn as its default encoding
-# is UTF-8. The only thing you need to worry about is if the font support the
-# glyphs of your language.
-
-require_relative '../example_helper'
-
-filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::ManualBuilder::Example.generate(filename) do
-  text 'Take this example, a simple Euro sign:'
-  text '€', size: 32
-  move_down 20
-
-  text 'This works, because €  is one of the few ' \
-    'non-ASCII glyphs supported in PDF built-in fonts.'
-
-  move_down 20
-
-  text 'For full internationalized text support, we need to use external fonts:'
-  move_down 20
-
-  font("#{Prawn::DATADIR}/fonts/DejaVuSans.ttf") do
-    text 'ὕαλον ϕαγεῖν δύναμαι· τοῦτο οὔ με βλάπτει.'
-    text 'There you go.'
-  end
-end

data/manual/text/win_ansi_charset.rb

@@ -1,62 +0,0 @@
-# frozen_string_literal: true
-
-# Prints a list of all of the glyphs that can be rendered by Adobe's built
-# in fonts, along with their character widths and WinAnsi codes.  Be sure
-# to pass these glyphs as UTF-8, and Prawn will transcode them for you.
-
-require_relative '../example_helper'
-
-filename = File.basename(__FILE__).gsub('.rb', '.pdf')
-Prawn::ManualBuilder::Example.generate(filename) do
-  FONT_SIZE = 9.5
-
-  x = 0
-  y = bounds.top
-
-  fields = [
-    [20, :right], [8, :left], [12, :center], [30, :right], [8, :left],
-    [0, :left]
-  ]
-
-  font 'Helvetica', size: FONT_SIZE
-
-  start_new_page
-
-  Prawn::Encoding::WinAnsi::CHARACTERS.each_with_index do |name, index|
-    next if name == '.notdef'
-
-    y -= FONT_SIZE
-
-    if y < FONT_SIZE
-      y = bounds.top - FONT_SIZE
-      x += 170
-    end
-
-    code = format('%<index>d.', index: index)
-    char = index.chr.force_encoding(::Encoding::Windows_1252)
-
-    width = 1000 * width_of(char, size: FONT_SIZE) / FONT_SIZE
-    size = format('%<width>d', width: width)
-
-    data = [code, nil, char, size, nil, name]
-    dx = x
-    fields.zip(data).each do |(total_width, align), field|
-      if field
-        width = width_of(field, size: FONT_SIZE)
-
-        case align
-        when :left   then offset = 0
-        when :right  then offset = total_width - width
-        when :center then offset = (total_width - width) / 2
-        end
-
-        text_box(
-          field.dup.force_encoding('windows-1252').encode('UTF-8'),
-          at: [dx + offset, y]
-        )
-      end
-
-      dx += total_width
-    end
-  end
-end

data/prawn.gemspec

@@ -1,57 +0,0 @@
-# frozen_string_literal: true
-
-basedir = __dir__
-
-require "#{basedir}/lib/prawn/version"
-
-Gem::Specification.new do |spec|
-  spec.name = 'prawn'
-  spec.version = Prawn::VERSION
-  spec.platform = Gem::Platform::RUBY
-  spec.summary = 'A fast and nimble PDF generator for Ruby'
-
-  spec.cert_chain = ['certs/pointlessone.pem']
-  if $PROGRAM_NAME.end_with? 'gem'
-    spec.signing_key = File.expand_path('~/.gem/gem-private_key.pem')
-  end
-
-  spec.files = Dir.glob('{examples,lib,spec,manual}/**/**/*') +
-    Dir.glob('data/fonts/{MustRead.html,*.afm}') +
-    [
-      'Rakefile', 'prawn.gemspec', 'Gemfile',
-      'COPYING', 'LICENSE', 'GPLv2', 'GPLv3',
-      '.yardopts'
-    ]
-  spec.require_path = 'lib'
-  spec.required_ruby_version = '~> 2.5'
-  spec.required_rubygems_version = '>= 1.3.6'
-
-  spec.authors = [
-    'Gregory Brown', 'Brad Ediger', 'Daniel Nelson', 'Jonathan Greenberg',
-    'James Healy'
-  ]
-  spec.email = [
-    'gregory.t.brown@gmail.com', 'brad@bradediger.com', 'dnelson@bluejade.com',
-    'greenberg@entryway.net', 'jimmy@deefa.com'
-  ]
-  spec.licenses = %w[PRAWN GPL-2.0 GPL-3.0]
-
-  spec.add_dependency('pdf-core', '~> 0.8.1')
-  spec.add_dependency('ttfunk', '~> 1.6')
-
-  spec.add_development_dependency('pdf-inspector', '>= 1.2.1', '< 2.0.a')
-  spec.add_development_dependency('pdf-reader', ['~> 1.4', '>= 1.4.1'])
-  spec.add_development_dependency('prawn-manual_builder', '>= 0.3.0')
-  spec.add_development_dependency('rake', '~> 12.0')
-  spec.add_development_dependency('rspec', '~> 3.0')
-  spec.add_development_dependency('rubocop', '~> 0.84.0')
-  spec.add_development_dependency('rubocop-performance', '~> 1.1')
-  spec.add_development_dependency('rubocop-rspec', '~> 1.32')
-  spec.add_development_dependency('simplecov')
-  spec.add_development_dependency('yard')
-
-  spec.homepage = 'http://prawnpdf.org'
-  spec.description = <<END_DESC
-  Prawn is a fast, tiny, and nimble PDF generator for Ruby
-END_DESC
-end

data/spec/data/curves.pdf

@@ -1,66 +0,0 @@
-%PDF-1.3
-%����
-1 0 obj
-<< /Creator (Prawn)
-/Producer (Prawn)
->>
-endobj
-2 0 obj
-<< /Type /Pages
-/Count 1
-/Kids [5 0 R]
->>
-endobj
-3 0 obj
-<< /Type /Catalog
-/Pages 2 0 R
->>
-endobj
-4 0 obj
-<< /Length 380
->>
-stream
-/DeviceRGB cs
-0.000 0.000 0.000 scn
-/DeviceRGB CS
-0.000 0.000 0.000 SCN
-q
-136.000 136.000 m
-96.000 126.000 96.000 126.000 86.000 86.000 c
-S
-246.000 236.000 m
-246.000 241.523 241.523 246.000 236.000 246.000 c
-230.477 246.000 226.000 241.523 226.000 236.000 c
-226.000 230.477 230.477 226.000 236.000 226.000 c
-241.523 226.000 246.000 230.477 246.000 236.000 c
-236.000 236.000 m
-f
-Q
-
-endstream
-endobj
-5 0 obj
-<< /Type /Page
-/Parent 2 0 R
-/MediaBox [0 0 612.0 792.0]
-/Contents 4 0 R
-/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI]
->>
->>
-endobj
-xref
-0 6
-0000000000 65535 f 
-0000000015 00000 n 
-0000000071 00000 n 
-0000000128 00000 n 
-0000000177 00000 n 
-0000000608 00000 n 
-trailer
-<< /Size 6
-/Root 3 0 R
-/Info 1 0 R
->>
-startxref
-762
-%%EOF

data/spec/extensions/encoding_helpers.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module EncodingHelpers
-  def win1252_string(str)
-    str.dup.force_encoding(Encoding::Windows_1252)
-  end
-
-  def bin_string(str)
-    str.dup.force_encoding(Encoding::ASCII_8BIT)
-  end
-end