rrtf 0.1.2 → 1.0.0

data/lib/rrtf/version.rb

@@ -1,3 +1,3 @@
 module RRTF
-  VERSION = "0.1.2"
+  VERSION = "1.0.0"
 end

data/rrtf.gemspec

@@ -28,4 +28,5 @@ Gem::Specification.new do |spec|
   # Required for HTML converter functionality
   spec.add_dependency "nokogiri"
   spec.add_dependency "tidy"
+  spec.add_dependency "fastimage"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rrtf
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 1.0.0
 platform: ruby
 authors:
 - Wesley Hileman
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-07-24 00:00:00.000000000 Z
+date: 2017-08-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -108,6 +108,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: fastimage
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: 
 email:
 - whileman133@gmail.com
@@ -119,6 +133,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -126,6 +141,9 @@ files:
 - bin/console
 - bin/setup
 - documentation/RRTF.html
+- documentation/RRTF/AnonymousStyle.html
+- documentation/RRTF/BorderFormatting.html
+- documentation/RRTF/BorderStyle.html
 - documentation/RRTF/CharacterFormatting.html
 - documentation/RRTF/CharacterStyle.html
 - documentation/RRTF/Colour.html
@@ -138,10 +156,14 @@ files:
 - documentation/RRTF/Converters/HTML/Node.html
 - documentation/RRTF/Converters/HTML/NodeSet.html
 - documentation/RRTF/Document.html
+- documentation/RRTF/DocumentFormatting.html
+- documentation/RRTF/DocumentProperties.html
 - documentation/RRTF/DocumentStyle.html
 - documentation/RRTF/Font.html
 - documentation/RRTF/FontTable.html
 - documentation/RRTF/FooterNode.html
+- documentation/RRTF/GeometryNode.html
+- documentation/RRTF/GeometryProperties.html
 - documentation/RRTF/HeaderNode.html
 - documentation/RRTF/ImageNode.html
 - documentation/RRTF/Information.html
@@ -154,11 +176,20 @@ files:
 - documentation/RRTF/ListTemplate.html
 - documentation/RRTF/ListTextNode.html
 - documentation/RRTF/Node.html
+- documentation/RRTF/Page.html
+- documentation/RRTF/Page/Margin.html
+- documentation/RRTF/Page/Size.html
+- documentation/RRTF/PageFormatting.html
 - documentation/RRTF/Paper.html
 - documentation/RRTF/ParagraphFormatting.html
 - documentation/RRTF/ParagraphNode.html
 - documentation/RRTF/ParagraphStyle.html
+- documentation/RRTF/PositionFormatting.html
+- documentation/RRTF/PositionStyle.html
+- documentation/RRTF/Properties.html
 - documentation/RRTF/RTFError.html
+- documentation/RRTF/ShadingFormatting.html
+- documentation/RRTF/ShadingStyle.html
 - documentation/RRTF/Style.html
 - documentation/RRTF/Stylesheet.html
 - documentation/RRTF/TableCellNode.html
@@ -181,28 +212,72 @@ files:
 - documentation/method_list.html
 - documentation/top-level-namespace.html
 - examples/01.rtf
-- examples/01_mac_libreoffice5_2_3_3.png
-- examples/01_mac_pages6_2.png
-- examples/01_mac_textedit1_12.png
-- examples/01_mac_word15_36.png
-- examples/01_styles_and_paragraphs.rb
+- examples/01_everything.rb
+- examples/02.rtf
+- examples/02_basic_paragraph.rb
+- examples/03.rtf
+- examples/03_paragraph_inline_style.rb
+- examples/04.rtf
+- examples/04_paragraph_with_character_style.rb
+- examples/05.rtf
+- examples/05_hyperlinks.rb
+- examples/06.rtf
+- examples/06_basic_list.rb
+- examples/07.rtf
+- examples/07_nested_list.rb
+- examples/08.rtf
+- examples/08_images.rb
+- examples/09.rtf
+- examples/09_shapes.rb
+- examples/10.rtf
+- examples/10_stylesheet.rb
+- examples/resources/images/redshirt.png
+- examples/resources/images/redshirts.jpg
 - examples/resources/json/redshirt_styles.json
+- examples/~$01.rtf
 - lib/rrtf.rb
 - lib/rrtf/colour.rb
 - lib/rrtf/converters.rb
 - lib/rrtf/converters/html.rb
 - lib/rrtf/font.rb
+- lib/rrtf/formatting.rb
 - lib/rrtf/information.rb
 - lib/rrtf/list.rb
 - lib/rrtf/node.rb
-- lib/rrtf/paper.rb
+- lib/rrtf/node/command_node.rb
+- lib/rrtf/node/container_node.rb
+- lib/rrtf/node/document.rb
+- lib/rrtf/node/footer_node.rb
+- lib/rrtf/node/geometry_node.rb
+- lib/rrtf/node/header_node.rb
+- lib/rrtf/node/image_node.rb
+- lib/rrtf/node/link_node.rb
+- lib/rrtf/node/list_level_node.rb
+- lib/rrtf/node/list_node.rb
+- lib/rrtf/node/list_text_node.rb
+- lib/rrtf/node/node.rb
+- lib/rrtf/node/paragraph_node.rb
+- lib/rrtf/node/table_cell_node.rb
+- lib/rrtf/node/table_node.rb
+- lib/rrtf/node/table_row_node.rb
+- lib/rrtf/node/text_node.rb
+- lib/rrtf/page.rb
+- lib/rrtf/page/margin.rb
+- lib/rrtf/page/size.rb
+- lib/rrtf/properties.rb
+- lib/rrtf/properties/document_properties.rb
+- lib/rrtf/properties/geometry_properties.rb
+- lib/rrtf/properties/properties.rb
 - lib/rrtf/style.rb
+- lib/rrtf/style/anonymous_style.rb
+- lib/rrtf/style/border_style.rb
 - lib/rrtf/style/character_style.rb
-- lib/rrtf/style/document_style.rb
-- lib/rrtf/style/formatting.rb
 - lib/rrtf/style/paragraph_style.rb
+- lib/rrtf/style/position_style.rb
+- lib/rrtf/style/shading_style.rb
 - lib/rrtf/style/style.rb
 - lib/rrtf/stylesheet.rb
+- lib/rrtf/utilities.rb
 - lib/rrtf/version.rb
 - rrtf.gemspec
 homepage: https://github.com/whileman133/rrtf

data/examples/01_styles_and_paragraphs.rb

@@ -1,32 +0,0 @@
-require 'rrtf'
-require 'JSON'
-
-DIR = File.dirname(__FILE__)
-
-raw_styles = JSON.parse File.read(DIR+'/resources/json/redshirt_styles.json')
-
-rtf = RRTF::Document.new("stylesheet" => raw_styles)
-styles = rtf.stylesheet.styles
-
-rtf.paragraph(styles['TITLE']) << "RedShirts 101"
-rtf.paragraph(styles['BODY']) do |p|
-  p << "Should you ever find yourself on a spacefaring vessel wearing a"
-  p.apply(styles['EMPH']) << " red "
-  p << "shirt, take heed and be on guard, for danger is immanent and you are "
-  p << "likely expendable among the crew..."
-end
-rtf.paragraph(styles['H1']) << "1. The Danger of Away Missions"
-rtf.paragraph(styles['BODY']) do |p|
-  p << "If you're ever assigned an away mission, it's almost certain to be your doom. "
-  p << "The optimal strategy is to avoid away missions to begin with..."
-end
-rtf.paragraph(styles['H1']) << "2. Avoiding High-Ranking Officers"
-rtf.paragraph(styles['BODY']) do |p|
-  p << "You're likely to notice an influx of unfortunate outcomes around "
-  p << "certain high-ranking officers. Its to your advantage to quickly identify and "
-  p << "avoid these officers..."
-end
-
-File.open(DIR+'/01.rtf', 'w') do |file|
-   file.write(rtf.to_rtf)
-end

data/lib/rrtf/paper.rb

@@ -1,53 +0,0 @@
-module RRTF
-   # This class represents a definition for a paper size and provides a set
-   # of class constants for common paper sizes. An instance of the Paper class
-   # is considered immutable after creation.
-   class Paper
-      # Attribute accessor.
-      attr_reader :name, :width, :height
-
-
-      # This is the constructor for the Paper class. All dimension parameters
-      # to this method are in twips.
-      #
-      # ==== Parameters
-      # name::    The name for the paper object.
-      # width::   The width of the paper in portrait mode.
-      # height::  The height of the paper in portrait mode.
-      def initialize(name, width, height)
-         @name   = name
-         @width  = width
-         @height = height
-      end
-
-      # Definition of an international paper constant.
-      A0                     = Paper.new('A0', 47685, 67416)
-
-      # Definition of an international paper constant.
-      A1                     = Paper.new('A1', 33680, 47685)
-
-      # Definition of an international paper constant.
-      A2                     = Paper.new('A2', 23814, 33680)
-
-      # Definition of an international paper constant.
-      A3                     = Paper.new('A3', 16840, 23814)
-
-      # Definition of an international paper constant.
-      A4                     = Paper.new('A4', 11907, 16840)
-
-      # Definition of an international paper constant.
-      A5                     = Paper.new('A5', 8392, 11907)
-
-      # Definition of a US paper constant.
-      LETTER                 = Paper.new('Letter', 12247, 15819)
-
-      # Definition of a US paper constant.
-      LEGAL                  = Paper.new('Legal', 12247, 20185)
-
-      # Definition of a US paper constant.
-      EXECUTIVE              = Paper.new('Executive', 10773, 14402)
-
-      # Definition of a US paper constant.
-      LEDGER_TABLOID         = Paper.new('Ledger/Tabloid', 15819, 24494)
-   end # End of the Paper class.
-end # End of the RTF module.

data/lib/rrtf/style/document_style.rb

@@ -1,116 +0,0 @@
-module RRTF
-  # This class represents styling attributes that are to be applied at the
-  # document level.
-  class DocumentStyle < Style
-     # Definition for a document orientation setting.
-     PORTRAIT                                   = :portrait
-
-     # Definition for a document orientation setting.
-     LANDSCAPE                                  = :landscape
-
-     # Definition for a default margin setting.
-     DEFAULT_LEFT_MARGIN                        = 1800
-
-     # Definition for a default margin setting.
-     DEFAULT_RIGHT_MARGIN                       = 1800
-
-     # Definition for a default margin setting.
-     DEFAULT_TOP_MARGIN                         = 1440
-
-     # Definition for a default margin setting.
-     DEFAULT_BOTTOM_MARGIN                      = 1440
-
-     # stylesheet sorting codes
-     STYLESHEET_SORT_NAME       = 0 # stylesheet styles sorted by name
-     STYLESHEET_SORT_DEFAULT    = 1 # stylesheet styles sorted by system default
-     STYLESHEET_SORT_FONT       = 2 # stylesheet styles sorted by font
-     STYLESHEET_SORT_BASEDON    = 3 # stylesheet styles sorted by based-on fonts
-     STYLESHEET_SORT_TYPE       = 4 # stylesheet styles sorted by type
-
-     # Attribute accessor.
-     attr_reader :paper, :left_margin, :right_margin, :top_margin,
-                 :bottom_margin, :gutter, :orientation, :stylesheet_sort
-
-     # Attribute mutator.
-     attr_writer :paper, :left_margin, :right_margin, :top_margin,
-                 :bottom_margin, :gutter, :orientation, :stylesheet_sort
-
-     # This is a constructor for the DocumentStyle class. This creates a
-     # document style with a default paper setting of LETTER and portrait
-     # orientation (all other attributes are nil).
-     def initialize(options = {})
-       # load default options
-       options = {
-         "paper_size" => Paper::LETTER,
-         "left_margin" => DEFAULT_LEFT_MARGIN,
-         "right_margin" => DEFAULT_RIGHT_MARGIN,
-         "top_margin" => DEFAULT_TOP_MARGIN,
-         "bottom_margin" => DEFAULT_BOTTOM_MARGIN,
-         "gutter" => nil,
-         "orientation" => PORTRAIT,
-         "stylesheet_sort" => STYLESHEET_SORT_DEFAULT
-       }.merge(options)
-
-        @paper           = options.delete("paper_size")
-        @left_margin     = options.delete("left_margin")
-        @right_margin    = options.delete("right_margin")
-        @top_margin      = options.delete("top_margin")
-        @bottom_margin   = options.delete("bottom_margin")
-        @gutter          = options.delete("gutter")
-        @orientation     = options.delete("orientation")
-        @stylesheet_sort = options.delete("stylesheet_sort")
-     end
-
-     # This method overrides the is_document_style? method inherited from the
-     # Style class to always return true.
-     def is_document_style?
-        true
-     end
-
-     # This method generates a string containing the prefix associated with a
-     # style object.
-     #
-     # ==== Parameters
-     # document::  A reference to the document using the style.
-     def prefix(fonts=nil, colours=nil)
-        text = StringIO.new
-
-        text << "\\stylesortmethod#{@stylesheet_sort}" unless @stylesheet_sort.nil?
-        if orientation == LANDSCAPE
-           text << "\\paperw#{@paper.height}"  unless @paper.nil?
-           text << "\\paperh#{@paper.width}"   unless @paper.nil?
-        else
-           text << "\\paperw#{@paper.width}"   unless @paper.nil?
-           text << "\\paperh#{@paper.height}"  unless @paper.nil?
-        end
-        text << "\\margl#{@left_margin}"       unless @left_margin.nil?
-        text << "\\margr#{@right_margin}"      unless @right_margin.nil?
-        text << "\\margt#{@top_margin}"        unless @top_margin.nil?
-        text << "\\margb#{@bottom_margin}"     unless @bottom_margin.nil?
-        text << "\\gutter#{@gutter}"           unless @gutter.nil?
-        text << '\sectd\lndscpsxn' if @orientation == LANDSCAPE
-
-        text.string
-     end
-
-     # This method fetches the width of the available work area space for a
-     # DocumentStyle object.
-     def body_width
-        if orientation == PORTRAIT
-           @paper.width - (@left_margin + @right_margin)
-        else
-           @paper.height - (@left_margin + @right_margin)
-        end
-     end
-
-     # This method fetches the height of the available work area space for a
-     # DocumentStyle object.
-     def body_height
-        if orientation == PORTRAIT
-           @paper.height - (@top_margin + @bottom_margin)
-        else
-           @paper.width - (@top_margin + @bottom_margin)
-        end
-     end
-  end # End of the DocumentStyle class.
-end # module RRTF

data/lib/rrtf/style/formatting.rb

@@ -1,320 +0,0 @@
-require 'stringio'
-
-# Encapsulates all character formatting methods shared between style types.
-# @author Wesley Hileman
-module RRTF::CharacterFormatting
-  CHARACTER_ATTRIBUTES = {
-    # toggable attributes
-    "bold" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value ? '\b' : '\b0') unless value.nil? }
-    },
-    "italic" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value ? '\i' : '\i0') unless value.nil? }
-    },
-    "underline" => {
-      "default" => nil,
-      "dictionary" => {
-        "SINGLE" => "",
-        "DOUBLE" => "db",
-        "THICK" => "th",
-        "DASH" => "dash",
-        "LONG_DASH" => "ldash",
-        "DOT" => "d",
-        "DASH_DOT" => "dashd",
-        "DASH_DOT_DOT" => "dashdd",
-        "WAVE" => 'wave',
-        "THICK_DASH" => "thdash",
-        "THICK_LONG_DASH" => "thldash",
-        "THICK_DOT" => "thd",
-        "THICK_DASH_DOT" => "thdashd",
-        "THICK_DASH_DOT_DOT" => "thdashdd",
-        "THICK_WAVE" => 'hwave',
-        "DOUBLE_WAVE" => 'uldbwave'
-      },
-      "to_rtf" => lambda do |value, document|
-        return if value.nil?
-        case value
-        when TrueClass
-          '\ul'
-        when FalseClass
-          '\ulnone'
-        when String
-          "\\ul#{value}"
-        end # case
-      end
-    },
-    "uppercase" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value ? '\caps' : '\caps0') unless value.nil? }
-    },
-    "superscript" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value ? '\super' : '\super0') unless value.nil? }
-    },
-    "subscript" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value ? '\sub' : '\sub0') unless value.nil? }
-    },
-    "strike" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value ? '\strike' : '\strike0') unless value.nil? }
-    },
-    "emboss" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value ? '\embo' : '\embo0') unless value.nil? }
-    },
-    "imprint" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value ? '\impr' : '\impr0') unless value.nil? }
-    },
-    "outline" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value ? '\outl' : '\outl0') unless value.nil? }
-    },
-    "text_hidden" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value ? '\v' : '\v0') unless value.nil? }
-    },
-    "kerning" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value.is_a?(Integer) ? "\\kerning#{value}" : '\kerning0') unless value.nil? }
-    },
-    # non-toggable attributes
-    "character_spacing_offset" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| "\\expnd#{value}" unless value.nil? }
-    },
-    "foreground_color" => {
-      "default" => nil,
-      "from_user" => lambda{ |value| value.is_a?(RRTF::Colour) ? value : RRTF::Colour.from_string(value) },
-      "to_rtf" => lambda{ |value, document| "\\cf#{document.colours.index(value)}" unless value.nil? }
-    },
-    "background_color" => {
-      "default" => nil,
-      "from_user" => lambda{ |value| value.is_a?(RRTF::Colour) ? value : RRTF::Colour.from_string(value) },
-      "to_rtf" => lambda{ |value, document| "\\cb#{document.colours.index(value)}" unless value.nil? }
-    },
-    "underline_color" => {
-      "default" => nil,
-      "from_user" => lambda{ |value| value.is_a?(RRTF::Colour) ? value : RRTF::Colour.from_string(value) },
-      "to_rtf" => lambda{ |value, document| "\\ulc#{document.colours.index(value)}" unless value.nil? }
-    },
-    "font" => {
-      "default" => nil,
-      "from_user" => lambda{ |value| value.is_a?(RRTF::Font) ? value : RRTF::Font.from_string(value) },
-      "to_rtf" => lambda{ |value, document| "\\f#{document.fonts.index(value)}" unless value.nil? }
-    },
-    "font_size" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| "\\fs#{value}" unless value.nil? }
-    }
-  }.freeze
-
-  def self.included(base)
-    # define accessors in base for paragraph attributes
-    base.class_eval do
-      CHARACTER_ATTRIBUTES.each do |key, options|
-        attr_accessor :"#{key}"
-      end # each
-    end # class_eval
-  end
-
-  # Initializes character formatting attributes.
-  #
-  # @param [Hash] options the character formatting options.
-  # @option options [Boolean] "bold" (nil) enable or disable bold (nil to remain same).
-  # @option options [Boolean] "italic" (nil) enable or disable italic (nil to remain same).
-  # @option options [Boolean, String] "underline" (nil) enable or disable underline (nil to remain same); can also be a string (see {CharacterFormatting::CHARACTER_ATTRIBUTES}).
-  # @option options [Boolean] "uppercase" (nil) enable or disable all caps (nil to remain same).
-  # @option options [Boolean] "superscript" (nil) enable or disable superscript (nil to remain same).
-  # @option options [Boolean] "subscript" (nil) enable or disable subscript (nil to remain same).
-  # @option options [Boolean] "strike" (nil) enable or disable single line-through (nil to remain same).
-  # @option options [Boolean] "emboss" (nil) enable or disable emboss (nil to remain same).
-  # @option options [Boolean] "imprint" (nil) enable or disable imprint (nil to remain same).
-  # @option options [Boolean] "outline" (nil) enable or disable outline (nil to remain same).
-  # @option options [Boolean] "text_hidden" (nil) enable or disable hidden (nil to remain same).
-  # @option options [Boolean, Integer] "kerning" (nil) enable or disable kerning (nil to remain same); to enable specify the font size in half-points above which kerining will be applied.
-  # @option options [Integer] "character_spacing_offset" (nil) quarter points by which to expand or compress character spacing (negative for compress).
-  # @option options [String, Colour] "foreground_color" (nil) colour to apply to the foreground (text); see {Colour.from_string} for string format.
-  # @option options [String, Colour] "background_color" (nil) colour to apply to the background (highlight); see {Colour.from_string} for string format.
-  # @option options [String, Colour] "underline_color" (nil) colour to apply to the underline; see {Colour.from_string} for string format.
-  # @option options [String, Font] "font" (nil) font to apply to text; see {Font.from_string} for string format.
-  # @option options [Integer] "font_size" (nil) font size in half-points.
-  def initialize_character_formatting(options = {})
-    # load default attribute values
-    CHARACTER_ATTRIBUTES.each do |key, options|
-      send("#{key}=", options["default"])
-    end # each
-    # overwrite default attribute values with given values
-    set_character_formatting_from_hashmap(options)
-  end
-
-  def set_character_formatting_from_hashmap(hash)
-    hash.each do |attribute, value|
-      # skip unreconized attributes
-      next unless(CHARACTER_ATTRIBUTES.keys.include?(attribute))
-      # preprocess value if nessesary
-      if CHARACTER_ATTRIBUTES[attribute].has_key?("from_user")
-        value = CHARACTER_ATTRIBUTES[attribute]["from_user"].call(value)
-      elsif CHARACTER_ATTRIBUTES[attribute].has_key?("dictionary") && value.is_a?(String)
-        value = CHARACTER_ATTRIBUTES[attribute]["dictionary"][value]
-      end # if
-      # set attribute value
-      send("#{attribute}=", value)
-    end # each
-  end
-
-  def push_colours(colours)
-    colours << foreground_color unless foreground_color.nil?
-    colours << background_color unless background_color.nil?
-    colours << underline_color unless underline_color.nil?
-  end
-
-  def push_fonts(fonts)
-    fonts << font unless font.nil?
-  end
-
-  def character_formatting_to_rtf(document)
-     text = StringIO.new
-
-     # accumulate RTF representations of attributes
-     CHARACTER_ATTRIBUTES.each do |key, options|
-       if options.has_key?("to_rtf")
-         rtf = options["to_rtf"].call(send(key), document)
-         text << rtf unless rtf.nil?
-       end # if
-     end # each
-
-     text.string
-  end
-end # module CharacterFormatting
-
-# Encapsulates all paragraph formatting methods shared between style types.
-# @author Wesley Hileman
-module RRTF::ParagraphFormatting
-  PARAGRAPH_ATTRIBUTES = {
-    "justification" => {
-      "default" => "l",
-      "dictionary" => {
-        "LEFT" => "l",
-        "RIGHT" => "r",
-        "CENTER" => "c",
-        "CENTRE" => "c",
-        "FULL" => "j"
-      },
-      "to_rtf" => lambda{ |value, document| "\\q#{value}" }
-    },
-    "left_indent" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| "\\li#{value}" unless value.nil? }
-    },
-    "right_indent" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| "\\ri#{value}" unless value.nil? }
-    },
-    "first_line_indent" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| "\\fi#{value}" unless value.nil? }
-    },
-    "space_before" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| "\\sb#{value}" unless value.nil? }
-    },
-    "space_after" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| "\\sa#{value}" unless value.nil? }
-    },
-    "line_spacing" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| "\\sl#{value}" unless value.nil? }
-    },
-    "widow_orphan_ctl" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value ? "\\widctlpar" : "\\nowidctlpar") unless value.nil? }
-    },
-    "no_break" => {
-      "default" => false,
-      "to_rtf" => lambda{ |value, document| "\\keep" if value }
-    },
-    "no_break_with_next" => {
-      "default" => false,
-      "to_rtf" => lambda{ |value, document| "\\keepn" if value }
-    },
-    "hyphenate" => {
-      "default" => nil,
-      "to_rtf" => lambda{ |value, document| (value ? "\\hyphpar" : "\\hyphpar0") unless value.nil? }
-    },
-    "paragraph_flow" => {
-      "default" => 'ltr',
-      "dictionary" => {
-        "LEFT_TO_RIGHT" => 'ltr',
-        "RIGHT_TO_LEFT" => 'rtl'
-      },
-      "to_rtf" => lambda{ |value, document| "\\#{value}par" unless value.nil? }
-    }
-  }.freeze
-
-  def self.included(base)
-    # define accessors in base for paragraph attributes
-    base.class_eval do
-      PARAGRAPH_ATTRIBUTES.each do |key, options|
-        attr_accessor :"#{key}"
-      end # each
-    end # class_eval
-  end
-
-  # Initializes paragraph formatting attributes.
-  #
-  # @param [Hash] options the paragraph formatting options.
-  # @option options [String] "justification" ('LEFT') the paragraph justification ('LEFT', 'CENTER'/'CENTRE', 'RIGHT', or 'FULL').
-  # @option options [Integer] "left_indent" (nil) the left indent of the paragraph (twentieth points).
-  # @option options [Integer] "right_indent" (nil) the right indent of the paragraph (twentieth points).
-  # @option options [Integer] "first_line_indent" (nil) the first line indent of the paragraph (twentieth points).
-  # @option options [Integer] "space_before" (nil) the space before the paragraph (twentieth points).
-  # @option options [Integer] "space_after" (nil) the space after the paragraph (twentieth points).
-  # @option options [Integer] "line_spacing" (nil) the line spacing in the paragraph (twentieth points).
-  # @option options [Boolean] "widow_orphan_ctl" (nil) enable or disable widow-and-orphan control.
-  # @option options [Boolean] "no_break" (nil) when true, tries to keep the paragraph on the same page (i.e. without breaking).
-  # @option options [Boolean] "no_break_with_next" (nil) when true, tries to keep the paragraph with the next paragraph on the same page (i.e. without breaking).
-  # @option options [Boolean] "hyphenate" (nil) enable or disable hyphenation for the paragraph.
-  # @option options [String] "paragraph_flow" ('LEFT_TO_RIGHT') the text flow direction in the paragraph ('LEFT_TO_RIGHT' or 'RIGHT_TO_LEFT').
-  def initialize_paragraph_formatting(options = {})
-    # load default attribute values
-    PARAGRAPH_ATTRIBUTES.each do |key, options|
-      send("#{key}=", options["default"])
-    end # each
-    # overwrite default attribute values with given values
-    set_paragraph_formatting_from_hashmap(options)
-  end
-
-  def set_paragraph_formatting_from_hashmap(hash)
-    hash.each do |attribute, value|
-      # skip unreconized attributes
-      next unless(PARAGRAPH_ATTRIBUTES.keys.include?(attribute))
-      # preprocess value if nessesary
-      if PARAGRAPH_ATTRIBUTES[attribute].has_key?("from_user")
-        value = PARAGRAPH_ATTRIBUTES[attribute]["from_user"].call(value)
-      elsif PARAGRAPH_ATTRIBUTES[attribute].has_key?("dictionary") && value.is_a?(String)
-        value = PARAGRAPH_ATTRIBUTES[attribute]["dictionary"][value]
-      end # if
-      # set attribute value
-      send("#{attribute}=", value)
-    end # each
-  end
-
-  def paragraph_formatting_to_rtf(document)
-    text = StringIO.new
-
-    # accumulate RTF representations of paragraph attributes
-    PARAGRAPH_ATTRIBUTES.each do |key, options|
-      if options.has_key?("to_rtf")
-        rtf = options["to_rtf"].call(send(key), document)
-        text << rtf unless rtf.nil?
-      end # if
-    end # each
-
-    text.string
-  end
-end # module ParagraphFormatting