prismic.io 1.4.1 → 1.4.2

data/deploy-doc.sh

@@ -1,9 +0,0 @@
-yard && \
-cd doc && \
-rm -rf doc/phpdoc-cache-* && \
-git init . && \
-git add . && \
-git commit -m "Update documentation."; \
-git push "git@github.com:prismicio/ruby-kit.git" master:gh-pages --force && \
-rm -rf .git
-

data/spec/doc_spec.rb

@@ -1,298 +0,0 @@
-# encoding: utf-8
-require 'spec_helper'
-
-describe 'Documentation' do
-
-  describe 'api' do
-
-    it 'api.get' do
-      # startgist:983989438334c8bf7967:prismic-api.rb
-      api = Prismic.api('https://lesbonneschoses.cdn.wroom.io/api')
-      # endgist
-      api.should_not be_nil
-    end
-
-    it 'apiPrivate' do
-      expect {
-        # startgist:efecc8f60b1f69bada81:prismic-apiPrivate.rb
-        # This will fail because the token is invalid, but this is how to access a private API
-        api = Prismic.api('https://lesbonneschoses.cdn.prismic.io/api', 'MC5-XXXXXXX-vRfvv70')
-        # endgist
-        # err.message, "Unexpected status code [401] on URL https://lesbonneschoses.cdn.prismic.io/api?access_token=MC5-XXXXXXX-vRfvv70"); // gisthide
-      }.to raise_error(Prismic::API::PrismicWSAuthError, "Can't connect to Prismic's API: Invalid access token")
-    end
-
-    it 'references' do
-      # startgist:55a7ef6bc691bf3c4929:prismic-references.rb
-      preview_token = 'MC5VbDdXQmtuTTB6Z0hNWHF3.c--_vVbvv73vv73vv73vv71EA--_vS_vv73vv70T77-9Ke-_ve-_vWfvv70ebO-_ve-_ve-_vQN377-9ce-_vRfvv70';
-      api = Prismic.api('https://lesbonneschoses.cdn.prismic.io/api', preview_token)
-      st_patrick_ref = api.ref('St-Patrick specials')
-      # Now we'll use this reference for all our calls
-      response = api.query(Prismic::Predicates::at('document.type', 'product'), 'ref' => st_patrick_ref)
-      # The Response object contains all documents of type "product"
-      # including the new "Saint-Patrick's Cupcake"
-      # endgist
-      response.results.length.should == 17
-    end
-
-  end
-
-  describe 'queries' do
-
-    it 'simple query' do
-      # startgist:f1007f1c4c4bc94f9fc6:prismic-simplequery.rb
-      api = Prismic.api('https://lesbonneschoses.cdn.prismic.io/api')
-      response = api
-        .form('everything')
-        .query(Prismic::Predicates::at('document.type', 'product'))
-        .submit(api.master_ref)
-      # response contains all documents of type 'product', paginated
-      # endgist
-      response.results.size.should == 16
-    end
-
-    it 'orderings' do
-      # startgist:f987025745dbbf26e817:prismic-orderings.rb
-      api = Prismic.api('https://lesbonneschoses.cdn.prismic.io/api')
-      response = api.form('everything')
-        .ref(api.master_ref)
-        .query(Prismic::Predicates::at('document.type', 'product'))
-        .page_size(100)
-        .orderings('[my.product.price desc]')
-        .submit
-      # The products are now ordered by price, highest first
-      results = response.results
-      # endgist
-      response.results_per_page.should == 100
-    end
-
-    it 'predicates' do
-      # startgist:7b93db67fa25ac386603:prismic-predicates.rb
-      api = Prismic.api('https://lesbonneschoses.cdn.prismic.io/api')
-      response = api
-        .form('everything')
-        .query(
-          Prismic::Predicates::at('document.type', 'product'),
-          Prismic::Predicates::date_after('my.blog-post.date', 1401580800000))
-        .submit(api.master_ref)
-      # endgist
-      response.results.size.should == 0
-    end
-
-    it 'all predicates' do
-      # startgist:1efb7363a5f573627308:prismic-allPredicates.rb
-      # 'at' predicate: equality of a fragment to a value.
-      at = Predicates::at('document.type', 'article')
-      # 'any' predicate: equality of a fragment to a value.
-      any = Predicates::any('document.type', ['article', 'blog-post'])
-
-      # 'fulltext' predicate: fulltext search in a fragment.
-      fulltext = Predicates::fulltext('my.article.body', 'sausage')
-
-      # 'similar' predicate, with a document id as reference
-      similar = Predicates::similar('UXasdFwe42D', 10)
-      # endgist
-      at.should == ['at', 'document.type', 'article']
-      any.should == ['any', 'document.type', ['article', 'blog-post']]
-    end
-
-  end
-
-  describe 'fragments' do
-
-    it 'text' do
-      api = Prismic::api('https://lesbonneschoses.cdn.prismic.io/api')
-      doc = api.getByID('UlfoxUnM0wkXYXbl')
-      # startgist:4cbc1abffe7cc1209f95:prismic-getText.rb
-      author = doc.get_text('blog-post.author')
-      if author == nil
-        name = 'Anonymous'
-      else
-        name = author.value
-      end
-      # endgist
-      name.should == 'John M. Martelle, Fine Pastry Magazine'
-    end
-
-    it 'number' do
-      api = Prismic::api('https://lesbonneschoses.cdn.prismic.io/api')
-      response = api.form('everything')
-        .query(Predicates::at('document.id', 'UlfoxUnM0wkXYXbO'))
-        .ref(api.master_ref)
-        .submit
-      doc = response[0]
-      # startgist:4e263ac039e0b0cea0be:prismic-getNumber.rb
-      # Number predicates
-      gt = Predicates::gt('my.product.price', 10)
-      lt = Predicates::lt('my.product.price', 20)
-      in_range = Predicates::in_range('my.product.price', 10, 20)
-
-      # Accessing number fields
-      price = doc.get_number('product.price').value
-      # endgist
-      price.should == 2.5
-    end
-
-    it 'images' do
-      api = Prismic::api('https://lesbonneschoses.cdn.prismic.io/api')
-      response = api.form('everything')
-        .query(Predicates::at('document.id', 'UlfoxUnM0wkXYXbO'))
-        .ref(api.master_ref)
-        .submit
-      doc = response[0]
-      # startgist:154ba379a5000f14b3ea:prismic-images.rb
-      # Accessing image fields
-      image = doc.get_image('product.image')
-      # Most of the time you will be using the "main" view
-      url = image.main.url
-      # endgist
-      url.should == 'https://d2aw36oac6sa9o.cloudfront.net/lesbonneschoses/f606ad513fcc2a73b909817119b84d6fd0d61a6d.png'
-    end
-
-    it 'date and timestamp' do
-      api = Prismic::api('https://lesbonneschoses.cdn.prismic.io/api')
-      response = api.form('everything')
-        .query(Predicates::at('document.id', 'UlfoxUnM0wkXYXbl'))
-        .ref(api.master_ref)
-        .submit
-      doc = response[0]
-      # startgist:4ac2db89bde0ca0c2b33:prismic-dateTimestamp.rb
-      # Date and Timestamp predicates
-      dateBefore = Predicates::date_before('my.product.releaseDate', Time.new(2014, 6, 1))
-      dateAfter = Predicates::date_after('my.product.releaseDate', Time.new(2014, 1, 1))
-      dateBetween = Predicates::date_between('my.product.releaseDate', Time.new(2014, 1, 1), Time.new(2014, 6, 1))
-      dayOfMonth = Predicates::day_of_month('my.product.releaseDate', 14)
-      dayOfMonthAfter = Predicates::day_of_month_after('my.product.releaseDate', 14)
-      dayOfMonthBefore = Predicates::day_of_month_before('my.product.releaseDate', 14)
-      dayOfWeek = Predicates::day_of_week('my.product.releaseDate', 'Tuesday')
-      dayOfWeekAfter = Predicates::day_of_week_after('my.product.releaseDate', 'Wednesday')
-      dayOfWeekBefore = Predicates::day_of_week_before('my.product.releaseDate', 'Wednesday')
-      month = Predicates::month('my.product.releaseDate', 'June')
-      monthBefore = Predicates::month_before('my.product.releaseDate', 'June')
-      monthAfter = Predicates::month_after('my.product.releaseDate', 'June')
-      year = Predicates::year('my.product.releaseDate', 2014)
-      hour = Predicates::hour('my.product.releaseDate', 12)
-      hourBefore = Predicates::hour_before('my.product.releaseDate', 12)
-      hourAfter = Predicates::hour_after('my.product.releaseDate', 12)
-
-      # Accessing Date and Timestamp fields
-      date = doc.get_date('blog-post.date').value
-      date_year = date ? date.year : nil
-      update_time = doc.get_timestamp('blog-post.update')
-      update_hour = update_time ? update_time.value.hour : nil
-      # endgist
-      date_year.should == 2013
-    end
-
-    it 'group' do
-      json = '{"id":"abcd","type":"article","href":"","slugs":[],"tags":[],"data":{"article":{"documents":{"type":"Group","value":[{"linktodoc":{"type":"Link.document","value":{"document":{"id":"UrDejAEAAFwMyrW9","type":"doc","tags":[],"slug":"installing-meta-micro"},"isBroken":false}},"desc":{"type":"StructuredText","value":[{"type":"paragraph","text":"A detailed step by step point of view on how installing happens.","spans":[]}]}},{"linktodoc":{"type":"Link.document","value":{"document":{"id":"UrDmKgEAALwMyrXA","type":"doc","tags":[],"slug":"using-meta-micro"},"isBroken":false}}}]}}}}'
-      document = Prismic::JsonParser.document_parser(JSON.load(json))
-      resolver = Prismic.link_resolver('master') { |doc_link| "http://localhost/#{doc_link.id}" }
-      # startgist:4c87bd640086b9094151:prismic-group.rb
-      group = document.get_group('article.documents')
-      docs = group ? group : []
-      docs.each do |doc|
-        # Desc and Link are Fragments, their type depending on what's declared in the Document Mask
-        desc = doc['desc']
-        link = doc['linktodoc']
-      end
-      # endgist
-      docs[0]['desc'].as_html(resolver).should == '<p>A detailed step by step point of view on how installing happens.</p>'
-    end
-
-    it 'link' do
-      json = '{"id":"abcd","type":"article","href":"","slugs":[],"tags":[],"data":{"article":{"source":{"type":"Link.document","value":{"document":{"id":"UlfoxUnM0wkXYXbE","type":"product","tags":["Macaron"],"slug":"dark-chocolate-macaron"},"isBroken":false}}}}}'
-      document = Prismic::JsonParser.document_parser(JSON.load(json))
-      # startgist:762dfce77d215e6c70b0:prismic-link.rb
-      resolver = Prismic.link_resolver('master') { |doc_link| "http://localhost/#{doc_link.id}/#{doc_link.slug}" }
-      source = document.get_link('article.source')
-      url = source ? source.url(resolver) : nil
-      # endgist
-      url.should == 'http://localhost/UlfoxUnM0wkXYXbE/dark-chocolate-macaron'
-    end
-
-    it 'embed' do
-      json = '{"id":"abcd","type":"article","href":"","slugs":[],"tags":[],"data":{"article":{"video":{"type":"Embed","value":{"oembed":{"provider_url":"http://www.youtube.com/","type":"video","thumbnail_height":360,"height":270,"thumbnail_url":"http://i1.ytimg.com/vi/baGfM6dBzs8/hqdefault.jpg","width":480,"provider_name":"YouTube","html":"<iframe width=\\"480\\" height=\\"270\\" src=\\"http://www.youtube.com/embed/baGfM6dBzs8?feature=oembed\\" frameborder=\\"0\\" allowfullscreen></iframe>","author_name":"Siobhan Wilson","version":"1.0","author_url":"http://www.youtube.com/user/siobhanwilsonsongs","thumbnail_width":480,"title":"Siobhan Wilson - All Dressed Up","embed_url":"https://www.youtube.com/watch?v=baGfM6dBzs8"}}}}}}'
-      document = Prismic::JsonParser.document_parser(JSON.load(json))
-      # startgist:86d937da7ba242ea981f:prismic-embed.rb
-      video = document.get_embed('article.video')
-      # Html is the code to include to embed the object, and depends on the embedded service
-      html = video ? video.as_html : ''
-      # endgist
-      html.should == '<div data-oembed="http://www.youtube.com/" data-oembed-type="video" data-oembed-provider="youtube"><iframe width="480" height="270" src="http://www.youtube.com/embed/baGfM6dBzs8?feature=oembed" frameborder="0" allowfullscreen></iframe></div>'
-    end
-
-    it 'color' do
-      json = '{"id":"abcd","type":"article","href":"","slugs":[],"tags":[],"data":{"article":{"background":{"type":"Color","value":"#000000"}}}}'
-      document = Prismic::JsonParser.document_parser(JSON.load(json))
-      # startgist:2b41f3a75f129a0d6903:prismic-color.rb
-      bgcolor = document.get_color('article.background')
-      hex = '#' + (bgcolor ? bgcolor.value : 'FFFFFF')
-      # endgist
-      hex.should == '#000000'
-    end
-
-    it 'GeoPoint' do
-      json = '{"id":"abcd","type":"article","href":"","slugs":[],"tags":[],"data":{"article":{"location":{"type":"GeoPoint","value":{"latitude":48.877108,"longitude":2.333879}}}}}'
-      document = Prismic::JsonParser.document_parser(JSON.load(json))
-      # startgist:f221a2396c079a7d291f:prismic-geopoint.rb
-      # "near" predicate for GeoPoint fragments
-      near = Predicates::near('my.store.location', 48.8768767, 2.3338802, 10)
-
-      # Accessing GeoPoint fragments
-      place = document.get_geopoint('article.location')
-      coordinates = place ? (place.latitude.to_s + ',' + place.longitude.to_s) : ''
-      # endgist
-      coordinates.should == '48.877108,2.333879'
-    end
-
-    it 'asHtml' do
-      api = Prismic.api('https://lesbonneschoses.cdn.prismic.io/api')
-      response = api
-        .form('everything')
-        .query(Prismic::Predicates::at('document.id', 'UlfoxUnM0wkXYXbX'))
-        .submit(api.master_ref)
-      # startgist:7b93db67fa25ac386603:prismic-asHtml.rb
-      resolver = Prismic.link_resolver('master'){ |doc_link| "http:#localhost/#{doc_link.id}" }
-      doc = response.results[0]
-      html = doc['blog-post.body'].as_html(resolver)
-      # endgist
-      html.should_not be_nil
-    end
-
-    it 'HtmlSerializer' do
-      api = Prismic.api('https://lesbonneschoses.cdn.prismic.io/api')
-      response = api
-      .form('everything')
-      .query(Prismic::Predicates::at('document.id', 'UlfoxUnM0wkXYXbX'))
-      .submit(api.master_ref)
-      # startgist:e7944fe6ecdd8956b72:prismic-htmlSerializer.rb
-      resolver = Prismic.link_resolver('master'){ |doc_link| "http:#localhost/#{doc_link.id}" }
-      serializer = Prismic.html_serializer do |element, html|
-        if element.is_a?(Prismic::Fragments::StructuredText::Block::Image)
-          # Don't wrap images in a <p> tag
-          %(<img src="#{element.url}" alt="#{element.alt}" width="#{element.width}" height="#{element.height}" />)
-        else
-          nil
-        end
-      end
-      doc = response.results[0]
-      html = doc.get_structured_text('blog-post.body').as_html(resolver, serializer)
-      # endgist
-      html.should_not be_nil
-    end
-
-    it 'cache' do
-      # startgist:388900d4e9e7a444e0a2:prismic-cache.rb
-      # You can pass any object implementing the same methods as the BasicCache
-      # https://github.com/prismicio/ruby-kit/blob/master/lib/prismic/cache/basic.rb
-      cache = Prismic::LruCache.new
-      api = Prismic::api('https://lesbonneschoses.cdn.prismic.io/api', { :cache => cache })
-      # The Api will use the custom cache object
-      # endgist
-      api.should_not be_nil
-    end
-
-  end
-
-end

data/spec/lesbonneschoses_spec.rb

@@ -1,228 +0,0 @@
-# encoding: utf-8
-require 'spec_helper'
-
-describe 'LesBonnesChoses' do
-  before do
-    @api = Prismic.api('https://lesbonneschoses.cdn.prismic.io/api', nil)
-    @master_ref = @api.master_ref
-  end
-
-  describe '/api' do
-    it 'API works' do
-      @api.should_not be_nil
-    end
-  end
-
-  describe 'query' do
-    it 'queries everything and returns 20 documents' do
-      @api.form('everything').submit(@master_ref).size.should == 20
-      @api.form('everything').submit(@master_ref).results.size.should == 20
-    end
-
-    it 'queries macarons (using a predicate) and returns 7 documents' do
-      @api.query('[[:d = any(document.tags, ["Macaron"])]]')
-        .results.size.should == 7
-      @api.query('[[:d = any(document.tags, ["Macaron"])]]').size.should == 7
-    end
-
-    it 'queries macarons (using a form) and returns 7 documents' do
-      @api.form('macarons').submit(@master_ref).results.size.should == 7
-      @api.form('macarons').submit(@master_ref).size.should == 7
-    end
-
-    it 'queries macarons or cupcakes (using a form + a predicate) and returns 11 documents' do
-      @api.form('products')
-        .query('[[:d = any(document.tags, ["Cupcake", "Macaron"])]]')
-        .submit(@master_ref).results.size.should == 11
-      @api.form('products')
-        .query('[[:d = any(document.tags, ["Cupcake", "Macaron"])]]')
-        .submit(@master_ref).size.should == 11
-    end
-  end
-
-  describe 'pagination' do
-    it 'works in basic cases' do
-      documents = @api.form('everything').submit(@master_ref)
-      documents.page.should == 1
-      documents.results_per_page.should == 20
-      documents.results_size.should == 20
-      documents.total_results_size.should == 40
-      documents.total_pages.should == 2
-      documents.next_page.should == 'https://d2aw36oac6sa9o.cloudfront.net/api/documents/search?ref=UlfoxUnM08QWYXdl&page=2&pageSize=20'
-      documents.prev_page.should == nil
-    end
-    it 'works when passing nil' do
-      documents = @api.form('everything').page(nil).submit(@master_ref)
-      documents.page.should == 1
-      documents.results_per_page.should == 20
-      documents.results_size.should == 20
-      documents.total_results_size.should == 40
-      documents.total_pages.should == 2
-      documents.next_page.should == 'https://d2aw36oac6sa9o.cloudfront.net/api/documents/search?ref=UlfoxUnM08QWYXdl&page=2&pageSize=20'
-      documents.prev_page.should == nil
-    end
-    it 'works on page 2' do
-      documents = @api.form('everything').page("2").submit(@master_ref)
-      documents.page.should == 2
-      documents.results_per_page.should == 20
-      documents.results_size.should == 20
-      documents.total_results_size.should == 40
-      documents.total_pages.should == 2
-      documents.next_page.should == nil
-      documents.prev_page.should == 'https://d2aw36oac6sa9o.cloudfront.net/api/documents/search?ref=UlfoxUnM08QWYXdl&page=1&pageSize=20'
-    end
-    it 'works on page 2 with a pagination step of 10' do
-      documents = @api.form('everything').page('2').page_size('10').submit(@master_ref)
-      documents.page.should == 2
-      documents.results_per_page.should == 10
-      documents.results_size.should == 10
-      documents.total_results_size.should == 40
-      documents.total_pages.should == 4
-      documents.next_page.should == 'https://d2aw36oac6sa9o.cloudfront.net/api/documents/search?ref=UlfoxUnM08QWYXdl&page=3&pageSize=10'
-      documents.prev_page.should == 'https://d2aw36oac6sa9o.cloudfront.net/api/documents/search?ref=UlfoxUnM08QWYXdl&page=1&pageSize=10'
-    end
-    it 'works when passing nil' do
-      documents = @api.form('everything').page(nil).submit(@master_ref)
-      documents.page.should == 1
-      documents.results_per_page.should == 20
-      documents.results_size.should == 20
-      documents.total_results_size.should == 40
-      documents.total_pages.should == 2
-      documents.next_page.should == 'https://d2aw36oac6sa9o.cloudfront.net/api/documents/search?ref=UlfoxUnM08QWYXdl&page=2&pageSize=20'
-      documents.prev_page.should == nil
-    end
-  end
-
-  describe 'API::Document' do
-    before do
-      @document = @api.form('everything').query('[[:d = at(document.id, "UlfoxUnM0wkXYXbh")]]').submit(@master_ref)[0]
-    end
-
-    it 'Operator [] works on document' do
-      @document['job-offer.name'].as_html(nil).should == '<h1>Pastry Dresser</h1>'
-    end
-
-    it 'Operator [] returns nil if wrong type' do
-      @document['product.name'].should == nil
-    end
-
-    it 'Operator [] raises error if field is nonsense' do
-      expect {
-        @document['blablabla']
-      }.to raise_error(ArgumentError, 'Argument should contain one dot. Example: product.price')
-    end
-  end
-
-  describe 'API::Documents' do
-    before do
-      @documents = @api.form('everything').submit(@master_ref)
-    end
-
-    it 'has a working [] operator' do
-      @documents[0].slug.should == @documents.results[0].slug
-    end
-    it 'has a proper size' do
-      @documents.length.should == 20
-      @documents.size.should == 20
-    end
-    it 'has a proper each method' do
-      array = []
-      @documents.each {|document| array << document.slug }
-      array.join(' ').should == 'art-director store-intern content-director ganache-specialist community-manager oven-instrumentist paris-saint-lazare tokyo-roppongi-hills london-covent-garden paris-champ-elysees new-york-fifth-avenue pastry-dresser exotic-kiwi-pie apricot-pie sweet-strawberry-pie woodland-cherry-pie cool-coconut-macaron salted-caramel-macaron the-end-of-a-chapter-the-beginning-of-a-new-one get-the-right-approach-to-ganache'
-    end
-    it 'is a proper Enumerable' do
-      @documents.map {|document| document.slug }.join(' ').should == 'art-director store-intern content-director ganache-specialist community-manager oven-instrumentist paris-saint-lazare tokyo-roppongi-hills london-covent-garden paris-champ-elysees new-york-fifth-avenue pastry-dresser exotic-kiwi-pie apricot-pie sweet-strawberry-pie woodland-cherry-pie cool-coconut-macaron salted-caramel-macaron the-end-of-a-chapter-the-beginning-of-a-new-one get-the-right-approach-to-ganache'
-    end
-  end
-
-  describe 'FetchLinks' do
-    it 'Fetches additional data with DocumentLink' do
-      documents = @api.form('everything')
-        .query(Prismic::Predicates::at('document.id', 'UlfoxUnM0wkXYXbt'))
-        .fetch_links('blog-post.author')
-        .submit(@master_ref).results
-      link = documents[0].get('blog-post.relatedpost')[0]
-      link.get_text('blog-post.author').value.should == 'John M. Martelle, Fine Pastry Magazine'
-    end
-  end
-
-  describe 'Fragments' do
-    before do
-      @link_resolver = Prismic.link_resolver("master"){|doc_link| "http://localhost/#{doc_link.id}" }
-      @html_serializer = Prismic.html_serializer do |element, html|
-        if element.is_a?(Prismic::Fragments::StructuredText::Block::Image)
-          %(<img src="#{element.url}" alt="#{element.alt}" width="#{element.width}" height="#{element.height}" />)
-        else
-          nil
-        end
-      end
-    end
-    describe 'API::Fragments::StructuredText' 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, "UlfoxUnM0wkXYXbX")]]))
-          .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"\
-            "<p class=\"block-img\"><img src=\"https://d2aw36oac6sa9o.cloudfront.net/lesbonneschoses/ee7b984b98db4516aba2eabd54ab498293913c6c.jpg\" alt=\"\" width=\"640\" height=\"425\" /></p>\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: &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/\" data-oembed-type=\"video\" data-oembed-provider=\"youtube\"><iframe width=\"459\" height=\"344\" src=\"http://www.youtube.com/embed/Ye78F3-CuXY?feature=oembed\" frameborder=\"0\" allowfullscreen></iframe></div>"
-      end
-      it "returns a correct as_html on a StructuredText with custom HTML serializer" do
-        @api.form("everything")
-          .query(%([[:d = at(document.id, "#{@api.bookmark('about')}")]]))
-          .submit(@master_ref)[0]['article.content'].as_html(@link_resolver, @html_serializer).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/UlfoxUnM0wkXYXbb\">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/UlfoxUnM0wkXYXbP\">a second shop on Paris's Champs-Élysées</a>, and <a href=\"http://localhost/UlfoxUnM0wkXYXbr\">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/UlfoxUnM0wkXYXbc\">New York</a> (2000) and <a href=\"http://localhost/UlfoxUnM0wkXYXbU\">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://d2aw36oac6sa9o.cloudfront.net/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/UlfoxUnM0wkXYXba\">ganache specialists</a>&quot;, &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbQ\">fruit experts</a>&quot;, or &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbn\">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/UlfoxUnM0wkXYXbl\">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_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/UlfoxUnM0wkXYXbb\">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/UlfoxUnM0wkXYXbP\">a second shop on Paris's Champs-Élysées</a>, and <a href=\"http://localhost/UlfoxUnM0wkXYXbr\">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/UlfoxUnM0wkXYXbc\">New York</a> (2000) and <a href=\"http://localhost/UlfoxUnM0wkXYXbU\">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<p class=\"block-img\"><img src=\"https://d2aw36oac6sa9o.cloudfront.net/lesbonneschoses/df6c1d87258a5bfadf3479b163fd85c829a5c0b8.jpg\" alt=\"\" width=\"800\" height=\"533\" /></p>\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/UlfoxUnM0wkXYXba\">ganache specialists</a>&quot;, &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbQ\">fruit experts</a>&quot;, or &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbn\">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/UlfoxUnM0wkXYXbl\">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")
-          .query(%([[:d = at(document.id, "UlfoxUnM0wkXYXbt")]]))
-          .submit(@master_ref)[0]['blog-post.body'].as_text.should == "The end of a chapter the beginning of a new one Jean-Michel Pastranova, the founder of Les Bonnes Choses, and creator of the whole concept of modern fine pastry, has decided to step down as the CEO and the Director of Workshops of Les Bonnes Choses, to focus on other projects, among which his now best-selling pastry cook books, but also to take on a primary role in a culinary television show to be announced later this year. \"I believe I've taken the Les Bonnes Choses concept as far as it can go. Les Bonnes Choses is already an entity that is driven by its people, thanks to a strong internal culture, so I don't feel like they need me as much as they used to. I'm sure they are greater ways to come, to innovate in pastry, and I'm sure Les Bonnes Choses's coming innovation will be even more mind-blowing than if I had stayed longer.\" He will remain as a senior advisor to the board, and to the workshop artists, as his daughter Selena, who has been working with him for several years, will fulfill the CEO role from now on. \"My father was able not only to create a revolutionary concept, but also a company culture that puts everyone in charge of driving the company's innovation and quality. That gives us years, maybe decades of revolutionary ideas to come, and there's still a long, wonderful path to walk in the fine pastry world.\""
-      end
-
-      it "returns a correct as_text on a StructuredText with a separator" do
-        @api.form("everything")
-          .query(%([[:d = at(document.id, "UlfoxUnM0wkXYXbt")]]))
-          .submit(@master_ref)[0]['blog-post.body'].as_text(' #### ').should == "The end of a chapter the beginning of a new one #### Jean-Michel Pastranova, the founder of Les Bonnes Choses, and creator of the whole concept of modern fine pastry, has decided to step down as the CEO and the Director of Workshops of Les Bonnes Choses, to focus on other projects, among which his now best-selling pastry cook books, but also to take on a primary role in a culinary television show to be announced later this year. #### \"I believe I've taken the Les Bonnes Choses concept as far as it can go. Les Bonnes Choses is already an entity that is driven by its people, thanks to a strong internal culture, so I don't feel like they need me as much as they used to. I'm sure they are greater ways to come, to innovate in pastry, and I'm sure Les Bonnes Choses's coming innovation will be even more mind-blowing than if I had stayed longer.\" #### He will remain as a senior advisor to the board, and to the workshop artists, as his daughter Selena, who has been working with him for several years, will fulfill the CEO role from now on. #### \"My father was able not only to create a revolutionary concept, but also a company culture that puts everyone in charge of driving the company's innovation and quality. That gives us years, maybe decades of revolutionary ideas to come, and there's still a long, wonderful path to walk in the fine pastry world.\""
-      end
-    end
-  end
-end