dinbrief 0.0.1 → 0.9.0

data/README.textile

@@ -2,7 +2,7 @@ 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.
+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 5008</a> standard.
 
 It is (mainly) a semantic DSL on top of <a href="http://prawn.majesticseacreature.com/" target="_blank">Prawn 1.x</a>.
 
@@ -115,9 +115,37 @@ But, as always, things may be more complicated, and you may want to add fancy pd
 
 The result then looks a little bit like this:
 
-<img src="https://github.com/provideal/dinbrief/raw/master/example/example.png" />
+<img src="https://github.com/metaminded/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.
+If you're unhappy with the default info block, you may call <tt>info</tt> giving either a string:
+
+<pre>
+  MyLetter.letter('more_serious.pdf') do |db|
+    db.return_address 'metaminded UG – Ulmer Straße 176 – 73233 Aalen'
+    db.subject        "Thanks a lot for giving us Rails"
+    db.info           "Thing: something\nStuff: somestuff"
+    ...
+</pre>
+
+or – even more advanced – a block as with the <tt>body</tt> method:
+
+<pre>
+  MyLetter.letter('more_serious.pdf') do |db|
+    db.return_address 'metaminded UG – Ulmer Straße 176 – 73233 Aalen'
+    db.subject        "Thanks a lot for giving us Rails"
+    db.info do |box|
+      4.times do |i|
+        box.text "Line #{i}", size: 10.pt
+      end
+    end
+    ...
+</pre>
+
+inside the block, you may use virtually every prawn method. If <tt>info</tt> is given, all other info-methods (as <tt>yourmessage</tt>, <tt>oursign</tt> and the like) are disabled.
+
+h2. 
+
+Almost every property (positions, sizes, fontsizes, ...) of an element is defined in <tt>lib/dinbrief/letter/constants.rb</tt>, and can be overridden in your subclass.
 
 h2. Disclaimer
 
@@ -128,7 +156,7 @@ 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
+* Check out the <a href="https://github.com/metaminded/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

data/dinbrief.gemspec

@@ -5,11 +5,11 @@ 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.authors     = ["Peter Horn, metaminded"]
+  s.email       = ["peter.horn@metaminded.com"]
+  s.homepage    = "http://github.com/metaminded/dinbrief"
   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.description = %q{DIN Brief gem for Prawn. Creating letters that confirm to the DIN 5008 specifications.}
 
   s.rubyforge_project = "dinbrief"
 

data/example/more_serious.rb

@@ -55,6 +55,7 @@ MyLetter.letter('more_serious.pdf') do |db|
   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.info do |box| 4.times do |i| box.text "Line #{i}", size: 10.pt end end
   db.body do |letter|
     letter.text %{Dear David and all you colleagues,
 

data/lib/dinbrief/letter/constants.rb

@@ -50,6 +50,7 @@ class Dinbrief::Letter
     :info_block_x        => 125.mm,
     :info_block_y        => -45.mm,
     :info_block_width    => 75.mm,
+    :info_block_height   => 40.mm,
     :info_block_fontsize => 9.pt,
 
     # Date

data/lib/dinbrief/letter/typeset_methods.rb

@@ -5,16 +5,28 @@ 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
-    )
+    bounding_box([info_block_x, info_block_y],
+      :width => info_block_width,
+      :height => info_block_height
+    ) do
+      #stroke_bounds
+      i = lb_get(:info)
+      case i
+      when String
+        text i, :size => info_block_fontsize
+      when Proc
+        i.(self)
+      else
+        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 info,
+          :size => info_block_fontsize
+      end
+    end
     date = lb_get(:date) || Time.now.strftime("%d.%m.%Y")
     text_box("#{InfoTranslations[:date]}: #{date}",
       :at => [date_x, date_y],

data/lib/dinbrief/letter.rb

@@ -4,20 +4,32 @@ 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)
+    def self.letter(pdf_or_filename, options={}, &block)
+      case pdf_or_filename
+      when Dinbrief::Letter
+        make_letter(pdf_or_filename, &block)
+        pdf_or_filename
+      when Prawn::Document
+        raise "Give an instance of Dinbrief::Letter to letter method."
+      when String
+        self.generate(pdf_or_filename, DocumentDefaults.merge(options)) do |pdf|
+          make_letter(pdf, &block)
         end
-        letter.typeset_body
-        letter.add_page_numbers
       end
     end
 
+    def self.make_letter(letter, &block)
+      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
+
     def add_page_numbers
       if show_page_numbers?
         number_pages page_numbering_string, {

data/lib/dinbrief/letter_builder.rb

@@ -22,5 +22,9 @@ module Dinbrief
       @body = block_given? ? block : b
     end
 
+    def info(b=nil, &block)
+      @info = block_given? ? block : b
+    end
+
   end
 end

data/lib/dinbrief/version.rb

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

metadata

@@ -1,19 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: dinbrief
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.9.0
   prerelease: 
 platform: ruby
 authors:
-- Peter Horn
+- Peter Horn, metaminded
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-01-04 00:00:00.000000000 Z
+date: 2012-01-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: prawn
-  requirement: &70283461717780 !ruby/object:Gem::Requirement
+  requirement: &70351984540660 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -21,11 +21,11 @@ dependencies:
         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.
+  version_requirements: *70351984540660
+description: DIN Brief gem for Prawn. Creating letters that confirm to the DIN 5008
+  specifications.
 email:
-- peter.horn@provideal.net
+- peter.horn@metaminded.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -47,7 +47,7 @@ files:
 - lib/dinbrief/letter/typeset_methods.rb
 - lib/dinbrief/letter_builder.rb
 - lib/dinbrief/version.rb
-homepage: ''
+homepage: http://github.com/metaminded/dinbrief
 licenses: []
 post_install_message: 
 rdoc_options: []