ruhoh 2.1 → 2.2

data/features/step_defs.rb

@@ -0,0 +1,70 @@
+Transform(/^(should|should NOT)$/) do |matcher|
+  matcher.downcase.gsub(' ', '_')
+end
+
+Given(/^a config file with values:$/) do |table|
+  data = table.rows_hash
+  data.each{ |key, value| data[key] = JSON.parse(value) }
+  make_config(data)
+end
+
+Given(/^the file "(.*)" with body:$/) do |file, body|
+  make_file(path: file, body: body)
+end
+
+Given(/^some files with values:$/) do |table|
+  table.hashes.each do |row|
+    file = row['file'] ; row.delete('file')
+    body = row['body'] ; row.delete('body')
+
+    make_file(path: file, data: row, body: body)
+  end
+end
+
+When(/^I compile my site$/) do
+  compile
+end
+
+Then(/^my compiled site (should|should NOT) have the file "(.*?)"$/) do |matcher, path|
+  @filepath = path
+  FileUtils.cd(@ruhoh.paths.compiled) {
+    # Done this way so the error output is more informative.
+    files = Dir.glob("**/*").delete_if{ |a| File.directory?(a) }
+    files.__send__(matcher, include(path)) 
+  }
+end
+
+Then(/^this file (should|should NOT) (?:have|contain) the content "(.*?)"$/) do |matcher, content|
+  this_compiled_file.__send__(matcher, have_content(content))
+end
+
+Then(/^this file (should|should NOT) (?:have|contain) the content node "(.*?)\|(.*?)"$/) do |matcher, node, content|
+  if matcher == "should"
+    this_compiled_file.__send__(matcher, have_selector(node, visible: false))
+  end
+  Nokogiri::HTML(this_compiled_file).css(node).text.__send__(matcher, have_content(content))
+end
+
+Then(/^this file (should|should NOT) have the links "(.*)"$/) do |matcher, links|
+  links = links.split(/[\s,]+/).map(&:strip)
+  links.each do |link|
+    this_compiled_file.__send__(matcher, have_css("a[href='#{ link }']"))
+  end
+end
+
+# This is a bit hacky and doesn't verify the fingerprint is valid/accurate.
+Then(/^this file (should|should NOT) have the fingerprinted (stylesheets|javascripts) "(.*)"$/) do |matcher, filetype, names|
+  names = names.split(/[\s,]+/).map(&:strip)
+  files = nil
+  FileUtils.cd(File.join(@ruhoh.paths.compiled, 'assets', filetype)){
+    files = Dir['*']
+  }
+
+  names.each do |name|
+    file = files.find{ |a| a.start_with?(name) }
+    file.should_not be_nil
+    link = "/assets/#{ filetype }/#{ file }"
+    selector = (filetype == "stylesheets") ? "link[href='#{ link }']" : "script[src='#{ link }']"
+    this_compiled_file.__send__(matcher, have_css(selector, visible: false))
+  end
+end

data/features/stylesheets.feature

@@ -0,0 +1,42 @@
+Feature: Stylesheets
+  As a content publisher
+  I want to load stylesheets
+  so I can make my content presentation pleasing to the eye and intuitive for my readers
+
+  Scenario: Defining stylesheets
+    Given some files with values:
+      | file | body |
+      | stylesheets/base.css | body { color: black } |
+      | stylesheets/app.css | div { color: black } |
+      | stylesheets/custom.css | div { color: black } |
+      And the file "_root/index.html" with body:
+        """
+        {{# stylesheets.load }}
+          base.css
+          app.css
+          custom.css
+        {{/ stylesheets.load }}",
+        """
+    When I compile my site
+    Then my compiled site should have the file "index.html"
+      And this file should have the fingerprinted stylesheets "base, app, custom"
+
+  Scenario: Defining stylesheets in a theme
+    Given a config file with values:
+      | sample_theme | { "use" : "theme" } |
+      And some files with values:
+        | file | body |
+        | stylesheets/base.css | blah {} |
+        | sample_theme/stylesheets/app.css | blah {} |
+        | sample_theme/stylesheets/custom.css | blah {} |
+      And the file "_root/index.html" with body:
+        """
+        {{# stylesheets.load }}
+          base.css
+          app.css
+          custom.css
+        {{/ stylesheets.load }}",
+        """
+    When I compile my site
+    Then my compiled site should have the file "index.html"
+      And this file should have the fingerprinted stylesheets "base, app, custom"

data/features/summary.feature

@@ -0,0 +1,119 @@
+# The following text samples are taken from "How the leopard got his spots" by Rudyard Kipling
+# which, to my knowledge, is in the public domain. source: http://www.world-english.org/stories.htm
+Feature: Summary
+  As a content publisher
+  I want to provide page summaries
+  so I can promote more articles throughout the site using summarized teasers.
+
+  Scenario: Summary with configured summary_lines
+    Given a config file with values:
+      | essays | { "summary_lines" : 2 } |
+      And some files with values:
+        | file                | body |
+        | layouts/essays.md   | {{{ page.summary }}} |
+      And the file "essays/hello.md" with body:
+      """
+      In the days when everybody started fair, Best Beloved, the Leopard lived in a place called the High Veldt. 'Member it wasn't the Low Veldt, or the Bush Veldt, or the Sour Veldt, but the 'sclusively bare, hot shiny High Veldt, where there was sand and sandy-coloured rock and 'sclusively tufts of sandy-yellowish grass.
+
+      The Giraffe and the Zebra and the Eland and the Koodoo and the Hartebeest lived there: and they were 'sclusively sandy-yellow-brownish all over; but the Leopard, he was the 'sclusivest sandiest-yellowest-brownest of them all -- a greyish-yellowish catty-shaped kind of beast, and he matched the 'sclusively yellowish-greyish-brownish colour of the High Veldt to one hair.
+
+      This was very bad for the Giraffe and the Zebra and the rest of them: for he would lie down by a 'sclusively yellowish-greyish-brownish stone or clump of grass, and when the Giraffe or the Zebra or the Eland or the Koodoo or the Bush-Buck or the Bonte-Buck came by he would surprise them out of their jumpsome lives.
+
+      He would indeed! And, also, there was an Ethiopian with bows and arrows (a 'sclusively greyish-brownish-yellowish man he was then), who lived on the High Veldt with the Leopard: and the two used to hunt together -- the Ethiopian with his bows and arrows, and the Leopard 'sclusively with his teeth and claws -- till the Giraffe and the Eland and the Koodoo and the Quagga and all the rest of them didn't know which way to jump, Best Beloved.
+      They didn't indeed!
+      """
+    When I compile my site
+    Then my compiled site should have the file "essays/hello/index.html"
+      And this file should contain the content node "div.summary|In the days when everybody started fair, Best Beloved, the Leopard lived in a place called the High Veldt. 'Member it wasn't the Low Veldt, or the Bush Veldt, or the Sour Veldt, but the 'sclusively bare, hot shiny High Veldt, where there was sand and sandy-coloured rock and 'sclusively tufts of sandy-yellowish grass."
+      And this file should contain the content node "div.summary|The Giraffe and the Zebra and the Eland and the Koodoo and the Hartebeest lived there: and they were 'sclusively sandy-yellow-brownish all over; but the Leopard, he was the 'sclusivest sandiest-yellowest-brownest of them all -- a greyish-yellowish catty-shaped kind of beast, and he matched the 'sclusively yellowish-greyish-brownish colour of the High Veldt to one hair."
+      And this file should NOT contain the content "This was very bad for the Giraffe and the Zebra and the rest of them: for he would lie down by a 'sclusively yellowish-greyish-brownish stone or clump of grass, and when the Giraffe or the Zebra or the Eland or the Koodoo or the Bush-Buck or the Bonte-Buck came by he would surprise them out of their jumpsome lives."
+
+  Scenario: Specifying an explicit summary DOM node
+    Given some files with values:
+      | file                | body |
+      | layouts/essays.md   | {{{ page.summary }}} |
+      And the file "essays/hello.md" with body:
+      """
+      In the days when everybody started fair, Best Beloved, the Leopard lived in a place called the High Veldt. 'Member it wasn't the Low Veldt, or the Bush Veldt, or the Sour Veldt, but the 'sclusively bare, hot shiny High Veldt, where there was sand and sandy-coloured rock and 'sclusively tufts of sandy-yellowish grass. 
+      The Giraffe and the Zebra and the Eland and the Koodoo and the Hartebeest lived there: and they were 'sclusively sandy-yellow-brownish all over; but the Leopard, he was the 'sclusivest sandiest-yellowest-brownest of them all -- a greyish-yellowish catty-shaped kind of beast, and he matched the 'sclusively yellowish-greyish-brownish colour of the High Veldt to one hair. 
+      This was very bad for the Giraffe and the Zebra and the rest of them: for he would lie down by a 'sclusively yellowish-greyish-brownish stone or clump of grass, and when the Giraffe or the Zebra or the Eland or the Koodoo or the Bush-Buck or the Bonte-Buck came by he would surprise them out of their jumpsome lives. 
+      <div class="summary">
+        He would indeed! And, also, there was an Ethiopian with bows and arrows (a 'sclusively greyish-brownish-yellowish man he was then), who lived on the High Veldt with the Leopard: and the two used to hunt together -- the Ethiopian with his bows and arrows, and the Leopard 'sclusively with his teeth and claws -- till the Giraffe and the Eland and the Koodoo and the Quagga and all the rest of them didn't know which way to jump, Best Beloved.
+      </div>
+      They didn't indeed!
+      """
+    When I compile my site
+    Then my compiled site should have the file "essays/hello/index.html"
+      And this file should contain the content node "div.summary|He would indeed! And, also, there was an Ethiopian with bows and arrows (a 'sclusively greyish-brownish-yellowish man he was then), who lived on the High Veldt with the Leopard: and the two used to hunt together -- the Ethiopian with his bows and arrows, and the Leopard 'sclusively with his teeth and claws -- till the Giraffe and the Eland and the Koodoo and the Quagga and all the rest of them didn't know which way to jump, Best Beloved."
+      And this file should NOT contain the content "In the days when everybody started fair"
+
+  Scenario: Specifying summary_stop_at_header: true
+    Given a config file with values:
+      | essays | { "summary_stop_at_header" : true } |
+      And some files with values:
+        | file                | body |
+        | layouts/essays.md   | {{{ page.summary }}} |
+      And the file "essays/hello.md" with body:
+      """
+      In the days when everybody started fair, Best Beloved, the Leopard lived in a place called the High Veldt. 'Member it wasn't the Low Veldt, or the Bush Veldt, or the Sour Veldt, but the 'sclusively bare, hot shiny High Veldt, where there was sand and sandy-coloured rock and 'sclusively tufts of sandy-yellowish grass. 
+
+      # Peach Ice Cream
+
+      The Giraffe and the Zebra and the Eland and the Koodoo and the Hartebeest lived there: and they were 'sclusively sandy-yellow-brownish all over; but the Leopard, he was the 'sclusivest sandiest-yellowest-brownest of them all -- a greyish-yellowish catty-shaped kind of beast, and he matched the 'sclusively yellowish-greyish-brownish colour of the High Veldt to one hair. 
+      This was very bad for the Giraffe and the Zebra and the rest of them: for he would lie down by a 'sclusively yellowish-greyish-brownish stone or clump of grass, and when the Giraffe or the Zebra or the Eland or the Koodoo or the Bush-Buck or the Bonte-Buck came by he would surprise them out of their jumpsome lives. 
+      He would indeed! And, also, there was an Ethiopian with bows and arrows (a 'sclusively greyish-brownish-yellowish man he was then), who lived on the High Veldt with the Leopard: and the two used to hunt together -- the Ethiopian with his bows and arrows, and the Leopard 'sclusively with his teeth and claws -- till the Giraffe and the Eland and the Koodoo and the Quagga and all the rest of them didn't know which way to jump, Best Beloved.
+      They didn't indeed!
+      """
+    When I compile my site
+    Then my compiled site should have the file "essays/hello/index.html"
+      And this file should contain the content node "div.summary|In the days when everybody started fair, Best Beloved, the Leopard lived in a place called the High Veldt. 'Member it wasn't the Low Veldt, or the Bush Veldt, or the Sour Veldt, but the 'sclusively bare, hot shiny High Veldt, where there was sand and sandy-coloured rock and 'sclusively tufts of sandy-yellowish grass. "
+      And this file should NOT contain the content "The Giraffe and the Zebra and the Eland and the Koodoo and the Hartebeest lived there: and they were 'sclusively sandy-yellow-brownish all over; but the Leopard, he was the 'sclusivest sandiest-yellowest-brownest of them all -- a greyish-yellowish catty-shaped kind of beast, and he matched the 'sclusively yellowish-greyish-brownish colour of the High Veldt to one hair. "
+
+  Scenario: Specifying summary_stop_at_header: true with header as starting content
+    Given a config file with values:
+      | essays | { "summary_stop_at_header" : true } |
+      And some files with values:
+        | file                | body |
+        | layouts/essays.md   | {{{ page.summary }}} |
+      And the file "essays/hello.md" with body:
+      """
+      # Peach Ice Cream
+      In the days when everybody started fair, Best Beloved, the Leopard lived in a place called the High Veldt. 'Member it wasn't the Low Veldt, or the Bush Veldt, or the Sour Veldt, but the 'sclusively bare, hot shiny High Veldt, where there was sand and sandy-coloured rock and 'sclusively tufts of sandy-yellowish grass. 
+
+      # Coconut
+      The Giraffe and the Zebra and the Eland and the Koodoo and the Hartebeest lived there: and they were 'sclusively sandy-yellow-brownish all over; but the Leopard, he was the 'sclusivest sandiest-yellowest-brownest of them all -- a greyish-yellowish catty-shaped kind of beast, and he matched the 'sclusively yellowish-greyish-brownish colour of the High Veldt to one hair. 
+      This was very bad for the Giraffe and the Zebra and the rest of them: for he would lie down by a 'sclusively yellowish-greyish-brownish stone or clump of grass, and when the Giraffe or the Zebra or the Eland or the Koodoo or the Bush-Buck or the Bonte-Buck came by he would surprise them out of their jumpsome lives. 
+      He would indeed! And, also, there was an Ethiopian with bows and arrows (a 'sclusively greyish-brownish-yellowish man he was then), who lived on the High Veldt with the Leopard: and the two used to hunt together -- the Ethiopian with his bows and arrows, and the Leopard 'sclusively with his teeth and claws -- till the Giraffe and the Eland and the Koodoo and the Quagga and all the rest of them didn't know which way to jump, Best Beloved.
+      They didn't indeed!
+      """
+    When I compile my site
+    Then my compiled site should have the file "essays/hello/index.html"
+      And this file should contain the content node "div.summary|In the days when everybody started fair, Best Beloved, the Leopard lived in a place called the High Veldt. 'Member it wasn't the Low Veldt, or the Bush Veldt, or the Sour Veldt, but the 'sclusively bare, hot shiny High Veldt, where there was sand and sandy-coloured rock and 'sclusively tufts of sandy-yellowish grass. "
+      And this file should NOT contain the content "The Giraffe and the Zebra and the Eland and the Koodoo and the Hartebeest lived there: and they were 'sclusively sandy-yellow-brownish all over; but the Leopard, he was the 'sclusivest sandiest-yellowest-brownest of them all -- a greyish-yellowish catty-shaped kind of beast, and he matched the 'sclusively yellowish-greyish-brownish colour of the High Veldt to one hair. "
+
+  Scenario: Specifying summary_stop_at_header with number
+    Given a config file with values:
+      | essays | { "summary_stop_at_header" : 3 } |
+      And some files with values:
+        | file                | body |
+        | layouts/essays.md   | {{{ page.summary }}} |
+      And the file "essays/hello.md" with body:
+      """
+      # One
+      In the days when everybody started fair, Best Beloved, the Leopard lived in a place called the High Veldt. 'Member it wasn't the Low Veldt, or the Bush Veldt, or the Sour Veldt, but the 'sclusively bare, hot shiny High Veldt, where there was sand and sandy-coloured rock and 'sclusively tufts of sandy-yellowish grass. 
+
+      ## Two
+      The Giraffe and the Zebra and the Eland and the Koodoo and the Hartebeest lived there: and they were 'sclusively sandy-yellow-brownish all over; but the Leopard, he was the 'sclusivest sandiest-yellowest-brownest of them all -- a greyish-yellowish catty-shaped kind of beast, and he matched the 'sclusively yellowish-greyish-brownish colour of the High Veldt to one hair. 
+
+      ### Three
+      This was very bad for the Giraffe and the Zebra and the rest of them: for he would lie down by a 'sclusively yellowish-greyish-brownish stone or clump of grass, and when the Giraffe or the Zebra or the Eland or the Koodoo or the Bush-Buck or the Bonte-Buck came by he would surprise them out of their jumpsome lives. 
+      He would indeed! And, also, there was an Ethiopian with bows and arrows (a 'sclusively greyish-brownish-yellowish man he was then), who lived on the High Veldt with the Leopard: and the two used to hunt together -- the Ethiopian with his bows and arrows, and the Leopard 'sclusively with his teeth and claws -- till the Giraffe and the Eland and the Koodoo and the Quagga and all the rest of them didn't know which way to jump, Best Beloved.
+      They didn't indeed!
+      """
+    When I compile my site
+    Then my compiled site should have the file "essays/hello/index.html"
+      And this file should contain the content node "div.summary|In the days when everybody started fair, Best Beloved, the Leopard lived in a place called the High Veldt. 'Member it wasn't the Low Veldt, or the Bush Veldt, or the Sour Veldt, but the 'sclusively bare, hot shiny High Veldt, where there was sand and sandy-coloured rock and 'sclusively tufts of sandy-yellowish grass. "
+      And this file should contain the content node "div.summary|The Giraffe and the Zebra and the Eland and the Koodoo and the Hartebeest lived there: and they were 'sclusively sandy-yellow-brownish all over; but the Leopard, he was the 'sclusivest sandiest-yellowest-brownest of them all -- a greyish-yellowish catty-shaped kind of beast, and he matched the 'sclusively yellowish-greyish-brownish colour of the High Veldt to one hair. "
+      And this file should contain the content node "h1|One"
+      And this file should contain the content node "h2|Two"
+      And this file should NOT contain the content "This was very bad for the Giraffe and the Zebra and the rest of them: for he would lie down by a 'sclusively yellowish-greyish-brownish stone or clump of grass, and when the Giraffe or the Zebra or the Eland or the Koodoo or the Bush-Buck or the Bonte-Buck came by he would surprise them out of their jumpsome lives. "

data/features/support/env.rb

@@ -0,0 +1,8 @@
+require 'fileutils'
+require 'rspec/expectations'
+require 'capybara/cucumber'
+World(RSpec::Matchers)
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'ruhoh'

data/features/support/helpers.rb

@@ -0,0 +1,74 @@
+# Full path to mock blog directory
+SampleSitePath = File.expand_path(File.join(File.dirname(__FILE__), '..', '..', '__tmp'))
+
+def start
+  @ruhoh = Ruhoh.new
+  @ruhoh.setup(:source => SampleSitePath)
+  @ruhoh.env = :test
+  @ruhoh.setup_paths
+  @ruhoh.setup_plugins
+end
+
+def compile
+  start
+  @ruhoh.env = 'production'
+  @ruhoh.paths.compiled = File.join(SampleSitePath, 'compiled')
+  @ruhoh.compile
+end
+
+def make_config(data)
+  path = File.join(SampleSitePath, "config.yml")
+  File.open(path, "w+") { |file|
+    file.puts data.to_yaml
+  }
+end
+
+def make_file(opts)
+  path = File.join(SampleSitePath, opts[:path])
+  FileUtils.mkdir_p(File.dirname(path))
+
+  data = opts[:data] || {}
+  if data['categories']
+    data['categories'] = data['categories'].to_s.split(',').map(&:strip)
+  end
+  if data['tags']
+    data['tags'] = data['tags'].to_s.split(',').map(&:strip)
+    puts "tags #{data['tags']}"
+  end
+  data.delete('layout') if data['layout'].to_s.strip.empty?
+
+  metadata = data.empty? ? '' : data.to_yaml.to_s + "\n---\n"
+
+  File.open(path, "w+") { |file|
+    file.puts <<-TEXT
+#{ metadata }
+
+#{ opts[:body] }
+TEXT
+  }
+end
+
+def get_compiled_file(path)
+  FileUtils.cd(@ruhoh.paths.compiled) {
+    File.open(path, 'r:UTF-8') { |f| 
+      return f.read }
+  }
+end
+
+def this_compiled_file
+  unless @filepath
+    raise "Your step definition is trying to reference 'this' compiled file" +
+          " but you haven't provided a file reference." +
+          " This probably just means using 'my compiled site should have the file \"sample.md\"' first."
+  end
+  get_compiled_file(@filepath)
+end
+
+Before do
+  FileUtils.remove_dir(SampleSitePath,1) if Dir.exists? SampleSitePath
+  Dir.mkdir SampleSitePath
+end
+
+After do
+  FileUtils.remove_dir(SampleSitePath,1) if Dir.exists? SampleSitePath
+end

data/features/tags.feature

@@ -0,0 +1,39 @@
+Feature: Tags
+  As a content publisher
+  I want to add tags to pages
+  so that I can better organize and provide better access to my content for my readers
+
+  Scenario: Displaying a page's tags
+    Given some files with values:
+      | file | tags | body |
+      | essays/hello.md | apple, banana, pear | {{# page.tags }} <span>{{ name }}</span> {{/ page.tags }} |
+    When I compile my site
+    Then my compiled site should have the file "essays/hello/index.html"
+      And this file should contain the content node "span|apple"
+      And this file should contain the content node "span|banana"
+      And this file should contain the content node "span|pear"
+
+  Scenario: Displaying a collection's tags with counts
+    Given some files with values:
+      | file | tags | body |
+      | _root/index.md | | {{# essays.tags.all }} <span>{{ name }}-{{ count }}</span> {{/ essays.tags.all }} |
+      | essays/hello.md | apple, banana, pear | |
+      | essays/goodbye.md | apple, banana, pear, watermelon | |
+    When I compile my site
+    Then my compiled site should have the file "index.html"
+      And this file should contain the content node "span|apple-2"
+      And this file should contain the content node "span|banana-2"
+      And this file should contain the content node "span|pear-2"
+      And this file should contain the content node "span|watermelon-1"
+
+  Scenario: Displaying a specific tag from a collection
+    Given some files with values:
+      | file | tags | body |
+      | _root/index.md | | {{# essays.tags.banana }} <span>{{ name }}-{{ count }}</span> {{/ essays.tags.banana }} |
+      | essays/hello.md | apple, banana, pear | |
+      | essays/goodbye.md | apple, banana, pear, watermelon | |
+    When I compile my site
+    Then my compiled site should have the file "index.html"
+      And this file should NOT contain the content node "span|apple-2"
+      And this file should contain the content node "span|banana-2"
+  

data/features/widgets/google_prettify.feature

@@ -0,0 +1,12 @@
+Feature: Google Prettify Widget
+  As a content publisher
+  I want to include widgets on my site
+  so I can easily add customized functionality without polluting my content files
+
+  Scenario: Rendering a custom defined widget
+    Given some files with values:
+      | file                       | body |
+      | _root/index.md            | {{{ widgets.google_prettify }}} |
+    When I compile my site
+    Then my compiled site should have the file "index.html"
+      And this file should have the content node "script[src='http://cdnjs.cloudflare.com/ajax/libs/prettify/188.0.0/prettify.js']|"

data/features/widgets/syntax.feature

@@ -0,0 +1,35 @@
+Feature: Syntax widget
+  As a content publisher
+  I want to provide syntax highlighting
+  so users can more easily understand code examples I publish
+
+  Scenario: Using prettify syntax highlighter
+    Given the file "config.yml" with body:
+      """
+      widgets:
+        syntax:
+          use: "prettify"
+      """
+    Given some files with values:
+      | file                       | body |
+      | _root/index.md            | {{{ widgets.syntax }}} |
+    When I compile my site
+    Then my compiled site should have the file "index.html"
+      And this file should have the content node "script[src='/assets/widgets/syntax/javascripts/prettify.js']|"
+      And my compiled site should have the file "assets/widgets/syntax/javascripts/prettify.js"
+
+  Scenario: Using prettify syntax highlighter with cdn enabled
+    Given the file "config.yml" with body:
+      """
+      widgets:
+        syntax:
+          use: "prettify"
+          cdn:
+            enable: true
+      """
+    Given some files with values:
+      | file                       | body |
+      | _root/index.md            | {{{ widgets.syntax }}} |
+    When I compile my site
+    Then my compiled site should have the file "index.html"
+      And this file should have the content node "script[src='http://cdnjs.cloudflare.com/ajax/libs/prettify/188.0.0/prettify.js']|"

data/features/widgets/widgets.feature

@@ -0,0 +1,83 @@
+Feature: Widgets
+  As a content publisher
+  I want to include widgets on my site
+  so I can easily add customized functionality without polluting my content files
+
+  Scenario: Rendering a custom defined widget
+    Given some files with values:
+      | file                       | body |
+      | widgets/foo/default.html   | I am a custom widget |
+      | essays/hello.md            | {{{ widgets.foo }}} |
+    When I compile my site
+    Then my compiled site should have the file "essays/hello/index.html"
+      And this file should have the content "I am a custom widget"
+
+  Scenario: Rendering a custom defined widget with configuration
+    Given the file "widgets/foo/default.html" with body:
+      """
+      ---
+      tracking_id: 123
+      address:
+        city: seattle
+      ---
+      <tracking>{{ this_config.tracking_id }}</tracking>
+      <address>{{ this_config.address.city }}</address>
+
+      Cool lesson
+      """
+      And some files with values:
+        | file                       | body |
+        | essays/hello.md            | {{{ widgets.foo }}} |
+    When I compile my site
+    Then my compiled site should have the file "essays/hello/index.html"
+      And this file should have the content "Cool lesson"
+      And this file should have the content node "tracking|123"
+      And this file should have the content node "address|seattle"
+
+  Scenario: Rendering a custom defined widget with configuration overrides
+    Given the file "config.yml" with body:
+      """
+      widgets:
+        foo:
+          tracking_id: 987
+          address:
+            city: Berkeley
+      """
+      And the file "widgets/foo/default.html" with body:
+        """
+        ---
+        tracking_id: 123
+        address:
+          city: seattle
+        ---
+        <tracking>{{ this_config.tracking_id }}</tracking>
+        <address>{{ this_config.address.city }}</address>
+
+        Cool lesson
+        """
+      And some files with values:
+        | file                       | body |
+        | essays/hello.md            | {{{ widgets.foo }}} |
+    When I compile my site
+    Then my compiled site should have the file "essays/hello/index.html"
+      And this file should have the content "Cool lesson"
+      And this file should have the content node "tracking|987"
+      And this file should have the content node "address|Berkeley"
+      And this file should NOT have the content node "tracking|123"
+      And this file should NOT have the content node "address|seattle"
+
+  Scenario: Rendering a custom defined widget with assets
+    Given the file "widgets/foo/default.html" with body:
+      """
+      <path>{{ this_path }}/style.css</path>
+      Cool lesson
+      """
+      And some files with values:
+        | file                       | body |
+        | widgets/foo/style.css     | div {} |
+        | essays/hello.md            | {{{ widgets.foo }}} |
+    When I compile my site
+    Then my compiled site should have the file "essays/hello/index.html"
+      And this file should have the content "Cool lesson"
+      And this file should have the content node "path|/assets/widgets/foo/style.css"
+      And my compiled site should have the file "assets/widgets/foo/style.css"