rubyXL 3.0.1 → 3.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7a54bc20d6cdffb9452628d880575ec195885077
+  data.tar.gz: 0c2421c0e01f4c35c4e9aa93ff9c11268e8da399
+SHA512:
+  metadata.gz: 579c2a42754270f6c796647e1d46bd282a9806ca21056ae194929dab205aaf6571505289038e67e4d3befed6492d8514f170fb5cff941e1a2b9dbe5a4d38b58f
+  data.tar.gz: 28261b6ba4913eec6b9bba20c8a21875d35489581791845ce70869f3e9346395f9badadec97e037e29c97880d912febf9d90d7ce88b78412a8b9f0b9cdd04219

data/README.rdoc

@@ -1,4 +1,5 @@
 = rubyXL
+{<img src="https://codeclimate.com/github/weshatheleopard/rubyXL.png">}[https://codeclimate.com/github/weshatheleopard/rubyXL]
 
 == To Install:
   gem install rubyXL

data/VERSION

@@ -1 +1 @@
-3.0.1
+3.0.2

data/lib/rubyXL/cell.rb

@@ -114,27 +114,27 @@ module RubyXL
       self.style_index = workbook.modify_text_wrap(self.style_index, wrap)
     end
 
-    # changes top border of cell
+    def change_border(direction, weight)
+      validate_worksheet
+      self.style_index = workbook.modify_border(self.style_index, direction, weight)
+    end
+
     def change_border_top(weight = 'thin')
       change_border(:top, weight)
     end
 
-    # changes left border of cell
     def change_border_left(weight = 'thin')
       change_border(:left, weight)
     end
 
-    # changes right border of cell
     def change_border_right(weight = 'thin')
       change_border(:right, weight)
     end
 
-    # changes bottom border of cell
     def change_border_bottom(weight = 'thin')
       change_border(:bottom, weight)
     end
 
-    # changes diagonal border of cell
     def change_border_diagonal(weight = 'thin')
       change_border(:diagonal, weight)
     end
@@ -258,11 +258,6 @@ module RubyXL
 
     private
 
-    def change_border(direction, weight)
-      validate_worksheet
-      self.style_index = workbook.modify_border(self.style_index, direction, weight)
-    end
-
     def get_border(direction)
       validate_worksheet
       get_cell_border.get_edge_style(direction)

data/lib/rubyXL/objects/color.rb

@@ -5,10 +5,10 @@ module RubyXL
   # http://www.schemacentral.com/sc/ooxml/e-ssml_color-4.html
   class Color < OOXMLObject
     define_attribute(:auto,    :bool)
-    define_attribute(:indexed, :int)
+    define_attribute(:indexed, :uint)
     define_attribute(:rgb,     :string)
-    define_attribute(:theme,   :int)
-    define_attribute(:tint,    :float)
+    define_attribute(:theme,   :uint)
+    define_attribute(:tint,    :double, :default => 0.0)
     define_element_name 'color'
 
     #validates hex color code, no '#' allowed

data/lib/rubyXL/objects/column_range.rb

@@ -4,10 +4,10 @@ module RubyXL
 
   # http://www.schemacentral.com/sc/ooxml/e-ssml_col-1.html
   class ColumnRange < OOXMLObject
-    define_attribute(:min,          :int,     :required => true)
-    define_attribute(:max,          :int,     :required => true)
-    define_attribute(:width,        :float)
-    define_attribute(:style,        :int,     :default => 0, :accessor => :style_index)
+    define_attribute(:min,          :uint,    :required => true)
+    define_attribute(:max,          :uint,    :required => true)
+    define_attribute(:width,        :double)
+    define_attribute(:style,        :uint,    :default => 0, :accessor => :style_index)
     define_attribute(:hidden,       :bool,    :default => false)
     define_attribute(:bestFit,      :bool,    :default => false)
     define_attribute(:customWidth,  :bool,    :default => false)

data/lib/rubyXL/objects/container_nodes.rb

@@ -16,7 +16,7 @@ module RubyXL
   end
 
   class FloatValue < OOXMLObject
-    define_attribute(:val, :float, :required => true)
+    define_attribute(:val, :double, :required => true)
   end
 
   class BooleanNode < OOXMLObject
@@ -32,7 +32,7 @@ module RubyXL
   end
 
   class FloatNode < OOXMLObject
-    define_attribute(:_, :float, :accessor => :value)
+    define_attribute(:_, :double, :accessor => :value)
   end
 
   class StringNodeW3C < OOXMLObject

data/lib/rubyXL/objects/fill.rb

@@ -3,9 +3,9 @@ require 'rubyXL/objects/simple_types'
 
 module RubyXL
 
-  # http://www.schemacentral.com/sc/ooxml/e-ssml_gradientFill-1.html
+  # http://www.datypic.com/sc/ooxml/e-ssml_stop-1.html
   class Stop < OOXMLObject
-    define_attribute(:position, :float)
+    define_attribute(:position, :double, :required => true)
     define_child_node(RubyXL::Color)
     define_element_name 'stop'
   end
@@ -21,11 +21,11 @@ module RubyXL
   # http://www.schemacentral.com/sc/ooxml/e-ssml_gradientFill-1.html
   class GradientFill < OOXMLObject
     define_attribute(:type,   RubyXL::ST_GradientType, :default => 'linear')
-    define_attribute(:degree, :float,  :default => 0)
-    define_attribute(:left,   :float,  :default => 0)
-    define_attribute(:right,  :float,  :default => 0)
-    define_attribute(:top,    :float,  :default => 0)
-    define_attribute(:bottom, :float,  :default => 0)
+    define_attribute(:degree, :double, :default => 0)
+    define_attribute(:left,   :double, :default => 0)
+    define_attribute(:right,  :double, :default => 0)
+    define_attribute(:top,    :double, :default => 0)
+    define_attribute(:bottom, :double, :default => 0)
     define_child_node(RubyXL::Stop, :collection => true)
     define_element_name 'gradientFill'
   end

data/lib/rubyXL/objects/filters.rb

@@ -29,8 +29,8 @@ module RubyXL
   class Top10 < OOXMLObject
     define_attribute(:top,       :bool,  :default  => true)	
     define_attribute(:percent,   :bool,  :default  => false)
-    define_attribute(:val,       :float, :required => true)
-    define_attribute(:filterVal, :float)
+    define_attribute(:val,       :double, :required => true)
+    define_attribute(:filterVal, :double)
     define_element_name 'top10'
   end
 
@@ -51,8 +51,8 @@ module RubyXL
   # http://www.schemacentral.com/sc/ooxml/e-ssml_dynamicFilter-1.html
   class DynamicFilter < OOXMLObject
     define_attribute(:type,   RubyXL::ST_DynamicFilterType, :required => true)
-    define_attribute(:val,    :float)
-    define_attribute(:maxVal, :float)
+    define_attribute(:val,    :double)
+    define_attribute(:maxVal, :double)
     define_element_name 'dynamicFilter'
   end
 

data/lib/rubyXL/objects/ooxml_object.rb

@@ -24,7 +24,8 @@ module RubyXL
     #   * Special attibute name <tt>'_'</tt> (underscore) denotes the value of the element rather than attribute.
     # * +attribute_type+ - Specifies the conversion type for the attribute when parsing. Available options are:
     #   * +:int+ - <tt>Integer</tt>
-    #   * +:float+ - <tt>Float</tt>
+    #   * +:uint+ - Unsigned <tt>Integer</tt>
+    #   * +:double+ - <tt>Float</tt></u>
     #   * +:string+ - <tt>String</tt> (no conversion)
     #   * +:sqref+ - RubyXL::Sqref
     #   * +:ref+ - RubyXL::Reference
@@ -89,7 +90,7 @@ module RubyXL
     end
 
     def define_count_attribute
-      define_attribute(:count, :int, :required => true)
+      define_attribute(:count, :uint, :required => true)
     end
     private :define_count_attribute
  
@@ -190,13 +191,17 @@ module RubyXL
     def process_attribute(obj, raw_value, params)
       val = raw_value &&
               case params[:attr_type]
-              when :int    then Integer(raw_value)
-              when :float  then Float(raw_value)
+              when :double then Float(raw_value) # http://www.datypic.com/sc/xsd/t-xsd_double.html
               when :string then raw_value
               when Array   then raw_value # Case of Simple Types
               when :sqref  then RubyXL::Sqref.new(raw_value)
               when :ref    then RubyXL::Reference.new(raw_value)
               when :bool   then ['1', 'true'].include?(raw_value)
+              when :int    then Integer(raw_value)
+              when :uint   then
+                v = Integer(raw_value)
+                raise ArgumentError.new("invalid value for unsigned Integer(): \"#{raw_value}\"") if v < 0
+                v
               end              
       obj.send("#{params[:accessor]}=", val)
     end
@@ -275,8 +280,8 @@ module RubyXL
 
         val = val &&
                 case v[:attr_type]
-                when :bool  then val ? '1' : '0'
-                when :float then val.to_s.gsub(/\.0*\Z/, '') # Trim trailing zeroes
+                when :bool   then val ? '1' : '0'
+                when :double then val.to_s.gsub(/\.0*\Z/, '') # Trim trailing zeroes
                 else val
                 end
 
@@ -385,7 +390,7 @@ module RubyXL
     class << self
       def define_count_attribute
         # Count will be inherited from Array. so no need to define it explicitly.
-        define_attribute(:count, :int, :required => true, :computed => true)
+        define_attribute(:count, :uint, :required => true, :computed => true)
       end
       protected :define_count_attribute
     end

data/lib/rubyXL/objects/sheet_common.rb

@@ -23,12 +23,12 @@ module RubyXL
 
   # http://www.schemacentral.com/sc/ooxml/e-ssml_pageMargins-1.html
   class PageMargins < OOXMLObject
-    define_attribute(:left,   :float, :required => true)
-    define_attribute(:right,  :float, :required => true)
-    define_attribute(:top,    :float, :required => true)
-    define_attribute(:bottom, :float, :required => true)
-    define_attribute(:header, :float, :required => true)
-    define_attribute(:footer, :float, :required => true)
+    define_attribute(:left,   :double, :required => true)
+    define_attribute(:right,  :double, :required => true)
+    define_attribute(:top,    :double, :required => true)
+    define_attribute(:bottom, :double, :required => true)
+    define_attribute(:header, :double, :required => true)
+    define_attribute(:footer, :double, :required => true)
     define_element_name 'pageMargins'
   end
 

data/lib/rubyXL/objects/sheet_data.rb

@@ -98,7 +98,7 @@ module RubyXL
     define_attribute(:spans,        :string)
     define_attribute(:s,            :int,   :default => 0, :accessor => :style_index)
     define_attribute(:customFormat, :bool,  :default => false)
-    define_attribute(:ht,           :float)
+    define_attribute(:ht,           :double)
     define_attribute(:hidden,       :bool,  :default => false)
     define_attribute(:customHeight, :bool,  :default => false)
     define_attribute(:outlineLevel, :int,   :default => 0)
@@ -125,21 +125,21 @@ module RubyXL
 
     def insert_cell_shift_right(c, col_index)
       cells.insert(col_index, c)
-      col_index.upto(cells.size) { |col|
-        cell = cells[col]
-        next if cell.nil?
-        cell.column = col
-      }
+      update_cell_coords(col_index)
     end
 
     def delete_cell_shift_left(col_index)
       cells.delete_at(col_index)
-      col_index.upto(cells.size) { |col|
-        cell = cells[col]
+      update_cell_coords(col_index)
+    end
+
+    def update_cell_coords(start_from_index)
+      cells.drop(start_from_index).each_with_index { |cell, i|
         next if cell.nil?
-        cell.column = col
+        cell.column = start_from_index + i
       }
     end
+    private :update_cell_coords
 
     def xf
       @worksheet.workbook.cell_xfs[self.style_index || 0]

data/lib/rubyXL/objects/theme.rb

@@ -29,6 +29,7 @@ module RubyXL
 
   # http://www.schemacentral.com/sc/ooxml/e-a_srgbClr-1.html
   class CT_ScRgbColor < OOXMLObject
+    # -- Choice [0..*] (a:EG_ColorTransform)
     define_child_node(RubyXL::IntegerValue, :node_name => 'a:tint')
     define_child_node(RubyXL::IntegerValue, :node_name => 'a:shade')
     define_child_node(RubyXL::BooleanValue, :node_name => 'a:comp')
@@ -65,6 +66,7 @@ module RubyXL
 
   # http://www.schemacentral.com/sc/ooxml/e-a_srgbClr-1.html
   class CT_SRgbColor < OOXMLObject
+    # -- Choice [0..*] (a:EG_ColorTransform)
     define_child_node(RubyXL::IntegerValue, :node_name => 'a:tint')
     define_child_node(RubyXL::IntegerValue, :node_name => 'a:shade')
     define_child_node(RubyXL::BooleanValue, :node_name => 'a:comp')

data/lib/rubyXL/objects/workbook.rb

@@ -188,7 +188,7 @@ module RubyXL
     define_attribute(:refMode,               RubyXL::ST_RefMode, :default => 'A1')
     define_attribute(:iterate,               :bool,   :default => false)
     define_attribute(:iterateCount,          :int,    :default => 100)
-    define_attribute(:iterateDelta,          :float,  :default => 0.001)
+    define_attribute(:iterateDelta,          :double, :default => 0.001)
     define_attribute(:fullPrecision,         :bool,   :default => true)
     define_attribute(:calcCompleted,         :bool,   :default => true)
     define_attribute(:calcOnSave,            :bool,   :default => true)

data/lib/rubyXL/objects/worksheet.rb

@@ -53,15 +53,15 @@ module RubyXL
   end
 
   class WorksheetFormatProperties < OOXMLObject
-    define_attribute(:baseColWidth,     :int,   :default => 8)
-    define_attribute(:defaultColWidth,  :float)
-    define_attribute(:defaultRowHeight, :float, :required => true)
-    define_attribute(:customHeight,     :bool,  :default => false)
-    define_attribute(:zeroHeight,       :bool,  :default => false)
-    define_attribute(:thickTop,         :bool,  :default => false)
-    define_attribute(:thickBottom,      :bool,  :default => false)
-    define_attribute(:outlineLevelRow,  :int,   :default => 0)
-    define_attribute(:outlineLevelCol,  :int,   :default => 0)
+    define_attribute(:baseColWidth,     :int,    :default => 8)
+    define_attribute(:defaultColWidth,  :double)
+    define_attribute(:defaultRowHeight, :double, :required => true)
+    define_attribute(:customHeight,     :bool,   :default => false)
+    define_attribute(:zeroHeight,       :bool,   :default => false)
+    define_attribute(:thickTop,         :bool,   :default => false)
+    define_attribute(:thickBottom,      :bool,   :default => false)
+    define_attribute(:outlineLevelRow,  :int,    :default => 0)
+    define_attribute(:outlineLevelCol,  :int,    :default => 0)
     define_element_name 'sheetFormatPr'
   end
 
@@ -355,8 +355,8 @@ module RubyXL
 
   # http://www.schemacentral.com/sc/ooxml/e-ssml_pane-1.html
   class Pane < OOXMLObject
-    define_attribute(:xSplit,      :int)
-    define_attribute(:ySplit,      :int)
+    define_attribute(:xSplit,      :double)
+    define_attribute(:ySplit,      :double)
     define_attribute(:topLeftCell, :string)
     define_attribute(:activePane,  RubyXL::ST_Pane, :default => 'topLeft', )
     define_attribute(:state,       RubyXL::ST_PaneState, :default=> 'split')

data/lib/rubyXL/worksheet.rb

@@ -900,15 +900,7 @@ module LegacyWorksheet
     sheet_data.rows[row].style_index = @workbook.modify_border(get_row_style(row), direction, weight)
 
     sheet_data[row].cells.each { |c|
-      next if c.nil?
-      case direction
-      when :top      then c.change_border_top(weight)
-      when :left     then c.change_border_left(weight)
-      when :right    then c.change_border_right(weight)
-      when :bottom   then c.change_border_bottom(weight)
-      when :diagonal then c.change_border_diagonal(weight)
-      else raise 'invalid direction'
-      end
+      c.change_border(direction, weight) unless c.nil?
     }
   end
 
@@ -920,15 +912,7 @@ module LegacyWorksheet
 
     sheet_data.rows.each { |row|
       c = row.cells[column_index]
-      next if c.nil?
-      case direction
-      when :top      then c.change_border_top(weight)
-      when :left     then c.change_border_left(weight)
-      when :right    then c.change_border_right(weight)
-      when :bottom   then c.change_border_bottom(weight)
-      when :diagonal then c.change_border_diagonal(weight)
-      else raise 'invalid direction'
-      end
+      c.change_border(direction, weight) unless c.nil?
     }
   end
 

data/rdoc/README_rdoc.html

@@ -4,7 +4,7 @@
 <head>
 <meta charset="UTF-8">
 
-<title>README - rubyXL 3.0.1</title>
+<title>README - rubyXL 3.0.2</title>
 
 <link href="./fonts.css" rel="stylesheet">
 <link href="./rdoc.css" rel="stylesheet">
@@ -119,13 +119,16 @@
 
 <h1 id="label-rubyXL">rubyXL<span><a href="#label-rubyXL">&para;</a> <a href="#documentation">&uarr;</a></span></h1>
 
+<p><a href="https://codeclimate.com/github/weshatheleopard/rubyXL"><img
+src="https://codeclimate.com/github/weshatheleopard/rubyXL.png"></a></p>
+
 <h2 id="label-To+Install%3A">To Install:<span><a href="#label-To+Install%3A">&para;</a> <a href="#documentation">&uarr;</a></span></h2>
 
 <pre>gem install rubyXL</pre>
 
 <h2 id="label-To+Use%3A">To Use:<span><a href="#label-To+Use%3A">&para;</a> <a href="#documentation">&uarr;</a></span></h2>
 
-<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">'rubyXL'</span> <span class="ruby-comment"># Assuming rubygems is already required</span>
+<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;rubyXL&#39;</span> <span class="ruby-comment"># Assuming rubygems is already required</span>
 </pre>
 
 <h3 id="label-Parsing+an+existing+workbook">Parsing an existing workbook<span><a href="#label-Parsing+an+existing+workbook">&para;</a> <a href="#documentation">&uarr;</a></span></h3>
@@ -142,7 +145,7 @@
 
 <pre>workbook.worksheets[0] # Returns first worksheet
 workbook[0]            # Returns first worksheet
-workbook['Sheet1']     # Finds and returns worksheet titled &quot;Sheet1&quot;</pre>
+workbook[&#39;Sheet1&#39;]     # Finds and returns worksheet titled &quot;Sheet1&quot;</pre>
 
 <h4 id="label-Accessing+just+the+values">Accessing just the values<span><a href="#label-Accessing+just+the+values">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
 
@@ -226,16 +229,16 @@ worksheet.get_column_border_right(0)</pre>
 
 <h4 id="label-Adding+Worksheets">Adding Worksheets<span><a href="#label-Adding+Worksheets">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
 
-<pre>worksheet = workbook.add_worksheet('Sheet2')</pre>
+<pre>worksheet = workbook.add_worksheet(&#39;Sheet2&#39;)</pre>
 
 <h4 id="label-Renaming+Worksheets">Renaming Worksheets<span><a href="#label-Renaming+Worksheets">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
 
-<pre>worksheet.sheet_name = 'Cool New Name'</pre>
+<pre>worksheet.sheet_name = &#39;Cool New Name&#39;</pre>
 
 <h4 id="label-Adding+Cells">Adding Cells<span><a href="#label-Adding+Cells">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
 
-<pre>worksheet.add_cell(0, 0, 'A1')      # Sets cell A1 to string &quot;A1&quot;
-worksheet.add_cell(0, 1, '', 'A1')  # Sets formula in the cell B1 to '=A1'</pre>
+<pre>worksheet.add_cell(0, 0, &#39;A1&#39;)      # Sets cell A1 to string &quot;A1&quot;
+worksheet.add_cell(0, 1, &#39;&#39;, &#39;A1&#39;)  # Sets formula in the cell B1 to &#39;=A1&#39;</pre>
 
 <h4 id="label-Changing+Cells">Changing Cells<span><a href="#label-Changing+Cells">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
 
@@ -245,21 +248,21 @@ worksheet.add_cell(0, 1, '', 'A1')  # Sets formula in the cell B1 to '=A1'</pre>
 
 <pre>worksheet.sheet_data[0][0].change_font_bold(true) # Makes A1 bold
 worksheet.change_row_italics(0,true)              # Makes first row italicized
-worksheet.change_column_font_name(0, 'Courier')   # Makes first column have font Courier</pre>
+worksheet.change_column_font_name(0, &#39;Courier&#39;)   # Makes first column have font Courier</pre>
 
 <h4 id="label-Changing+Fills+++++">Changing Fills     <span><a href="#label-Changing+Fills+++++">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
 
-<pre>worksheet.sheet_data[0][0].change_fill('0ba53d')  # Sets A1 to have fill #0ba53d
-worksheet.change_row_fill(0, '0ba53d')            # Sets first row to have fill #0ba53d
-worksheet.change_column_fill(0, '0ba53d')         # Sets first column to have fill #0ba53d</pre>
+<pre>worksheet.sheet_data[0][0].change_fill(&#39;0ba53d&#39;)  # Sets A1 to have fill #0ba53d
+worksheet.change_row_fill(0, &#39;0ba53d&#39;)            # Sets first row to have fill #0ba53d
+worksheet.change_column_fill(0, &#39;0ba53d&#39;)         # Sets first column to have fill #0ba53d</pre>
 
 <h4 id="label-Changing+Borders">Changing Borders<span><a href="#label-Changing+Borders">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
 
 <pre># Possible weights: hairline, thin, medium, thick
 # Possible &quot;directions&quot;: top, bottom, left, right, diagonal
-worksheet.sheet_data[0][0].change_border_top('thin') # Sets A1 to have a top, thin border
-worksheet.change_row_border_left(0, 'hairline')      # Sets first row to have a left, hairline border
-worksheet.change_column_border_diagonal(0, 'medium') # Sets first column to have diagonal, medium border</pre>
+worksheet.sheet_data[0][0].change_border_top(&#39;thin&#39;) # Sets A1 to have a top, thin border
+worksheet.change_row_border_left(0, &#39;hairline&#39;)      # Sets first row to have a left, hairline border
+worksheet.change_column_border_diagonal(0, &#39;medium&#39;) # Sets first column to have diagonal, medium border</pre>
 
 <h4 id="label-Changing+Alignment">Changing Alignment<span><a href="#label-Changing+Alignment">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
 
@@ -267,17 +270,17 @@ worksheet.change_column_border_diagonal(0, 'medium') # Sets first column to have
 
 <p>center, distributed, justify, left, right</p>
 
-<pre>worksheet.sheet_data[0][0].change_horizontal_alignment('center') # Sets A1 to be centered
-worksheet.change_row_horizontal_alignment(0, 'justify')          # Sets first row to be justified
-worksheet.change_column_horizontal_alignment(0, 'right')         # Sets first column to be right-aligned</pre>
+<pre>worksheet.sheet_data[0][0].change_horizontal_alignment(&#39;center&#39;) # Sets A1 to be centered
+worksheet.change_row_horizontal_alignment(0, &#39;justify&#39;)          # Sets first row to be justified
+worksheet.change_column_horizontal_alignment(0, &#39;right&#39;)         # Sets first column to be right-aligned</pre>
 
 <h5 id="label-Vertical">Vertical<span><a href="#label-Vertical">&para;</a> <a href="#documentation">&uarr;</a></span></h5>
 
 <p>bottom, center, distributed, top</p>
 
-<pre>worksheet.sheet_data[0][0].change_vertical_alignment('bottom')  # Sets A1 to be bottom aligned
-worksheet.change_row_vertical_alignment(0, 'distributed')       # Sets first row to be distributed vertically
-worksheet.change_column_vertical_alignment(0, 'top')            # Sets first column to be top aligned</pre>
+<pre>worksheet.sheet_data[0][0].change_vertical_alignment(&#39;bottom&#39;)  # Sets A1 to be bottom aligned
+worksheet.change_row_vertical_alignment(0, &#39;distributed&#39;)       # Sets first row to be distributed vertically
+worksheet.change_column_vertical_alignment(0, &#39;top&#39;)            # Sets first column to be top aligned</pre>
 
 <h4 id="label-Changing+Row+Height">Changing Row Height<span><a href="#label-Changing+Row+Height">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
 
@@ -364,8 +367,8 @@ worksheet.delete_cell(0, 0)         # Deletes A1, does not shift cells</pre>
 
 <h3 id="label-Miscellaneous">Miscellaneous<span><a href="#label-Miscellaneous">&para;</a> <a href="#documentation">&uarr;</a></span></h3>
 
-<pre>Reference.ind2ref(0,0) == 'A1'    # Converts row and column index to Excel-style cell reference
-Reference.ref2ind('A1') == [0, 0] # Converts Excel-style cell reference to row and column index</pre>
+<pre>Reference.ind2ref(0,0) == &#39;A1&#39;    # Converts row and column index to Excel-style cell reference
+Reference.ref2ind(&#39;A1&#39;) == [0, 0] # Converts Excel-style cell reference to row and column index</pre>
 
 <h2 id="label-For+more+information">For more information<span><a href="#label-For+more+information">&para;</a> <a href="#documentation">&uarr;</a></span></h2>
 
@@ -373,11 +376,11 @@ Reference.ref2ind('A1') == [0, 0] # Converts Excel-style cell reference to row a
 
 <h2 id="label-Contributing+to+rubyXL">Contributing to rubyXL<span><a href="#label-Contributing+to+rubyXL">&para;</a> <a href="#documentation">&uarr;</a></span></h2>
 <ul><li>
-<p>Check out the latest master to make sure the feature hasn’t been
-implemented or the bug hasn’t been fixed yet</p>
+<p>Check out the latest master to make sure the feature hasn&#39;t been
+implemented or the bug hasn&#39;t been fixed yet</p>
 </li><li>
-<p>Check out the issue tracker to make sure someone already hasn’t requested
-it and/or contributed it</p>
+<p>Check out the issue tracker to make sure someone already hasn&#39;t
+requested it and/or contributed it</p>
 </li><li>
 <p>Fork the project</p>
 </li><li>
@@ -385,8 +388,8 @@ it and/or contributed it</p>
 </li><li>
 <p>Commit and push until you are happy with your contribution</p>
 </li><li>
-<p>Make sure to add tests for it. This is important so I don’t break it in a
-future version unintentionally.</p>
+<p>Make sure to add tests for it. This is important so I don&#39;t break it in
+a future version unintentionally.</p>
 </li><li>
 <p>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