dinbrief 0.0.1

data/.gitignore

@@ -0,0 +1,8 @@
+pkg
+dinbrief-*.gem
+Gemfile.lock
+.DS_Store
+.bundle
+.rvmrc
+spec/dummy_app/tmp/*
+example/hello.pdf

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in dinbrief.gemspec
+gemspec

data/README.textile

@@ -0,0 +1,147 @@
+h1. DIN Brief gem for prawn.
+
+h2. Mission Objective
+
+This gem tries to make producing letters from Ruby apps simpler. The resulting letter mostly meet the <a href="http://de.wikipedia.org/wiki/DIN_5008" target="_blank">DIN 2008</a> standard.
+
+It is (mainly) a semantic DSL on top of <a href="http://prawn.majesticseacreature.com/" target="_blank">Prawn 1.x</a>.
+
+The name <i>dinbrief</i> was chosen as a tribute to the <a href="http://ctan.org/tex-archive/macros/latex/contrib/dinbrief" target="_blank">dinbrief LaTeX package</a>, which it replaces in my projects.
+
+h2. Example
+
+To get the headers and footers right for your company, you should subclass <tt>Dinbrief::Letter</tt>:
+
+<pre>
+  class MyLetter < Dinbrief::Letter
+    # define a header
+    def header
+      image(File.join("my_logo_.png"),
+        :at => [0.mm, 35.mm],
+        :fit => [80.mm, 22.mm]
+      )
+      text_box(%{My Company
+        Some Road 23
+        12345 Rubycity
+
+        www.my-company.com
+      },
+        :at => [105.mm, 35.mm],
+        :width => 85.mm,
+        :align => :left,
+        :size => 10.pt
+      )
+    end
+
+    # define a footer
+    def footer
+      text_box(%{My Company Ltd. – Some Road 23 – 12345 Rubycity
+        more infos as requred by law
+      },
+        :at => [20.mm, 12.mm],
+        :width => 140.mm,
+        :align => :center,
+        :size => 8.pt,
+      )
+    end
+  end
+</pre>
+
+(Note: If you don't implement these functions you'll get some sample header and footer with additional information.)
+
+Then, you can use this class to actually typeset your letters:
+
+<pre>
+  MyLetter.letter('more_serious.pdf') do |db|
+    db.return_address 'metaminded UG – Ulmer Straße 176 – 73233 Aalen'
+    db.oursign        "PH"
+    db.yoursign       "DHH"
+    db.yourmessage    "24.12.2011"
+    db.name           "Dr. Peter Horn"
+    db.phone          "05604 - 919937"
+    db.fax            "05604 - 919938"
+    db.email          "ph@metaminded.com"
+    db.address        "David Heinemeier-Hansson\n37signals, LLC\n30 North Racine Avenue #200\nChicago, Illinois 60607\nUSA"
+    db.subject        "Thanks a lot for giving us Rails"
+    db.body <<-TEXT
+      Dear David and all you colleagues,
+
+      Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+      ...
+
+      Curabitur ullamcorper ultricies nisi. Nam eget dui.
+
+      Best Regards,
+    TEXT
+  end
+</pre>
+
+But, as always, things may be more complicated, and you may want to add fancy pdf things or generate the letter (from, e.g., an order object), so you can give a block to the body:
+
+<pre>
+  MyLetter.letter('more_serious.pdf') do |db|
+    db.return_address 'metaminded UG – Ulmer Straße 176 – 73233 Aalen'
+    # ... as above ...
+    db.subject        "Thanks a lot for giving us Rails"
+    db.body do |letter|
+      letter.text %{Dear David and all you colleagues,
+
+        Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+        To impress people, I add a useless table:
+        }
+
+      letter.table [["Animal", "Programming Language", "coincidence"],
+        ["Penguin",  "C",      "213" ],
+        ["Platypus", "ObjC",   "143" ],
+        ["Cat",      "Ruby",   "47"  ],
+        ["Dog",      "Python", "23"  ],
+        ["Olm",      "PHP",    "876" ]
+      ]
+
+      letter.text %{
+        Cras dapibus. Vivamus elementum semper nisi. Aenean vulputate eleifend tellus. Aenean leo ligula, porttitor eu, consequat vitae, eleifend ac, enim. Aliquam lorem ante, dapibus in, viverra quis, feugiat a, tellus. Phasellus viverra nulla ut metus varius laoreet. Quisque rutrum.
+
+        Curabitur ullamcorper ultricies nisi. Nam eget dui.
+
+        Best Regards,
+      }
+
+      letter.image("signature.png", :fit => [3.cm, 3.cm])
+    end
+  end
+</pre>
+
+The result then looks a little bit like this:
+
+<img src="https://github.com/provideal/dinbrief/raw/master/example/example.png" />
+
+Almost every property of an element is defined in <tt>lib/dinbrief/letter/constants.rb</tt>, and can be overridden in your subclass.
+
+h2. Disclaimer
+
+This is pretty much work-in-progress-without-reasonable-documentation. So if you use it, don't complain ;)
+
+Nevertheless, bug reports and improvements are highly appreciated:
+
+h2. Contributing to dinbrief
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the <a href="https://github.com/provideal/dinbrief/issues">issue tracker</a> to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+* Feel free to send a pull request if you think others (me, for example) would like to have your change incorporated into future versions of dinbrief.
+
+h2. License
+
+Copyright (c) 2011-2012 Peter Horn, <a href="http://www.metaminded.com" target="_blank">metaminded UG</a>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/dinbrief.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "dinbrief/version"
+
+Gem::Specification.new do |s|
+  s.name        = "dinbrief"
+  s.version     = Dinbrief::VERSION
+  s.authors     = ["Peter Horn"]
+  s.email       = ["peter.horn@provideal.net"]
+  s.homepage    = ""
+  s.summary     = %q{DIN Letter gem for Prawn}
+  s.description = %q{DIN Brief gem for Prawn. Creating letters that confirm to the DIN specifications. For Ruby.}
+
+  s.rubyforge_project = "dinbrief"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "prawn", "1.0.0.rc1"
+  # s.add_runtime_dependency "rest-client"
+end

data/example/hello.rb

@@ -0,0 +1,53 @@
+# encoding: utf-8
+
+require 'dinbrief'
+
+Dinbrief.letter('hello.pdf') do |db|
+  db.return_address 'metaminded UG – Ulmer Straße 176 – 73233 Aalen'
+  db.oursign        "PH"
+  db.yoursign       "DHH"
+  db.yourmessage    "24.12.2011"
+  db.name           "Dr. Peter Horn"
+  db.phone          "05604 - 919937"
+  db.fax            "05604 - 919938"
+  db.email          "ph@metaminded.com"
+  db.address        "David Heinemeier-Hansson\n37signals, LLC\n30 North Racine Avenue #200\nChicago, Illinois 60607\nUSA"
+  db.subject        "Thanks a lot for giving us Rails"
+  db.body <<-TEXT
+  Dear David and all you colleagues,
+
+  Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+  Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+  Adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco.
+
+  Laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+  Reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+  Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque eu, pretium quis, sem. Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu. In enim justo, rhoncus ut, imperdiet a, venenatis vitae, justo. Nullam dictum felis eu pede mollis pretium. Integer tincidunt.
+
+  Cras dapibus. Vivamus elementum semper nisi. Aenean vulputate eleifend tellus. Aenean leo ligula, porttitor eu, consequat vitae, eleifend ac, enim. Aliquam lorem ante, dapibus in, viverra quis, feugiat a, tellus. Phasellus viverra nulla ut metus varius laoreet. Quisque rutrum.
+
+  Aenean imperdiet. Etiam ultricies nisi vel augue. Curabitur ullamcorper ultricies nisi. Nam eget dui. Etiam rhoncus. Maecenas tempus, tellus eget condimentum rhoncus, sem quam semper libero, sit amet adipiscing sem neque sed ipsum. Nam quam nunc, blandit vel, luctus pulvinar, hendrerit id, lorem. Maecenas nec odio et ante tincidunt tempus. Donec vitae sapien ut libero venenatis faucibus. Nullam quis ante. Etiam sit amet orci eget eros faucibus tincidunt. Duis leo. Sed fringilla mauris sit amet nibh. Donec sodales sagittis magna.
+
+  Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+  Adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco.
+
+  Laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+  Reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+  Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque eu, pretium quis, sem. Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu. In enim justo, rhoncus ut, imperdiet a, venenatis vitae, justo. Nullam dictum felis eu pede mollis pretium. Integer tincidunt.
+
+  Cras dapibus. Vivamus elementum semper nisi. Aenean vulputate eleifend tellus. Aenean leo ligula, porttitor eu, consequat vitae, eleifend ac, enim. Aliquam lorem ante, dapibus in, viverra quis, feugiat a, tellus. Phasellus viverra nulla ut metus varius laoreet. Quisque rutrum.
+
+  Curabitur ullamcorper ultricies nisi. Nam eget dui.
+
+  Best Regards,
+
+  TEXT
+end
+

data/example/more_serious.rb

@@ -0,0 +1,86 @@
+# encoding: utf-8
+
+require 'dinbrief'
+
+#
+# Firstly, subclass Dinbrief::Letter to get the header/footer
+# stuff sorted out.
+#
+class MyLetter < Dinbrief::Letter
+  # define a header
+  def header
+    image(File.join(File.dirname(__FILE__), "metaminded.png"),
+      :at => [0.mm, 35.mm],
+      :fit => [80.mm, 22.mm]
+    )
+    text_box(%{metaminded UG (haftungsbeschränkt)
+      Ulmer Str. 124
+      im Wi.Z
+      73431 Aalen
+
+      www.metaminded.com
+    },
+      :at => [105.mm, 35.mm],
+      :width => 85.mm,
+      :align => :left,
+      :size => 10.pt
+    )
+  end
+
+  # define a footer
+  def footer
+    text_box(%{metaminded UG (haftungsbeschränkt) – Ulmer Str. 124 – 73431 Aalen
+    Handelsregisternummer: HRB 724169 – Registergericht: Amtsgericht Ulm/Donau – USt.ID.: DE267558458
+    Geschäftsführer: Dr. Peter Horn
+    },
+      :at => [20.mm, 12.mm],
+      :width => 140.mm,
+      :align => :center,
+      :size => 8.pt,
+    )
+  end
+end
+
+#
+# then, use this subclass to render the actual letter
+#
+MyLetter.letter('more_serious.pdf') do |db|
+  db.return_address 'metaminded UG – Ulmer Straße 176 – 73233 Aalen'
+  db.oursign        "PH"
+  db.yoursign       "DHH"
+  db.yourmessage    "24.12.2011"
+  db.name           "Dr. Peter Horn"
+  db.phone          "05604 - 919937"
+  db.fax            "05604 - 919938"
+  db.email          "ph@metaminded.com"
+  db.address        "David Heinemeier-Hansson\n37signals, LLC\n30 North Racine Avenue #200\nChicago, Illinois 60607\nUSA"
+  db.subject        "Thanks a lot for giving us Rails"
+  db.body do |letter|
+    letter.text %{Dear David and all you colleagues,
+
+      Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+      To impress people, I add a useless table:
+      }
+
+    letter.table [["Animal", "Programming Language", "coincidence"],
+      ["Penguin",  "C",      "213" ],
+      ["Platypus", "ObjC",   "143" ],
+      ["Cat",      "Ruby",   "47"  ],
+      ["Dog",      "Python", "23"  ],
+      ["Olm",      "PHP",    "876" ]
+    ]
+
+    letter.text %{
+      Cras dapibus. Vivamus elementum semper nisi. Aenean vulputate eleifend tellus. Aenean leo ligula, porttitor eu, consequat vitae, eleifend ac, enim. Aliquam lorem ante, dapibus in, viverra quis, feugiat a, tellus. Phasellus viverra nulla ut metus varius laoreet. Quisque rutrum.
+
+      Curabitur ullamcorper ultricies nisi. Nam eget dui.
+
+      Best Regards,
+    }
+
+    letter.image(File.join(File.dirname(__FILE__), "signature.png"), :fit => [3.cm, 3.cm])
+
+  end
+end
+

data/lib/dinbrief.rb

@@ -0,0 +1,16 @@
+# encoding: utf-8
+
+require 'prawn'
+require 'prawn/measurement_extensions'
+
+module Dinbrief
+
+  def self.letter(*args, &block)
+    Letter.letter(*args, &block)
+  end
+
+end
+
+require 'dinbrief/version'
+require 'dinbrief/letter'
+require 'dinbrief/letter_builder'

data/lib/dinbrief/letter.rb

@@ -0,0 +1,47 @@
+# encoding: utf-8
+
+module Dinbrief
+
+  class Letter < Prawn::Document
+
+    def self.letter(filename,options={},&block)
+      self.generate(filename, DocumentDefaults.merge(options)) do |letter|
+        yield(letter.letter_builder)
+        letter.meta_header()
+        letter.meta_footer()
+        letter.methods.map(&:to_s).select{|m|m.start_with?("typeset_")}.each do |m|
+          next if m=='typeset_body'
+          letter.send(m)
+        end
+        letter.typeset_body
+        letter.add_page_numbers
+      end
+    end
+
+    def add_page_numbers
+      if show_page_numbers?
+        number_pages page_numbering_string, {
+          :start_count_at => 1,
+          :page_filter    => :all, #[2..9999],
+          :at             => [page_numbering_x, page_numbering_y],
+          :align          => page_numbering_align,
+          :size           => page_numbering_fontsize,
+          :width          => page_numbering_width
+        }
+      end
+    end
+
+    def letter_builder()
+      @letter_builder ||= LetterBuilder.new(self)
+    end
+
+    def lb_get(nam)
+      @letter_builder.instance_variable_get("@#{nam}")
+    end
+
+  end
+end
+
+require 'dinbrief/letter/constants'
+require 'dinbrief/letter/typeset_methods'
+require 'dinbrief/letter/design_elements'

data/lib/dinbrief/letter/constants.rb

@@ -0,0 +1,135 @@
+#encoding: utf-8
+
+class Dinbrief::Letter
+
+  DocumentDefaults = {                # The following options are available (with the default values marked in [])
+    :page_size          => 'A4',      # One of the Document::PageGeometry sizes [LETTER]
+    :page_layout        => :portrait, # Either :portrait or :landscape
+    :left_margin        => 25.mm,      # Sets the left margin in points [0.5 inch]
+    :right_margin       => 20.mm,      # Sets the right margin in points [0.5 inch]
+    :top_margin         => 30.mm,      # Sets the top margin in points [0.5 inch]
+    :bottom_margin      => 3.cm,      # Sets the bottom margin in points [0.5 inch]
+    :skip_page_creation => false,     # Creates a document without starting the first page [false]
+    :compress           => false,     # Compresses content streams before rendering them [false]
+    :optimize_objects   => false,     # Reduce number of PDF objects in output, at expense of render time [false]
+    :background         => nil,       # An image path to be used as background on all pages [nil]
+    :info               => nil,       # Generic hash allowing for custom metadata properties [nil]
+    :template           => nil        # The path to an existing PDF file to use as a template [nil]
+  }
+
+  MeasurementDefaults = {
+    # Folding Marks
+    :fold_mark_1_y    => 87.mm,
+    :fold_mark_2_y    => -105.mm,
+    :fold_mark_x      => 5.mm,
+    :fold_mark_width  => 5.mm,
+    :punch_mark_y     => 148.5.mm,
+    :punch_mark_x     => 5.mm,
+    :punch_mark_width => 5.mm,
+
+    # Return Address Field
+    :return_address_x          => 20.mm,
+    :return_address_y          => -45.mm - 10.mm,
+    :return_address_rule_x     => 20.mm,
+    :return_address_rule_y     => -45.mm - 14.mm,
+    :return_address_rule_width => 85.mm,
+    :return_address_rule_linewidth => 0.5.pt,
+    :return_address_fontsize   => 8.pt,
+    :return_address_align      => :center,
+    :return_address_width      => 85.mm,
+
+    # Address Field
+    :address_x          => 25.mm,
+    :address_y          => -45.mm - 17.mm,
+    :address_width      => 80.mm,
+    :address_height     => 28.mm,
+    :address_fontsize   => 10.pt,
+    :address_valign     => :center,
+
+    # Info Block
+    :info_block_x        => 125.mm,
+    :info_block_y        => -45.mm,
+    :info_block_width    => 75.mm,
+    :info_block_fontsize => 9.pt,
+
+    # Date
+    :date_x        => 125.mm,
+    :date_y        => -87.mm,
+    :date_fontsize => 10.pt,
+
+    # Subject
+    :subject_x        => 25.mm,
+    :subject_y        => - 105.mm + 2.mm,
+    :subject_fontsize => 11.pt,
+    :subject_style    => :bold,
+
+    # Body
+    :body_fontsize => 10.pt,
+    :body_style    => nil,
+    :body_preskip  => 105.mm - 30.mm + 6.mm,
+
+    # Header
+    :header_x      => 20.mm,
+    :header_y      => 297.mm,
+    :header_width  => 210.mm-30.mm,
+    :header_height => 45.mm,
+
+    # Footer
+    :footer_x      => 20.mm,
+    :footer_y      => 22.mm,
+    :footer_width  => 210.mm-30.mm,
+    :footer_height => 12.mm,
+
+    # Page Numbering
+    :page_numbering_string => "<page>/<total>",
+    :page_numbering_x      => 180.mm,
+    :page_numbering_y      => 26.mm,
+    :page_numbering_width  => 10.mm,
+    :page_numbering_align  => :right,
+    :page_numbering_fontsize => 10.pt
+  }
+
+  MeasurementDefaults.each do |n,v|
+    nn = n.to_s
+    define_method(nn) do
+      v = MeasurementDefaults[n]
+      if nn.end_with?('_x')
+        (v < 0 ? 210.mm : 0) + v - DocumentDefaults[:left_margin]
+      elsif nn.end_with?('_y')
+        (v < 0 ? 297.mm : 0) + v - DocumentDefaults[:bottom_margin]
+      else
+        v
+      end
+    end
+  end
+
+  LetterDefaults = {
+    :show_fold_tics           => true,
+    :show_punch_tic           => true,
+    :show_return_address_rule => true,
+    :show_page_numbers        => true
+  }
+
+  LetterDefaults.each do |n,v|
+    nn = n.to_s
+    define_method(nn) do LetterDefaults[n] end
+    if nn.start_with?("show_")
+      define_method("#{nn}?") do LetterDefaults[n] end
+      define_method("#{nn}!") do LetterDefaults[n] = true end
+      define_method("hide_#{nn[5..-1]}!") do LetterDefaults[n] = false end
+    end
+  end
+
+  InfoTranslations = {
+    :yoursign     => 'Ihr Zeichen',
+    :yourmessage  => 'Ihre Nachricht vom',
+    :oursign      => 'Unser Zeichen',
+    :ourmessage   => 'Unsere Nachricht vom',
+    :name         => 'Name',
+    :phone        => 'Telefon',
+    :fax          => 'Telefax',
+    :email        => 'E-Mail',
+    :date         => 'Datum'
+  }
+
+end

data/lib/dinbrief/letter/design_elements.rb

@@ -0,0 +1,69 @@
+#encoding: utf-8
+
+class Dinbrief::Letter
+
+  #
+  # creates a header bounding box on the top of the page and
+  # renders some dummy content. If a 'header' method is implemented,
+  # it's called, so you can easily define your own header.
+  #
+  def meta_header
+    bounding_box([header_x, header_y],
+      :width => header_width,
+      :height => header_height
+    ) do |pdf|
+      if self.respond_to? :header
+        header()
+      else
+        line_width 0.1.pt
+        stroke_bounds
+        text_box("DIN Brief Letter\na Ruby GEM for Prawn",
+          :at => [0.mm, 35.mm],
+          :size => 16.pt
+        )
+        draw_text("© 2011–#{Time.now.year} Peter Horn, metaminded UG",
+          :at => [0.mm, 13.mm],
+          :size => 10.pt
+        )
+        text_box(%{To replace this default header by yours,
+          just implement a 'header' function in your Dinbrief::Letter
+          subclass and draw whatever you like.
+          There, you are inside this bordered box with [0,0] being
+          the lower left corner.},
+          :at => [85.mm, 35.mm],
+          :width => 90.mm,
+          :align => :left,
+          :size => 10.pt,
+          :font => "Times-Roman"
+
+        )
+      end
+    end
+  end
+
+  #
+  # creates a footer bounding box on the bottom of the page and
+  # renders some dummy content. If a 'footer' method is implemented,
+  # it's called, so you can easily define your own footer.
+  #
+  def meta_footer()
+    bounding_box([footer_x, footer_y],
+      :width => footer_width,
+      :height => footer_height
+    ) do |pdf|
+      if self.respond_to? :footer
+        footer()
+      else
+        line_width 0.1.pt
+        stroke_bounds
+        text_box(%{To replace this default footer by yours, just implement a 'footer' function in your Dinbrief::Letter subclass and draw whatever you like. There, you are inside this bordered box with [0,0] being the lower left corner.
+          © 2011–#{Time.now.year} Peter Horn, metaminded UG},
+          :at => [20.mm, 12.mm],
+          :width => 140.mm,
+          :align => :center,
+          :size => 8.pt,
+        )
+      end
+    end
+  end
+end

data/lib/dinbrief/letter/typeset_methods.rb

@@ -0,0 +1,104 @@
+#encoding: utf-8
+
+class Dinbrief::Letter
+  #
+  # typeset info block (sign, name, phone...)
+  #
+  def typeset_info
+    info = [:yoursign, :yourmessage, :oursign, :ourmessage,
+    :name, :phone, :fax, :email].map do |nam|
+      iv = lb_get nam
+      iv ? "#{InfoTranslations[nam]}: #{iv}" : nil
+    end.compact.join("\n")
+    return unless info
+    text_box(info,
+      :at => [info_block_x, info_block_y],
+      :size => info_block_fontsize
+    )
+    date = lb_get(:date) || Time.now.strftime("%d.%m.%Y")
+    text_box("#{InfoTranslations[:date]}: #{date}",
+      :at => [date_x, date_y],
+      :size => date_fontsize
+    )
+  end
+
+  #
+  # typeset rerturn address above address field
+  #
+  def typeset_return_address
+    return unless lb_get(:return_address)
+    bounding_box([return_address_x, return_address_y],
+      :width => return_address_width,
+      :height => 5.mm
+    ) do
+      text(lb_get(:return_address),
+        :size => return_address_fontsize,
+        :align => return_address_align
+      )
+    end
+    return unless show_return_address_rule?
+    line_width return_address_rule_linewidth
+    line(
+      [return_address_rule_x, return_address_rule_y],
+      [return_address_rule_x + return_address_rule_width, return_address_rule_y]
+    )
+    stroke
+  end
+
+  #
+  # draw the fold- and punchmarks
+  #
+  def typeset_marks
+    line_width(0.2)
+    if show_fold_tics?
+      line([fold_mark_x, fold_mark_1_y], [fold_mark_x+fold_mark_width, fold_mark_1_y])
+      line([fold_mark_x, fold_mark_2_y], [fold_mark_x+fold_mark_width, fold_mark_2_y])
+    end
+    if show_punch_tic?
+      line([punch_mark_x, punch_mark_y], [punch_mark_x+punch_mark_width, punch_mark_y])
+    end
+    stroke
+  end
+
+  #
+  # typeset the recipients address
+  #
+  def typeset_address
+    raise "An address should be given." unless lb_get(:address)
+    bounding_box([address_x, address_y],
+      :width => address_width,
+      :height => address_height,
+      :valign => address_valign,
+    ) do
+      text(lb_get(:address),
+        :size => address_fontsize
+      )
+    end
+  end
+
+  def typeset_subject
+    return unless lb_get(:subject)
+    text_box(lb_get(:subject),
+      :at => [subject_x, subject_y],
+      :size => subject_fontsize,
+      :style => subject_style
+    )
+  end
+
+  def typeset_body
+    gbody = lb_get(:body)
+    raise "A body should be given." unless gbody
+    move_cursor_to bounds.height
+    move_down body_preskip
+    if gbody.respond_to?(:call)
+      font_size(body_fontsize)
+      #font_style(body_style)
+      gbody.call(self)
+    else
+      text(gbody.strip,
+        :size => body_fontsize,
+        :style => body_style
+      )
+    end
+  end
+end

data/lib/dinbrief/letter_builder.rb

@@ -0,0 +1,26 @@
+#encoding: utf-8
+
+module Dinbrief
+  class LetterBuilder
+
+    def initialize(letter=nil)
+      @letter = letter
+    end
+
+    [
+      :subject, :header, :return_address, :address,
+      :yoursign, :yourmessage, :oursign, :ourmessage,
+      :name, :phone, :fax, :email,
+      :date
+    ].each do |nam|
+      define_method nam do |s|
+        instance_variable_set("@#{nam}", s)
+      end
+    end
+
+    def body(b=nil, &block)
+      @body = block_given? ? block : b
+    end
+
+  end
+end

data/lib/dinbrief/version.rb

@@ -0,0 +1,3 @@
+module Dinbrief
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: dinbrief
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Peter Horn
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-01-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: prawn
+  requirement: &70283461717780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - =
+      - !ruby/object:Gem::Version
+        version: 1.0.0.rc1
+  type: :development
+  prerelease: false
+  version_requirements: *70283461717780
+description: DIN Brief gem for Prawn. Creating letters that confirm to the DIN specifications.
+  For Ruby.
+email:
+- peter.horn@provideal.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.textile
+- Rakefile
+- dinbrief.gemspec
+- example/example.png
+- example/hello.rb
+- example/metaminded.png
+- example/more_serious.rb
+- example/signature.png
+- lib/dinbrief.rb
+- lib/dinbrief/letter.rb
+- lib/dinbrief/letter/constants.rb
+- lib/dinbrief/letter/design_elements.rb
+- lib/dinbrief/letter/typeset_methods.rb
+- lib/dinbrief/letter_builder.rb
+- lib/dinbrief/version.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: dinbrief
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: DIN Letter gem for Prawn
+test_files: []