rubyXL 3.2.0 → 3.2.1

data/lib/rubyXL/objects/storage.rb

@@ -1,158 +1,141 @@
-module RubyXL
-
-  class GenericStorageObject
-    SAVE_ORDER = 0
-
-    attr_accessor :xlsx_path, :data, :generic_storage
-
-    def initialize(file_path)
-      @xlsx_path = file_path
-      @data = nil
-      @generic_storage = []
-    end
-
-    def self.parse_file(dirpath, file_path = nil)
-      file_path ||= self.xlsx_path
-      obj = self.new(file_path)
-
-      case dirpath
-      when String then
-        full_path = File.join(dirpath, file_path)
-        return nil unless File.exist?(full_path)
-        obj.data = File.open(full_path, 'r') { |f| f.read }
-      when Zip::File then
-        file_path = file_path.relative_path_from(::Pathname.new("/")) if file_path.absolute? # Zip doesn't like absolute paths.
-        entry = dirpath.find_entry(file_path)
-        return nil if entry.nil?
-        obj.data = entry.get_input_stream { |f| f.read }
-      end
-
-      obj
-    end
-
-    def add_to_zip(zip_stream)
-      return if @data.nil?
-      path = self.xlsx_path
-      path = path.relative_path_from(Pathname.new("/")) if path.absolute? # Zip doesn't like absolute paths.
-      zip_stream.put_next_entry(path)
-      zip_stream.write(@data)
-    end
-  end
-
-  class PrinterSettingsFile < GenericStorageObject
-    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.printerSettings'
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/printerSettings'
-  end
-
-  class DrawingFile < GenericStorageObject
-    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.drawing+xml'
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing'
-
-    include RubyXL::RelationshipSupport
-
-    def attach_relationship(rid, rf)
-      case rf
-      when RubyXL::ChartFile       then store_relationship(rf) # TODO
-      when RubyXL::BinaryImageFile then store_relationship(rf) # TODO
-      else store_relationship(rf, :unknown)
-      end
-    end
-
-  end
-
-  class ChartFile < GenericStorageObject
-    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.drawingml.chart+xml'
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart'
-
-    include RubyXL::RelationshipSupport
-
-    def attach_relationship(rid, rf)
-      case rf
-      when RubyXL::ChartColorsFile     then store_relationship(rf) # TODO
-      when RubyXL::ChartStyleFile      then store_relationship(rf) # TODO
-      when RubyXL::ChartUserShapesFile then store_relationship(rf) # TODO
-      else store_relationship(rf, :unknown)
-      end
-    end
-
-  end
-
-  class VMLDrawingFile < GenericStorageObject
-    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.vmlDrawing'
-#    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.drawingml.chart+xml'
-    REL_TYPE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing'
-  end
-
-  class ChartColorsFile < GenericStorageObject
-    CONTENT_TYPE = 'application/vnd.ms-office.chartcolorstyle+xml'
-    REL_TYPE     = 'http://schemas.microsoft.com/office/2011/relationships/chartColorStyle'
-  end
-
-  class ChartStyleFile < GenericStorageObject
-    CONTENT_TYPE = 'application/vnd.ms-office.chartstyle+xml'
-    REL_TYPE     = 'http://schemas.microsoft.com/office/2011/relationships/chartStyle'
-  end
-
-  class TableFile < GenericStorageObject
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/table'
-  end
-
-  class ControlPropertiesFile < GenericStorageObject
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/ctrlProp'
-  end
-
-  class PivotTableFile < GenericStorageObject
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotTable'
-  end
-
-  class PivotCacheDefinitionFile < GenericStorageObject
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheDefinition'
-  end
-
-  class BinaryImageFile < GenericStorageObject
-    CONTENT_TYPE = 'image/jpeg'
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/image'
-  end
-
-  class HyperlinkRelFile < GenericStorageObject
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink'
-  end
-
-  class ThumbnailFile < GenericStorageObject
-    REL_TYPE     = 'http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail'
-    CONTENT_TYPE = 'image/x-wmf'
-  end
-
-  class ChartUserShapesFile < GenericStorageObject
-    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.drawingml.chartshapes+xml'
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/chartUserShapes'
-  end
-
-  class CustomPropertiesFile < GenericStorageObject
-    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.custom-properties+xml'
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/custom-properties'
-  end
-
-  class MacrosFile < GenericStorageObject
-    CONTENT_TYPE = 'application/vnd.ms-office.vbaProject'
-    REL_TYPE     = 'http://schemas.microsoft.com/office/2006/relationships/vbaProject'
-  end
-
-  class ExternalLinksFile < GenericStorageObject
-    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.externalLink+xml'
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLink'
-  end
-
-  class CustomXMLFile < GenericStorageObject
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXml'
-  end
-
-  class SlicerFile < GenericStorageObject
-    REL_TYPE     = 'http://schemas.microsoft.com/office/2007/relationships/slicer'
-  end
-
-  class SlicerCacheFile < GenericStorageObject
-    REL_TYPE     = 'http://schemas.microsoft.com/office/2007/relationships/slicerCache'
-  end
-
-end
+module RubyXL
+
+  class GenericStorageObject
+    SAVE_ORDER = 0
+
+    attr_accessor :xlsx_path, :data, :generic_storage
+
+    def initialize(file_path, data)
+      @xlsx_path = file_path
+      @data = data
+      @generic_storage = []
+    end
+
+    def self.parse_file(zip_file, file_path)
+      (entry = zip_file.find_entry(RubyXL::from_root(file_path))) && self.new(file_path, entry.get_input_stream { |f| f.read })
+    end
+
+    def add_to_zip(zip_stream)
+      return if @data.nil?
+      zip_stream.put_next_entry(RubyXL::from_root(self.xlsx_path))
+      zip_stream.write(@data)
+    end
+  end
+
+  class PrinterSettingsFile < GenericStorageObject
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.printerSettings'
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/printerSettings'
+  end
+
+  class DrawingFile < GenericStorageObject
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.drawing+xml'
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing'
+
+    include RubyXL::RelationshipSupport
+
+    def attach_relationship(rid, rf)
+      case rf
+      when RubyXL::ChartFile       then store_relationship(rf) # TODO
+      when RubyXL::BinaryImageFile then store_relationship(rf) # TODO
+      else store_relationship(rf, :unknown)
+      end
+    end
+
+  end
+
+  class ChartFile < GenericStorageObject
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.drawingml.chart+xml'
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart'
+
+    include RubyXL::RelationshipSupport
+
+    def attach_relationship(rid, rf)
+      case rf
+      when RubyXL::ChartColorsFile     then store_relationship(rf) # TODO
+      when RubyXL::ChartStyleFile      then store_relationship(rf) # TODO
+      when RubyXL::ChartUserShapesFile then store_relationship(rf) # TODO
+      else store_relationship(rf, :unknown)
+      end
+    end
+
+  end
+
+  class VMLDrawingFile < GenericStorageObject
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.vmlDrawing'
+#    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.drawingml.chart+xml'
+    REL_TYPE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing'
+  end
+
+  class ChartColorsFile < GenericStorageObject
+    CONTENT_TYPE = 'application/vnd.ms-office.chartcolorstyle+xml'
+    REL_TYPE     = 'http://schemas.microsoft.com/office/2011/relationships/chartColorStyle'
+  end
+
+  class ChartStyleFile < GenericStorageObject
+    CONTENT_TYPE = 'application/vnd.ms-office.chartstyle+xml'
+    REL_TYPE     = 'http://schemas.microsoft.com/office/2011/relationships/chartStyle'
+  end
+
+  class TableFile < GenericStorageObject
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/table'
+  end
+
+  class ControlPropertiesFile < GenericStorageObject
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/ctrlProp'
+  end
+
+  class PivotTableFile < GenericStorageObject
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotTable'
+  end
+
+  class PivotCacheDefinitionFile < GenericStorageObject
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheDefinition'
+  end
+
+  class BinaryImageFile < GenericStorageObject
+    CONTENT_TYPE = 'image/jpeg'
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/image'
+  end
+
+  class HyperlinkRelFile < GenericStorageObject
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink'
+  end
+
+  class ThumbnailFile < GenericStorageObject
+    REL_TYPE     = 'http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail'
+    CONTENT_TYPE = 'image/x-wmf'
+  end
+
+  class ChartUserShapesFile < GenericStorageObject
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.drawingml.chartshapes+xml'
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/chartUserShapes'
+  end
+
+  class CustomPropertiesFile < GenericStorageObject
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.custom-properties+xml'
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/custom-properties'
+  end
+
+  class MacrosFile < GenericStorageObject
+    CONTENT_TYPE = 'application/vnd.ms-office.vbaProject'
+    REL_TYPE     = 'http://schemas.microsoft.com/office/2006/relationships/vbaProject'
+  end
+
+  class ExternalLinksFile < GenericStorageObject
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.externalLink+xml'
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLink'
+  end
+
+  class CustomXMLFile < GenericStorageObject
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXml'
+  end
+
+  class SlicerFile < GenericStorageObject
+    REL_TYPE     = 'http://schemas.microsoft.com/office/2007/relationships/slicer'
+  end
+
+  class SlicerCacheFile < GenericStorageObject
+    REL_TYPE     = 'http://schemas.microsoft.com/office/2007/relationships/slicerCache'
+  end
+
+end

data/lib/rubyXL/objects/stylesheet.rb

@@ -14,7 +14,7 @@ module RubyXL
     define_element_name 'numFmt'
 
     def is_date_format?
-      #             v----- Toss all the escaped chars ------v v--- and see if any date-related remained
+      #             v-------- Toss all the escaped chars -------v v--- and see if any date-related remained
       !!(format_code.gsub(/(\"[^\"]*\"|\[[^\]]*\]|[\\_*].)/i, '') =~ /[dmyhs]/i)
     end
 
@@ -157,59 +157,59 @@ module RubyXL
     define_child_node(RubyXL::MRUColors)
     define_element_name 'colors'
   end
-
-  # http://www.schemacentral.com/sc/ooxml/e-ssml_styleSheet.html
-  class Stylesheet < OOXMLTopLevelObject
-    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml'
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles'
-
-    define_child_node(RubyXL::NumberFormats, :accessor => :number_formats)
-    define_child_node(RubyXL::Fonts)
-    define_child_node(RubyXL::Fills)
-    define_child_node(RubyXL::Borders)
-    define_child_node(RubyXL::CellStyleXFs)
-    define_child_node(RubyXL::CellXFs)
-    define_child_node(RubyXL::CellStyles)
-    define_child_node(RubyXL::DXFs)
-    define_child_node(RubyXL::TableStyles)
-    define_child_node(RubyXL::Colors)
-    define_child_node(RubyXL::ExtensionStorageArea)
-    define_element_name 'styleSheet'
-    set_namespaces('http://schemas.openxmlformats.org/spreadsheetml/2006/main' => '',
-                   'http://schemas.openxmlformats.org/officeDocument/2006/relationships' => 'r',
-                   'http://schemas.openxmlformats.org/markup-compatibility/2006' => 'mc',
-                   'http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac' => 'x14ac',
-                   'urn:schemas-microsoft-com:mac:vml' => 'mv')
-
-    def initialize(*args)
-      super
-      @format_hash = nil
-    end
-
-    def xlsx_path
-      ROOT.join('xl', 'styles.xml')
-    end
-
-    def self.default
-      self.new(:fonts          => RubyXL::Fonts.defaults,
-               :fills          => RubyXL::Fills.defaults,
-               :borders        => RubyXL::Borders.defaults,
-               :cell_xfs       => RubyXL::CellXFs.defaults,
-               :cell_styles    => RubyXL::CellStyles.defaults,
-               :cell_style_xfs => RubyXL::CellStyleXFs.defaults)
-    end
-
-    def get_number_format_by_id(format_id)
-      @format_hash ||= {}
-
-      if @format_hash[format_id].nil? then
-        @format_hash[format_id] = NumberFormats::DEFAULT_NUMBER_FORMATS.find_by_format_id(format_id) ||
-                                    (number_formats && number_formats.find_by_format_id(format_id))
-      end
-
-      @format_hash[format_id]
-    end
-
-  end
-
-end
+
+  # http://www.schemacentral.com/sc/ooxml/e-ssml_styleSheet.html
+  class Stylesheet < OOXMLTopLevelObject
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml'
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles'
+
+    define_child_node(RubyXL::NumberFormats, :accessor => :number_formats)
+    define_child_node(RubyXL::Fonts)
+    define_child_node(RubyXL::Fills)
+    define_child_node(RubyXL::Borders)
+    define_child_node(RubyXL::CellStyleXFs)
+    define_child_node(RubyXL::CellXFs)
+    define_child_node(RubyXL::CellStyles)
+    define_child_node(RubyXL::DXFs)
+    define_child_node(RubyXL::TableStyles)
+    define_child_node(RubyXL::Colors)
+    define_child_node(RubyXL::ExtensionStorageArea)
+    define_element_name 'styleSheet'
+    set_namespaces('http://schemas.openxmlformats.org/spreadsheetml/2006/main' => '',
+                   'http://schemas.openxmlformats.org/officeDocument/2006/relationships' => 'r',
+                   'http://schemas.openxmlformats.org/markup-compatibility/2006' => 'mc',
+                   'http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac' => 'x14ac',
+                   'urn:schemas-microsoft-com:mac:vml' => 'mv')
+
+    def initialize(*args)
+      super
+      @format_hash = nil
+    end
+
+    def xlsx_path
+      ROOT.join('xl', 'styles.xml')
+    end
+
+    def self.default
+      self.new(:fonts          => RubyXL::Fonts.defaults,
+               :fills          => RubyXL::Fills.defaults,
+               :borders        => RubyXL::Borders.defaults,
+               :cell_xfs       => RubyXL::CellXFs.defaults,
+               :cell_styles    => RubyXL::CellStyles.defaults,
+               :cell_style_xfs => RubyXL::CellStyleXFs.defaults)
+    end
+
+    def get_number_format_by_id(format_id)
+      @format_hash ||= {}
+
+      if @format_hash[format_id].nil? then
+        @format_hash[format_id] = NumberFormats::DEFAULT_NUMBER_FORMATS.find_by_format_id(format_id) ||
+                                    (number_formats && number_formats.find_by_format_id(format_id))
+      end
+
+      @format_hash[format_id]
+    end
+
+  end
+
+end

data/lib/rubyXL/objects/text.rb

@@ -1,87 +1,87 @@
-require 'rubyXL/objects/ooxml_object'
-require 'rubyXL/objects/simple_types'
-require 'rubyXL/objects/container_nodes'
-require 'rubyXL/objects/color'
-
-module RubyXL
-
-  # http://www.schemacentral.com/sc/ooxml/e-ssml_t-1.html
-  class Text < OOXMLObject
-    define_attribute(:_,           :string, :accessor => :value)
-    define_attribute(:'xml:space', :string)
-    define_element_name 't'
-
-    def before_write_xml
-      self.xml_space = (value.is_a?(String) && ((value =~ /\A\s/) || (value =~ /\s\Z/) || value.include?("\n"))) ? 'preserve' : nil
-      true
-    end
-
-    def to_s
-      value.to_s
-    end
-  end
-
-  # http://www.schemacentral.com/sc/ooxml/e-ssml_rPr-1.html
-  class RunProperties < OOXMLObject
-    define_child_node(RubyXL::StringValue,  :node_name => :rFont)
-    define_child_node(RubyXL::IntegerValue, :node_name => :charset)
-    define_child_node(RubyXL::IntegerValue, :node_name => :family)
-    define_child_node(RubyXL::BooleanValue, :node_name => :b)
-    define_child_node(RubyXL::BooleanValue, :node_name => :i)
-    define_child_node(RubyXL::BooleanValue, :node_name => :strike)
-    define_child_node(RubyXL::BooleanValue, :node_name => :outline)
-    define_child_node(RubyXL::BooleanValue, :node_name => :shadow)
-    define_child_node(RubyXL::BooleanValue, :node_name => :condense)
-    define_child_node(RubyXL::BooleanValue, :node_name => :extend)
-    define_child_node(RubyXL::Color)
-    define_child_node(RubyXL::FloatValue,   :node_name => :sz)
-    define_child_node(RubyXL::BooleanValue, :node_name => :u)
-    define_child_node(RubyXL::StringValue,  :node_name => :vertAlign)
-    define_child_node(RubyXL::StringValue,  :node_name => :scheme)
-    define_element_name 'rPr'
-  end
-
-  # http://www.schemacentral.com/sc/ooxml/e-ssml_r-2.html
-  class RichTextRun < OOXMLObject
-    define_child_node(RubyXL::RunProperties)
-    define_child_node(RubyXL::Text)
-    define_element_name 'r'
-
-    def to_s
-      t.to_s
-    end
-
-  end
-
-  # http://www.schemacentral.com/sc/ooxml/e-ssml_rPh-1.html
-  class PhoneticRun < OOXMLObject
-    define_attribute(:sb, :int, :required => true)
-    define_attribute(:eb, :int, :required => true)
-    define_child_node(RubyXL::Text)
-    define_element_name 'rPh'
-  end
-
-  # http://www.schemacentral.com/sc/ooxml/e-ssml_phoneticPr-1.html
-  class PhoneticProperties < OOXMLObject
-    define_attribute(:fontId,    :int,    :required => true)
-    define_attribute(:type,      RubyXL::ST_PhoneticType,      :default => 'fullwidthKatakana')
-    define_attribute(:alignment, RubyXL::ST_PhoneticAlignment, :default => 'left')
-    define_element_name 'phoneticPr'
-  end
-
-  # http://www.schemacentral.com/sc/ooxml/e-ssml_is-1.html
-  class RichText < OOXMLObject
-    define_child_node(RubyXL::Text)
-    define_child_node(RubyXL::RichTextRun, :collection => true)
-    define_child_node(RubyXL::PhoneticRun, :collection => true)
-    define_child_node(RubyXL::PhoneticProperties)
-    define_element_name 'is'
-
-    def to_s
-      str = t.to_s
-      r && r.each { |rtr| str << rtr.to_s if rtr }
-      str
-    end
-  end
-
-end
+require 'rubyXL/objects/ooxml_object'
+require 'rubyXL/objects/simple_types'
+require 'rubyXL/objects/container_nodes'
+require 'rubyXL/objects/color'
+
+module RubyXL
+
+  # http://www.schemacentral.com/sc/ooxml/e-ssml_t-1.html
+  class Text < OOXMLObject
+    define_attribute(:_,           :string, :accessor => :value)
+    define_attribute(:'xml:space', :string)
+    define_element_name 't'
+
+    def before_write_xml
+      self.xml_space = (value.is_a?(String) && ((value =~ /\A\s/) || (value =~ /\s\Z/) || value.include?("\n"))) ? 'preserve' : nil
+      true
+    end
+
+    def to_s
+      value.to_s
+    end
+  end
+
+  # http://www.schemacentral.com/sc/ooxml/e-ssml_rPr-1.html
+  class RunProperties < OOXMLObject
+    define_child_node(RubyXL::StringValue,  :node_name => :rFont)
+    define_child_node(RubyXL::IntegerValue, :node_name => :charset)
+    define_child_node(RubyXL::IntegerValue, :node_name => :family)
+    define_child_node(RubyXL::BooleanValue, :node_name => :b)
+    define_child_node(RubyXL::BooleanValue, :node_name => :i)
+    define_child_node(RubyXL::BooleanValue, :node_name => :strike)
+    define_child_node(RubyXL::BooleanValue, :node_name => :outline)
+    define_child_node(RubyXL::BooleanValue, :node_name => :shadow)
+    define_child_node(RubyXL::BooleanValue, :node_name => :condense)
+    define_child_node(RubyXL::BooleanValue, :node_name => :extend)
+    define_child_node(RubyXL::Color)
+    define_child_node(RubyXL::FloatValue,   :node_name => :sz)
+    define_child_node(RubyXL::BooleanValue, :node_name => :u)
+    define_child_node(RubyXL::StringValue,  :node_name => :vertAlign)
+    define_child_node(RubyXL::StringValue,  :node_name => :scheme)
+    define_element_name 'rPr'
+  end
+
+  # http://www.schemacentral.com/sc/ooxml/e-ssml_r-2.html
+  class RichTextRun < OOXMLObject
+    define_child_node(RubyXL::RunProperties)
+    define_child_node(RubyXL::Text)
+    define_element_name 'r'
+
+    def to_s
+      t.to_s
+    end
+
+  end
+
+  # http://www.schemacentral.com/sc/ooxml/e-ssml_rPh-1.html
+  class PhoneticRun < OOXMLObject
+    define_attribute(:sb, :int, :required => true)
+    define_attribute(:eb, :int, :required => true)
+    define_child_node(RubyXL::Text)
+    define_element_name 'rPh'
+  end
+
+  # http://www.schemacentral.com/sc/ooxml/e-ssml_phoneticPr-1.html
+  class PhoneticProperties < OOXMLObject
+    define_attribute(:fontId,    :int,    :required => true)
+    define_attribute(:type,      RubyXL::ST_PhoneticType,      :default => 'fullwidthKatakana')
+    define_attribute(:alignment, RubyXL::ST_PhoneticAlignment, :default => 'left')
+    define_element_name 'phoneticPr'
+  end
+
+  # http://www.schemacentral.com/sc/ooxml/e-ssml_is-1.html
+  class RichText < OOXMLObject
+    define_child_node(RubyXL::Text)
+    define_child_node(RubyXL::RichTextRun, :collection => true)
+    define_child_node(RubyXL::PhoneticRun, :collection => true)
+    define_child_node(RubyXL::PhoneticProperties)
+    define_element_name 'is'
+
+    def to_s
+      str = t.to_s
+      r && r.each { |rtr| str << rtr.to_s if rtr }
+      str
+    end
+  end
+
+end