Add multiple-line insertion capability for bookmarks

Author: chrahunt

lib/docx/containers/container.rb

@@ -10,6 +10,7 @@ def properties
           @node.at_xpath("./#{@properties_tag}")
         end
 
+        # TODO: Maybe merge and then clear so there is only one text node left.
         def blank!
           @node.xpath(".//w:t").each {|t| t.content = '' }
         end

lib/docx/elements/bookmark.rb

@@ -23,6 +23,27 @@ def insert_text_after(text)
         text_run.text = "#{text_run.text}#{text}"
       end
 
+      def insert_multiple_lines(text_array)
+        # Hold paragraphs to be inserted into, corresponding to the index of the strings in the text array
+        paragraphs = []
+        paragraph = self.parent_paragraph
+        # Remove text from paragraph
+        paragraph.blank!
+        paragraphs << paragraph
+        for i in 0..(text_array.size - 1)
+          # Copy previous paragraph
+          new_p = paragraphs[i].copy
+          # Insert as sibling of previous paragraph
+          new_p.insert_after(paragraphs[i])
+          paragraphs << new_p
+        end
+
+        # Insert text into corresponding newly created paragraphs
+        paragraphs.each_index do |index|
+          paragraphs[index].text = text_array[index]
+        end
+      end
+
       def get_run_before
         # at_xpath returns the first match found and preceding-sibling returns siblings in the 
         # order they appear in the document not the order as they appear when moving out from

lib/docx/elements/element.rb

@@ -1,4 +1,6 @@
 require 'nokogiri'
+require 'docx/elements'
+require 'docx/containers'
 
 module Docx
   module Elements
@@ -19,8 +21,8 @@ def parent(type = '*')
       end
 
       # TODO: Should create a docx paragraph from this
-      def paragraph
-        parent('w:p')
+      def parent_paragraph
+        Elements::Containers::Paragraph.new(parent('w:p'))
       end
 
       # Insertion methods

test/docx/test_editing.rb

@@ -40,6 +40,24 @@ def test_inserting_text_after_bookmark
     assert_equal 'test textbar', @doc.paragraphs.first.text
   end
 
+  def test_inserting_multiple_lines_at_bookmark
+    assert_equal '', @doc.paragraphs.last.text
+    new_lines = ['replacement test', 'second paragraph test', 'and a third paragraph test']
+    @doc.bookmarks['isolated_bookmark'].insert_multiple_lines(new_lines)
+    new_lines.each_index do |line|
+      assert_equal new_lines[line], @doc.paragraphs[line + 2].text
+    end
+  end
+
+  def test_inserting_multiple_lines_at_bookmark_with_replacement
+    assert_equal 'placeholder text', @doc.paragraphs[1].text
+    new_lines = ['replacement test', 'second paragraph test', 'and a third paragraph test']
+    @doc.bookmarks['word_splitting_bookmark'].insert_multiple_lines(new_lines)
+    new_lines.each_index do |line|
+      assert_equal new_lines[line], @doc.paragraphs[line + 1].text
+    end
+  end
+
   # Insert text intelligently around bookmark
   def test_inserting_text_around_bookmark