prismic.io 1.0.0.rc1 → 1.0.0.rc2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: dfc8f36ad84978908dd0e3de61caaf36a354c572
-  data.tar.gz: 9faacc27422f43a5e668136082398036a95a3034
+  metadata.gz: 6f3ceb1f0344bdcb62956f4f7a5cc1726f7bd71d
+  data.tar.gz: 15093ac28e13027b611f19dcf0ef5d0711b9e6f0
 SHA512:
-  metadata.gz: b70799f5a36b767f8635017c7b6451b2162285f38027d578fe7d31844dad2332d23e9afe19685be06af1293773debf7366dbb5a31301c61c42db0bdee4e4c156
-  data.tar.gz: f3b17450288b894a4f5e37943608630c14ae9a990483e5cb6691ac7ca81a984cc7b4602cd3e0d108527a9cee857b0454213e8f15a0eb2bf813d8def439d25594
+  metadata.gz: f01b158ca5911cca23adeb97c1a5113d17d5e40e4a548074fe787ec7737c1b44e6676d56156a808d215ec6e834a7f1fc57c08aad759c7cc1ba49e110f76a3abb
+  data.tar.gz: b62bfd8113a345921a3700e797d1839f49f0257fbd5f68313fdd392a417aa80c5e0244175a7dbfbb5696312f8198aeda44bfc6bc6ce3a4312c83a09183657eee

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    prismic.io (1.0.0.rc1)
+    prismic.io (1.0.0.rc2)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -48,7 +48,7 @@ Thanks to Ruby's syntax, this kit contains some mild differences and syntastic s
 
 ### Changelog
 
-Need to see what changed, or to upgrade your kit? Check out [this kit's changelog](changelog.md).
+Need to see what changed, or to upgrade your kit? We keep our changelog on [this repository's "Releases" tab](https://github.com/prismicio/ruby-kit/releases).
 
 ### Contribute to the kit
 

data/lib/prismic/fragments/link.rb

@@ -4,19 +4,24 @@ module Prismic
     class Link < Fragment
 
       def start_html(link_resolver = nil)
-        %(<a href="#@url">)
+        %(<a href="#{url(link_resolver)}">)
       end
 
-      def end_html(link_resolver = nil)
+      def end_html
         %(</a>)
       end
 
       def as_html(link_resolver=nil)
-        %(#{start_html(link_resolver)}#@url#{end_html(link_resolver)})
+        %(#{start_html(link_resolver)}#{url(link_resolver)}#{end_html})
       end
 
-      def url(link_resolver=nil)
-        @url
+      # Returns the URL of the link
+      #
+      # @abstract See {WebLink#url}, {FileLink#url}, {ImageLink#url} or {DocumentLink#url}
+      #
+      # @param link_resolver [LinkResolver] The link resolver
+      def url(link_resolver = nil)
+        raise NotImplementedError, "Method #{__method__} is not implemented for #{inspect}", caller
       end
 
     end
@@ -27,6 +32,18 @@ module Prismic
       def initialize(url)
         @url = url
       end
+
+      # Returns the URL of the link
+      #
+      # @note The link_resolver parameter is accepted but it is not used by
+      #       this method, so not providing it is perfectly fine.
+      #
+      # @see Link#url
+      #
+      # @param link_resolver [LinkResolver] The link resolver
+      def url(link_resolver = nil)
+        @url
+      end
     end
 
     class FileLink < Link
@@ -40,7 +57,19 @@ module Prismic
       end
 
       def as_html(link_resolver=nil)
-        %(#{start_html(link_resolver)}#@name#{end_html(link_resolver)})
+        %(#{start_html(link_resolver)}#@name#{end_html})
+      end
+
+      # Returns the URL of the link
+      #
+      # @note The link_resolver parameter is accepted but it is not used by
+      #       this method, so not providing it is perfectly fine.
+      #
+      # @see Link#url
+      #
+      # @param link_resolver [LinkResolver]
+      def url(link_resolver = nil)
+        @url
       end
 
     end
@@ -51,6 +80,18 @@ module Prismic
       def initialize(url)
         @url = url
       end
+
+      # Returns the URL of the link
+      #
+      # @note The link_resolver parameter is accepted but it is not used by
+      #       this method, so not providing it is perfectly fine.
+      #
+      # @see Link#url
+      #
+      # @param link_resolver [LinkResolver]
+      def url(link_resolver=nil)
+        @url
+      end
     end
 
     class DocumentLink < Link
@@ -65,18 +106,25 @@ module Prismic
       end
 
       def start_html(link_resolver)
-        broken? ? %(<span>) : %(<a href="#{self.url(link_resolver)}">)
+        broken? ? %(<span>) : super
       end
 
-      def end_html(link_resolver = nil)
-        broken? ? %(</span>) : %(</a>)
+      def end_html
+        broken? ? %(</span>) : super
       end
 
       def as_html(link_resolver=nil)
-        %(#{start_html(link_resolver)}#{slug}#{end_html(link_resolver)})
+        %(#{start_html(link_resolver)}#{slug}#{end_html})
       end
 
-      def url(link_resolver)
+      # Returns the URL of the link
+      #
+      # @overload url(link_resolver)
+      #
+      # @see Link#url
+      #
+      # @param link_resolver [LinkResolver]
+      def url(link_resolver = nil)
         raise "A link_resolver method is needed to serialize document links into a correct URL on your website. If you're using a starter kit, a trivial one is provided out-of-the-box, that you can update later." if link_resolver == nil
         link_resolver.link_to(self)
       end

data/lib/prismic/fragments/structured_text.rb

@@ -100,7 +100,7 @@ module Prismic
           def start_html(link_resolver=nil)
             "<em>"
           end
-          def end_html(link_resolver=nil)
+          def end_html
             "</em>"
           end
         end
@@ -109,7 +109,7 @@ module Prismic
           def start_html(link_resolver=nil)
             "<strong>"
           end
-          def end_html(link_resolver=nil)
+          def end_html
             "</strong>"
           end
         end
@@ -123,8 +123,8 @@ module Prismic
           def start_html(link_resolver = nil)
             link.start_html(link_resolver)
           end
-          def end_html(link_resolver=nil)
-            link.end_html(link_resolver)
+          def end_html
+            link.end_html
           end
         end
       end
@@ -144,22 +144,38 @@ module Prismic
 
           def initialize(text, spans)
             @text = text
-            @spans = spans
+            @spans = spans.select{|span| span.start < span.end}
           end
 
           def as_html(link_resolver=nil)
+            # Getting Hashes of spanning tags to insert, sorted by starting position, and by ending position
             start_spans, end_spans = prepare_spans
-            text.chars.each_with_index.map {|c, i|
-              opening = start_spans[i].map {|span|
-                span.start_html(link_resolver)
-              }
-              closing = end_spans[i].map {|span|
-                span.end_html(link_resolver)
-              }
-              opening + closing + [CGI::escapeHTML(c)]
-            }.flatten.join("")
+            # All the positions in which we'll have to insert an opening or closing tag
+            all_cuts = (start_spans.keys | end_spans.keys).sort
+
+            # Initializing the browsing of the string
+            output = []
+            cursor = 0
+
+            # Taking each text cut and inserting the closing tags and the opening tags if needed
+            all_cuts.each do |cut|
+              output << CGI::escapeHTML(text[cursor, cut-cursor])
+              output << end_spans[cut].map{|span| span.end_html} # this pushes an array into the array; we'll need to flatten later
+              output << start_spans[cut].map{|span| span.start_html(link_resolver)} # this pushes an array into the array; we'll need to flatten later
+              cursor = cut # cursor is now where the cut was
+            end
+
+            # Inserting what's left of the string, if there is something
+            output << text[cursor..-1]
+
+            # Making the array into a string
+            output.flatten.join
+
           end
 
+          # Building two span Hashes:
+          #  * start_spans, with the starting positions as keys, and spans as values
+          #  * end_spans, with the ending positions as keys, and spans as values
           def prepare_spans
             unless defined?(@prepared_spans)
               start_spans = Hash.new{|h,k| h[k] = [] }

data/lib/prismic/version.rb

@@ -1,6 +1,6 @@
 # encoding: utf-8
 module Prismic
 
-  VERSION = "1.0.0.rc1"
+  VERSION = "1.0.0.rc2"
 
 end

data/spec/fragments_spec.rb

@@ -2,11 +2,10 @@
 require 'spec_helper'
 
 describe 'WebLink' do
-  describe 'as_html' do
-    before do
+  before do
       @web_link = Prismic::Fragments::WebLink.new('my_url')
-    end
-
+  end
+  describe 'as_html' do
     it "returns an <a> HTML element" do
       Nokogiri::XML(@web_link.as_html).child.name.should == 'a'
     end
@@ -25,13 +24,34 @@ describe 'WebLink' do
   end
 
   describe 'as_text' do
-    before do
-      @web_link = Prismic::Fragments::WebLink.new('my_url')
-    end
     it 'raises an NotImplementedError' do
       expect { @web_link.as_text }.to raise_error NotImplementedError
     end
   end
+
+  describe 'url' do
+    before do
+      @link_resolver = Prismic.link_resolver("master"){|doc_link| "http://localhost/#{doc_link.id}" }
+    end
+    it 'works in a unified way' do
+      @web_link.url(@link_resolver).should == 'my_url'
+    end
+  end
+end
+
+describe 'DocumentLink' do
+  before do
+    @document_link = Prismic::Fragments::DocumentLink.new("UdUjvt_mqVNObPeO", "product", ["Macaron"], "dark-chocolate-macaron", false)
+  end
+
+  describe 'url' do
+    before do
+      @link_resolver = Prismic.link_resolver("master"){|doc_link| "http://localhost/#{doc_link.id}" }
+    end
+    it 'works in a unified way' do
+      @document_link.url(@link_resolver).should == 'http://localhost/UdUjvt_mqVNObPeO'
+    end
+  end
 end
 
 describe 'ImageLink' do
@@ -63,19 +83,51 @@ describe 'ImageLink' do
       expect { @image_link.as_text }.to raise_error NotImplementedError
     end
   end
+
+  describe 'url' do
+    before do
+      @link_resolver = Prismic.link_resolver("master"){|doc_link| "http://localhost/#{doc_link.id}" }
+    end
+    it 'works in a unified way' do
+      @image_link.url(@link_resolver).should == 'my_url'
+    end
+  end
 end
 
 describe 'FileLink' do
-	describe 'in structured texts' do
-		before do
-			@raw_json_structured_text = File.read("#{File.dirname(__FILE__)}/responses_mocks/structured_text_linkfile.json")
-			@json_structured_text = JSON.parse(@raw_json_structured_text)
-			@structured_text = Prismic::JsonParser.structured_text_parser(@json_structured_text)
-		end
-		it 'serializes well into HTML' do
-			@structured_text.as_html(nil).should == "<p><a href=\"https://prismic-io.s3.amazonaws.com/annual.report.pdf\">2012 Annual Report</p>\n\n<p><a href=\"https://prismic-io.s3.amazonaws.com/annual.budget.pdf\">2012 Annual Budget</p>\n\n<p><a href=\"https://prismic-io.s3.amazonaws.com/vision.strategic.plan_.sm_.pdf\">2015 Vision &amp; Strategic Plan</p>"
-		end
-	end
+  describe 'in structured texts' do
+    before do
+      @raw_json_structured_text = File.read("#{File.dirname(__FILE__)}/responses_mocks/structured_text_linkfile.json")
+      @json_structured_text = JSON.parse(@raw_json_structured_text)
+      @structured_text = Prismic::JsonParser.structured_text_parser(@json_structured_text)
+    end
+    it 'serializes well into HTML' do
+      @structured_text.as_html(nil).should == "<p><a href=\"https://prismic-io.s3.amazonaws.com/annual.report.pdf\">2012 Annual Report</a></p>\n\n<p><a href=\"https://prismic-io.s3.amazonaws.com/annual.budget.pdf\">2012 Annual Budget</a></p>\n\n<p><a href=\"https://prismic-io.s3.amazonaws.com/vision.strategic.plan_.sm_.pdf\">2015 Vision &amp; Strategic Plan</a></p>"
+    end
+  end
+end
+
+describe 'Span' do
+  describe 'in structured texts when end is at the end of line' do
+    before do
+      @raw_json_structured_text = File.read("#{File.dirname(__FILE__)}/responses_mocks/structured_text_with_tricky_spans.json")
+      @json_structured_text = JSON.parse(@raw_json_structured_text)
+      @structured_text = Prismic::JsonParser.structured_text_parser(@json_structured_text)
+    end
+    it 'serializes well into HTML' do
+      @structured_text.as_html(nil).should == "<h3><strong>Powering Through 2013 </strong></h3>\n\n<h3><strong>Online Resources:</strong></h3>\n\n<ul><li>Hear more from our executive team as they reflect on 2013 and share their vision for 2014 on our blog <a href=\"http://prismic.io\">here</a></li></ul>"
+    end
+  end
+  describe 'in structured texts when multiple spans' do
+    before do
+      @raw_json_structured_text = File.read("#{File.dirname(__FILE__)}/responses_mocks/structured_text_paragraph.json")
+      @json_structured_text = JSON.parse(@raw_json_structured_text)
+      @structured_text = Prismic::JsonParser.structured_text_parser(@json_structured_text)
+    end
+    it 'serializes well into HTML' do
+      @structured_text.as_html(nil).should == "<p>Experience <a href=\"http://prismic.io\">the</a> ultimate vanilla experience. Our vanilla Macarons are made with our very own (in-house) <em>pure extract of Madagascar vanilla</em>, and subtly dusted with <strong>our own vanilla sugar</strong> (which we make from real vanilla beans).</p>"
+    end
+  end
 end
 
 describe 'Text' do

data/spec/lesbonneschoses_spec.rb

@@ -63,12 +63,12 @@ describe 'LesBonnesChoses' do
 			it "returns a correct as_html on a StructuredText with list, span, embed and image" do
 				@api.form("everything")
 					.query(%([[:d = at(document.id, "UkL0gMuvzYUANCpr")]]))
-					.submit(@master_ref)[0]['blog-post.body'].as_html(@link_resolver).gsub("&#39;", "'").should == "<h1>Get the right approach to ganache</h1>\n\n<p>A lot of people touch base with us to know about one of our key ingredients, and the essential role it plays in our creations: ganache.</p>\n\n<p>Indeed, ganache is the macaron's softener, or else, macarons would be but tough biscuits; it is the cupcake's wrapper, or else, cupcakes would be but plain old cake. We even sometimes use ganache within our cupcakes, to soften the cake itself, or as a support to our pies' content.</p>\n\n<h2>How to approach ganache</h2>\n\n<img src=\"https://prismic-io.s3.amazonaws.com/lesbonneschoses/ee7b984b98db4516aba2eabd54ab498293913c6c.jpg\" alt=\"\" width=\"640\" height=\"425\" />\n\n<p>Apart from the taste balance, which is always a challenge when it comes to pastry, the tough part about ganache is about thickness. It is even harder to predict through all the phases the ganache gets to meet (how long will it get melted? how long will it remain in the fridge?). Things get a hell of a lot easier to get once you consider that there are two main ways to get the perfect ganache:</p>\n\n<ul><li><strong>working from the top down</strong>: start with a thick, almost hard material, and soften it by manipulating it, or by mixing it with a more liquid ingredient (like milk)</li><li><strong>working from the bottom up</strong>: start from a liquid-ish state, and harden it by miwing it with thicker ingredients, or by leaving it in the fridge longer.</li></ul>\n\n<p>We do hope this advice will empower you in your ganache-making skills. Let us know how you did with it!</p>\n\n<h2>Ganache at <em>Les Bonnes Choses</h2>\n\n<p>We have a saying at Les Bonnes Choses: &quot;Once you can make ganache, you can make anything.&quot;</p>\n\n<p>As you may know, we like to give our workshop artists the ability to master their art to the top; that is why our Preparation Experts always start off as being Ganache Specialists for Les Bonnes Choses. That way, they're given an opportunity to focus on one exercise before moving on. Once they master their ganache, and are able to provide the most optimal delight to our customers, we consider they'll thrive as they work on other kinds of preparations.</p>\n\n<h2>About the chocolate in our ganache</h2>\n\n<p>Now, we've also had a lot of questions about how our chocolate gets made. It's true, as you might know, that we make it ourselves, from Columbian cocoa and French cow milk, with a process that much resembles the one in the following Discovery Channel documentary.</p>\n\n        <div data-oembed=\"http://www.youtube.com/\"\n            data-oembed-type=\"video\"\n            data-oembed-provider=\"youtube\"><iframe width=\"459\" height=\"344\" src=\"http://www.youtube.com/embed/Ye78F3-CuXY?feature=oembed\" frameborder=\"0\" allowfullscreen></iframe></div>\n"
+					.submit(@master_ref)[0]['blog-post.body'].as_html(@link_resolver).gsub("&#39;", "'").should == "<h1>Get the right approach to ganache</h1>\n\n<p>A lot of people touch base with us to know about one of our key ingredients, and the essential role it plays in our creations: ganache.</p>\n\n<p>Indeed, ganache is the macaron's softener, or else, macarons would be but tough biscuits; it is the cupcake's wrapper, or else, cupcakes would be but plain old cake. We even sometimes use ganache within our cupcakes, to soften the cake itself, or as a support to our pies' content.</p>\n\n<h2>How to approach ganache</h2>\n\n<img src=\"https://prismic-io.s3.amazonaws.com/lesbonneschoses/ee7b984b98db4516aba2eabd54ab498293913c6c.jpg\" alt=\"\" width=\"640\" height=\"425\" />\n\n<p>Apart from the taste balance, which is always a challenge when it comes to pastry, the tough part about ganache is about thickness. It is even harder to predict through all the phases the ganache gets to meet (how long will it get melted? how long will it remain in the fridge?). Things get a hell of a lot easier to get once you consider that there are two main ways to get the perfect ganache:</p>\n\n<ul><li><strong>working from the top down</strong>: start with a thick, almost hard material, and soften it by manipulating it, or by mixing it with a more liquid ingredient (like milk)</li><li><strong>working from the bottom up</strong>: start from a liquid-ish state, and harden it by miwing it with thicker ingredients, or by leaving it in the fridge longer.</li></ul>\n\n<p>We do hope this advice will empower you in your ganache-making skills. Let us know how you did with it!</p>\n\n<h2>Ganache at <em>Les Bonnes Choses</em></h2>\n\n<p>We have a saying at Les Bonnes Choses: \"Once you can make ganache, you can make anything.\"</p>\n\n<p>As you may know, we like to give our workshop artists the ability to master their art to the top; that is why our Preparation Experts always start off as being Ganache Specialists for Les Bonnes Choses. That way, they're given an opportunity to focus on one exercise before moving on. Once they master their ganache, and are able to provide the most optimal delight to our customers, we consider they'll thrive as they work on other kinds of preparations.</p>\n\n<h2>About the chocolate in our ganache</h2>\n\n<p>Now, we've also had a lot of questions about how our chocolate gets made. It's true, as you might know, that we make it ourselves, from Columbian cocoa and French cow milk, with a process that much resembles the one in the following Discovery Channel documentary.</p>\n\n        <div data-oembed=\"http://www.youtube.com/\"\n            data-oembed-type=\"video\"\n            data-oembed-provider=\"youtube\"><iframe width=\"459\" height=\"344\" src=\"http://www.youtube.com/embed/Ye78F3-CuXY?feature=oembed\" frameborder=\"0\" allowfullscreen></iframe></div>\n"
 			end
 			it "returns a correct as_html on a StructuredText with links" do
 				@api.form("everything")
 					.query(%([[:d = at(document.id, "#{@api.bookmark('about')}")]]))
-					.submit(@master_ref)[0]['article.content'].as_html(@link_resolver).gsub("&#39;", "'").should == "<h2>A tale of pastry and passion</h2>\n\n<p>As a child, Jean-Michel Pastranova learned the art of fine cuisine from his grand-father, Jacques Pastranova, who was the creator of the &quot;taste-design&quot; art current, and still today an unmissable reference of forward-thinking in cuisine. At first an assistant in his grand-father's kitchen, Jean-Michel soon found himself fascinated by sweet flavors and the tougher art of pastry, drawing his own path in the ever-changing cuisine world.</p>\n\n<p>In 1992, the first Les Bonnes Choses store opened on rue Saint-Lazare, in Paris (<a href=\"http://localhost/UkL0gMuvzYUANCpa\">we're still there!</a>), much to everyone's surprise; indeed, back then, it was very surprising for a highly promising young man with a preordained career as a restaurant chef, to open a pastry shop instead. But soon enough, contemporary chefs understood that Jean-Michel had the drive to redefine a new nobility to pastry, the same way many other kinds of cuisine were being qualified as &quot;fine&quot;.</p>\n\n<p>In 1996, meeting an overwhelming demand, Jean-Michel Pastranova opened <a href=\"http://localhost/UkL0gMuvzYUANCpX\">a second shop on Paris's Champs-Élysées</a>, and <a href=\"http://localhost/UkL0gMuvzYUANCpY\">a third one in London</a>, the same week! Eventually, Les Bonnes Choses gained an international reputation as &quot;a perfection so familiar and new at the same time, that it will feel like a taste travel&quot; (New York Gazette), &quot;the finest balance between surprise and comfort, enveloped in sweetness&quot; (The Tokyo Tribune), &quot;a renewal of the pastry genre (...), the kind that changed the way pastry is approached globally&quot; (The San Francisco Gourmet News). Therefore, it was only a matter of time before Les Bonnes Choses opened shops in <a href=\"http://localhost/UkL0gMuvzYUANCpW\">New York</a> (2000) and <a href=\"http://localhost/UkL0gMuvzYUANCpZ\">Tokyo</a> (2004).</p>\n\n<p>In 2013, Jean-Michel Pastranova stepped down as the CEO and Director of Workshops, remaining a senior advisor to the board and to the workshop artists; he passed the light on to Selena, his daugther, who initially learned the art of pastry from him. Passion for great food runs in the Pastranova family...</p>\n\n<img src=\"https://prismic-io.s3.amazonaws.com/lesbonneschoses/df6c1d87258a5bfadf3479b163fd85c829a5c0b8.jpg\" alt=\"\" width=\"800\" height=\"533\" />\n\n<h2>Our main value: our customers' delight</h2>\n\n<p>Our every action is driven by the firm belief that there is art in pastry, and that this art is one of the dearest pleasures one can experience.</p>\n\n<p>At Les Bonnes Choses, people preparing your macarons are not simply &quot;pastry chefs&quot;: they are &quot;<a href=\"http://localhost/UkL0gMuvzYUANCpe\">ganache specialists</a>&quot;, &quot;<a href=\"http://localhost/UkL0gMuvzYUANCpc\">fruit experts</a>&quot;, or &quot;<a href=\"http://localhost/UkL0gMuvzYUANCpb\">oven instrumentalists</a>&quot;. They are the best people out there to perform the tasks they perform to create your pastry, giving it the greatest value. And they just love to make their specialized pastry skill better and better until perfection.</p>\n\n<p>Of course, there is a workshop in each <em>Les Bonnes Choses</em> store, and every pastry you buy was made today, by the best pastry specialists in your country.</p>\n\n<p>However, the very difficult art of creating new concepts, juggling with tastes and creating brand new, powerful experiences, is performed every few months, during our &quot;<a href=\"http://localhost/UkL0gMuvzYUANCpo\">Pastry Art Brainstorms</a>&quot;. During the event, the best pastry artists in the world (some working for <em>Les Bonnes Choses</em>, some not) gather in Paris, and showcase the experiments they've been working on; then, the other present artists comment on the piece, and iterate on it together, in order to make it the best possible masterchief!</p>\n\n<p>The session is presided by Jean-Michel Pastranova, who then selects the most delightful experiences, to add it to <em>Les Bonnes Choses</em>'s catalogue.</p>"
+					.submit(@master_ref)[0]['article.content'].as_html(@link_resolver).gsub("&#39;", "'").should == "<h2>A tale of pastry and passion</h2>\n\n<p>As a child, Jean-Michel Pastranova learned the art of fine cuisine from his grand-father, Jacques Pastranova, who was the creator of the \"taste-design\" art current, and still today an unmissable reference of forward-thinking in cuisine. At first an assistant in his grand-father's kitchen, Jean-Michel soon found himself fascinated by sweet flavors and the tougher art of pastry, drawing his own path in the ever-changing cuisine world.</p>\n\n<p>In 1992, the first Les Bonnes Choses store opened on rue Saint-Lazare, in Paris (<a href=\"http://localhost/UkL0gMuvzYUANCpa\">we're still there!</a>), much to everyone's surprise; indeed, back then, it was very surprising for a highly promising young man with a preordained career as a restaurant chef, to open a pastry shop instead. But soon enough, contemporary chefs understood that Jean-Michel had the drive to redefine a new nobility to pastry, the same way many other kinds of cuisine were being qualified as \"fine\".</p>\n\n<p>In 1996, meeting an overwhelming demand, Jean-Michel Pastranova opened <a href=\"http://localhost/UkL0gMuvzYUANCpX\">a second shop on Paris's Champs-Élysées</a>, and <a href=\"http://localhost/UkL0gMuvzYUANCpY\">a third one in London</a>, the same week! Eventually, Les Bonnes Choses gained an international reputation as &quot;a perfection so familiar and new at the same time, that it will feel like a taste travel&quot; (New York Gazette), &quot;the finest balance between surprise and comfort, enveloped in sweetness&quot; (The Tokyo Tribune), &quot;a renewal of the pastry genre (...), the kind that changed the way pastry is approached globally&quot; (The San Francisco Gourmet News). Therefore, it was only a matter of time before Les Bonnes Choses opened shops in <a href=\"http://localhost/UkL0gMuvzYUANCpW\">New York</a> (2000) and <a href=\"http://localhost/UkL0gMuvzYUANCpZ\">Tokyo</a> (2004).</p>\n\n<p>In 2013, Jean-Michel Pastranova stepped down as the CEO and Director of Workshops, remaining a senior advisor to the board and to the workshop artists; he passed the light on to Selena, his daugther, who initially learned the art of pastry from him. Passion for great food runs in the Pastranova family...</p>\n\n<img src=\"https://prismic-io.s3.amazonaws.com/lesbonneschoses/df6c1d87258a5bfadf3479b163fd85c829a5c0b8.jpg\" alt=\"\" width=\"800\" height=\"533\" />\n\n<h2>Our main value: our customers' delight</h2>\n\n<p>Our every action is driven by the firm belief that there is art in pastry, and that this art is one of the dearest pleasures one can experience.</p>\n\n<p>At Les Bonnes Choses, people preparing your macarons are not simply &quot;pastry chefs&quot;: they are &quot;<a href=\"http://localhost/UkL0gMuvzYUANCpe\">ganache specialists</a>&quot;, &quot;<a href=\"http://localhost/UkL0gMuvzYUANCpc\">fruit experts</a>&quot;, or &quot;<a href=\"http://localhost/UkL0gMuvzYUANCpb\">oven instrumentalists</a>\". They are the best people out there to perform the tasks they perform to create your pastry, giving it the greatest value. And they just love to make their specialized pastry skill better and better until perfection.</p>\n\n<p>Of course, there is a workshop in each <em>Les Bonnes Choses</em> store, and every pastry you buy was made today, by the best pastry specialists in your country.</p>\n\n<p>However, the very difficult art of creating new concepts, juggling with tastes and creating brand new, powerful experiences, is performed every few months, during our &quot;<a href=\"http://localhost/UkL0gMuvzYUANCpo\">Pastry Art Brainstorms</a>&quot;. During the event, the best pastry artists in the world (some working for <em>Les Bonnes Choses</em>, some not) gather in Paris, and showcase the experiments they've been working on; then, the other present artists comment on the piece, and iterate on it together, in order to make it the best possible masterchief!</p>\n\n<p>The session is presided by Jean-Michel Pastranova, who then selects the most delightful experiences, to add it to <em>Les Bonnes Choses</em>'s catalogue.</p>"
 			end
 			it "returns a correct as_text on a StructuredText" do
 				@api.form("everything")

data/spec/responses_mocks/structured_text_paragraph.json

@@ -10,8 +10,8 @@
       "type": "em"
     },
     {
-      "start": 10,
-      "end": 13,
+      "start": 11,
+      "end": 14,
       "type": "hyperlink",
       "data": {
         "type": "Link.web",

data/spec/responses_mocks/structured_text_with_tricky_spans.json

@@ -0,0 +1,44 @@
+{
+	"type": "StructuredText",
+	"value" : [
+		{
+			"type" : "heading3",
+			"text" : "Powering Through 2013 ",
+			"spans" : [
+				{
+					"start": 0, 
+					"end": 22,
+					"type": "strong"
+				}
+			]
+		},
+		{
+			"type" : "heading3",
+			"text" : "Online Resources:",
+			"spans" : [
+				{
+					"start": 0, 
+					"end": 17,
+					"type": "strong"
+				}
+			]
+		},
+		{
+			"type" : "list-item",
+			"text" : "Hear more from our executive team as they reflect on 2013 and share their vision for 2014 on our blog here",
+			"spans" : [
+				{
+					"start" : 102,
+					"end" : 106,
+					"type" : "hyperlink",
+					"data" : {
+						"type" : "Link.web",
+						"value" : {
+							"url" : "http://prismic.io"
+						}
+					}
+				}
+			]
+		}
+	]
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: prismic.io
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc1
+  version: 1.0.0.rc2
 platform: ruby
 authors:
 - Étienne Vallette d'Osia
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-29 00:00:00.000000000 Z
+date: 2014-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -80,7 +80,6 @@ files:
 - Gemfile.lock
 - README.md
 - Rakefile
-- changelog.md
 - lib/prismic.rb
 - lib/prismic/api.rb
 - lib/prismic/form.rb
@@ -111,6 +110,7 @@ files:
 - spec/responses_mocks/structured_text_heading.json
 - spec/responses_mocks/structured_text_linkfile.json
 - spec/responses_mocks/structured_text_paragraph.json
+- spec/responses_mocks/structured_text_with_tricky_spans.json
 - spec/spec_helper.rb
 homepage: http://prismic.io
 licenses:
@@ -132,7 +132,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.0
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Prismic.io development kit
@@ -148,4 +148,6 @@ test_files:
 - spec/responses_mocks/structured_text_heading.json
 - spec/responses_mocks/structured_text_linkfile.json
 - spec/responses_mocks/structured_text_paragraph.json
+- spec/responses_mocks/structured_text_with_tricky_spans.json
 - spec/spec_helper.rb
+has_rdoc: 

data/changelog.md

@@ -1,42 +0,0 @@
-## Changelog for prismic.io Ruby development kit
-
-### prismic.io.1.0.0.rc1
-
-#### Potentially breaking changes for advanced users
-
- * **If you've been monkey-patching or overriding the `Prismic::Fragments::MediaLink`** class: it doesn't exist anymore, and is now replaced by `Prismic::Fragments::FileLink` or `Prismic::Fragments::ImageLink`, depending on the kind of link.
-
-#### New features
- * Support for `Link.image` and `Link.file` kinds of links, with new `Prismic::Fragments::FileLink` and `Prismic::Fragments::ImageLink` classes.
- * `Prismic::Fragments::Group` class now includes `Enumerable`, which means you can use `each`, `map`, `select`, etc. on `Group` objects. Same with `Prismic::Fragments::Group::FragmentMapping` objects (used internally by the `Group` class).
- * `Prismic::Fragments::Group` class now have a `length` method, aliased as `size`. Same with `Prismic::Fragments::Group::FragmentMapping` objects (used internally by the `Group` class).
- * The `url` method only existed for the `Prismic::Fragments::WebLink` class, now it is directly in the `Prismic::Fragments::Link` class, extended by all links classes: `Prismic::Fragments::WebLink`, `Prismic::Fragments::DocumentLink`, etc...
-
-#### Syntactic sugar
- *  Since you can now call `url` on any kind of link (see right above), this allows to do this in Rails, regardless of the kind of link the `link` object is: `<%= link_to "Click here", link.url, :whatever_attribute => "whatever value" %>`.
-
-### prismic.io.1.0.0.preview.8
-
-#### New features
- * Support for group fragments.
- * Support for unknown fragments (instead of crashing, ignores the fragment with a warning advising to update the kit).
-
-#### Syntactic sugar
- * `Prismic::API#create_search_form` is now `Prismic::API#form` (the former issues a deprecation warning, and will be removed in a later release); the online cross-tech doc was adapted to reflect that possibility.
-
-### prismic.io.1.0.0.preview.7
-
-#### Potentially breaking changes for basic users
- * Boldness in `Prismic::Fragments::StructuredText#as_html` was represented as `<b>` tags, now as `<strong>` tags.
-
-#### New features
- * You had to call `Prismic::Link_resolver#link_to` on a `Prismic::Fragments::DocumentLink` object, but sometimes, you actually have the full `Prismic::Document`; you can now call it on both types of objects.
- * You had to call `api.master_ref` to get the master ref; now you can call it `api.master`, just like in the other dev kits; both methods do the same thing.
- * New method: `Prismic::Fragments::StructuredText#as_text`, renders zero formatting, and ignores images and embeds.
- * `Prismic::SearchForm` only had the `query` method to set the `q` parameter of the API call. Now those methods are dynamically created from the RESTful form found in the `/api` document, so it's now possible to use those methods too: `orderings`, `page`, `pageSize`, as well as all the future non-yet-existing ones.
-
-
-### prismic.io.1.0.0.preview.6
-
-#### Potentially breaking changes for basic users
- * From an image, you had to call the view with its index, like this `image_object[0]`; now they're stored in a Hash, you have to call them with their proper name: `image_object['large']`.