pulsar-jekyll-code-example 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 14b5ec05fca3bbd9b529a075723f373eaacdb8f2
+  data.tar.gz: 2db41a424d7eb98c30fb8bb0423892f1bc0e762b
+SHA512:
+  metadata.gz: a4ddb25b35614c2454dc8a6609734ab5d0c8b17407ae6d2b741e6600c01548b3b455a51781ed42860a0c27cc4d4231b711f75282f57666c044d041dcf4b6f9c2
+  data.tar.gz: 24d35d1df76b090219340df5758ee96a8118fcfe1e4bc18517d8bbb076f7f1b964e7eec9a077e83a0ccc51d4b772644e991308ee19726e5db826281e37823201

data/CHANGELOG.md

@@ -0,0 +1,32 @@
+CHANGELOG
+==========
+
+This project adheres to [Semantic Versioning](http://semver.org/).
+
+[How to use a CHANGELOG](http://keepachangelog.com/)
+
+## 1.0.0 - 2017-01-30
+
+### Changed
+
+- Started versioning based on semantic versioning.
+
+### Added
+
+- CSS class applied to <li> and <ul> tags in language menus can be set via the
+	`code_example_list_class` in _config.yml.
+
+## 0.0.7 - 2015-03-18
+
+### Fixed
+
+- HTML escaping code examples, so the brower renders HTML/XMl as HTML/XML
+	characters
+
+## 0.0.6 - 2015-03-16
+
+### Added
+
+- CSS classes applied to buttons and button container elements can now be
+	configured via _config.yml. Supporting JavaScript also uses classes set in
+	_config.yml. 

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in jekyll-swfobject.gemspec
+gemspec
+
+group :test do
+  gem "fakefs", require: "fakefs/safe"
+  gem 'nokogiri'
+  gem 'pry'
+  gem 'rspec'
+end

data/Gemfile.lock

@@ -0,0 +1,84 @@
+PATH
+  remote: .
+  specs:
+    pulsar-jekyll-code-example (1.0.0)
+      htmlentities
+      jekyll
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.5.0)
+      public_suffix (~> 2.0, >= 2.0.2)
+    coderay (1.1.1)
+    colorator (1.1.0)
+    diff-lcs (1.3)
+    fakefs (0.10.2)
+    ffi (1.9.17)
+    forwardable-extended (2.6.0)
+    htmlentities (4.3.4)
+    jekyll (3.4.0)
+      addressable (~> 2.4)
+      colorator (~> 1.0)
+      jekyll-sass-converter (~> 1.0)
+      jekyll-watch (~> 1.1)
+      kramdown (~> 1.3)
+      liquid (~> 3.0)
+      mercenary (~> 0.3.3)
+      pathutil (~> 0.9)
+      rouge (~> 1.7)
+      safe_yaml (~> 1.0)
+    jekyll-sass-converter (1.5.0)
+      sass (~> 3.4)
+    jekyll-watch (1.5.0)
+      listen (~> 3.0, < 3.1)
+    kramdown (1.13.2)
+    liquid (3.0.6)
+    listen (3.0.8)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+    mercenary (0.3.6)
+    method_source (0.8.2)
+    mini_portile2 (2.1.0)
+    nokogiri (1.7.0.1)
+      mini_portile2 (~> 2.1.0)
+    pathutil (0.14.0)
+      forwardable-extended (~> 2.6)
+    pry (0.10.4)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    public_suffix (2.0.5)
+    rb-fsevent (0.9.8)
+    rb-inotify (0.9.8)
+      ffi (>= 0.5.0)
+    rouge (1.11.1)
+    rspec (3.5.0)
+      rspec-core (~> 3.5.0)
+      rspec-expectations (~> 3.5.0)
+      rspec-mocks (~> 3.5.0)
+    rspec-core (3.5.4)
+      rspec-support (~> 3.5.0)
+    rspec-expectations (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-mocks (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-support (3.5.0)
+    safe_yaml (1.0.4)
+    sass (3.4.23)
+    slop (3.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  fakefs
+  nokogiri
+  pry
+  pulsar-jekyll-code-example!
+  rspec
+
+BUNDLED WITH
+   1.14.4

data/LICENSE.md

@@ -0,0 +1,27 @@
+Copyright (c) 2015, GovDelivery, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this 
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, 
+   this list of conditions and the following disclaimer in the documentation 
+   and/or other materials provided with the distribution.
+
+3. Neither the name of GovDelivery nor the names of its contributors may be 
+   used to endorse or promote products derived from this software without 
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE 
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,191 @@
+[![Build Status](https://travis-ci.org/govdelivery/jekyll-code-example-tag.svg?branch=master)](https://travis-ci.org/govdelivery/jekyll-code-example-tag)
+[![Gem Version](https://badge.fury.io/rb/jekyll-code-example-tag.svg)](http://badge.fury.io/rb/jekyll-code-example-tag)
+
+jekyll-code-example-tag
+=======================
+
+Provides a tag that allows you to include in your posts and pages code examples
+for multiple languages that are kept in separate files. Another tag allows you
+to combine all code examples that are on a page.
+
+## Installation
+
+Add the following to your application's Gemfile:
+
+    gem 'jekyll-code-example-tag'
+
+and then execute:
+
+    bundle install
+
+Or install it manually:
+
+    gem install jekyll-code-example-tag
+
+Then, include a script tag in your page or layout to fetch the required
+javascript:
+
+    <script type="text/javascript" src="/js/jekyll-code-example-buttons.js"></script>
+
+You may also overwrite the provided javascript by writing a `jekyll-code-example-buttons.js`
+file in the `/js/` directory of your Jekyll project.
+
+## Usage
+
+### Configure CSS Classes
+
+Via your site's _config.yml, you can define what CSS class or classes the 
+example buttons and button containers will have. For example:
+
+    code_example_buttons_class: 'the_buttons'
+    code_example_button_class: 'a_button'
+
+will cause each button to have the class `a_button`, and buttons will be inside
+a div with the class `the_buttons`. 
+
+`code_example_buttons_class` defaults to 'buttons', and 
+`code_example_button_class` defaults to 'button'.
+
+Same is true for ```code_example_list_class``` which controls the class used for the ```<li>``` and ```<ul>``` tags.
+The default class is 'code-tab' which can be changed by setting:
+```
+code_example_list_class: my-list-class
+```
+in _config.yml.
+
+### code_example
+
+First, select a folder to place your code examples in. By default, the top
+level folder `code_examples` will be used. If you would like to store your
+examples in a different folder, than create and set a `code_example_dir`
+setting in your _config.yaml:
+
+    code_example_dir: assets/code/examples
+
+Now, add some code examples. Create folders for each language you would like to
+provide a code example for. Then, add files to each language folder that 
+contain language appropriate code examples.
+
+For example, say we would like to include some Hello World examples in Ruby and
+Python. First, assuming we are using the default code examples directory, we
+would add the following to your project:
+
+    .
+    |-code_examples
+      |-ruby
+        |-hello_world
+      |-python
+        |-hello_world
+
+`ruby/hello_world` could contain
+
+    puts "Hello World"
+
+while `python/hello_world` could contain
+
+    print "Hello World"
+
+Now, create a post that includes these code examples. Include a code example in
+a page or posting with the *code_example* tag:
+
+    ---
+    title: Starting to Program
+    ---
+
+    Here is everybody's favorite first program, in Ruby and Python.
+
+    {% code_example hello_world %}
+
+Build your site, and you will find a page that contains the following markup:
+
+    <p>Here is everybody's favorite first program, in Ruby and Python.</p>
+
+    <div class="code-examples">            
+      <div class="buttons examples">
+        <ul>
+          <li><a href="#" class="button active" target="Python">Python</a></li>
+          <li><a href="#" class="button" target="ruby">Ruby</a></li>
+        </ul>
+      </div>
+      <div class="highlight example python" style="display: block;">
+        <pre><code class="language-python" data-lang="python">print "Hello World"</code></pre>
+      </div>
+      <div class="highlight example ruby" style="display: none;">
+            <pre><code class="language-ruby" data-lang="ruby">puts "Hello World"</code></pre>
+      </div>
+    </div>
+
+The *code_example* tag will search the folders in your code examples directory
+for files that match whatever string is given to it, and will include only
+languages/files that match it. Thus, if you add a `goodbye_world` example in
+just Ruby:
+
+    .
+    |-code_examples
+      |-ruby
+        |-goodbye_world
+        |-hello_world
+      |-python
+        |-hello_world
+
+and include it in a post:
+
+    {% code_example goodbye_world %}
+
+the resulting markup will include just the Ruby example:
+
+    <div class="code-examples">            
+      <div class="buttons examples">
+        <ul>
+          <li><a href="#" class="button" target="ruby">Ruby</a></li>
+        </ul>
+      </div>
+      <div class="highlight example ruby" style="display: none;">
+            <pre><code class="language-ruby" data-lang="ruby">puts "Goodbye World"</code></pre>
+      </div>
+    </div>
+
+The *code_example* tag can also support examples organized in sub directories.
+For example, say you would like to organize some of your code examples by
+product and API version:
+
+    .
+    |-code_examples
+      |-productA
+        |-api_v1
+          |-ruby
+            |-widget_maker
+          |-python
+            |-widget_maker
+        |-api_v2
+          |-ruby
+            |-widget_maker
+          |-python
+            |-widget_maker
+      |-productB
+        |-api_v1
+          |-ruby
+            |-authenticating
+          |-python
+            |-authenticating
+      |-ruby
+        |-hello_world
+      |-python
+        |-hello_world
+
+With the above directory structure, including any of the following calls to
+code_example will result in including only the relevant code examples from
+the referred to directory:
+
+    {% code_example productA/api_v1/widget_maker %}
+    {% code_example productA/api_v2/widget_maker %}
+    {% code_example productB/api_v1/authenticating %}
+    {% code_example hello_world %}
+
+### all_page_code_examples
+
+If you have included a few code examples on a page via the *code_example* tag,
+you can provide your readers with an easy to copy version of all of your
+examples by using the *all_page_code_examples* tag:
+
+    {% all_page_code_examples %}

data/lib/js/jekyll-code-example-buttons.js.rb

@@ -0,0 +1,23 @@
+def code_example_buttons_js(site) 
+  buttons_class = site.config['code_example_buttons_class'] ? site.config['code_example_buttons_class'] : 'buttons' 
+  button_class = site.config['code_example_button_class'] ? site.config['code_example_button_class'] : 'button' 
+
+  <<EOF
+"use strict";
+
+jQuery(function(){
+  jQuery('.#{buttons_class}.examples .#{button_class}').click(function(e){
+        e.preventDefault();
+        var parent = jQuery(this).closest('.code-examples');
+        var target = jQuery(this).attr('target');
+
+        parent.find('.example').hide();
+        parent.find('.example.'+target).show();
+        parent.find('.#{buttons_class}.examples .#{button_class}.active').removeClass('active');
+        parent.find('.#{buttons_class}.examples .#{button_class}[target="'+target+'"]').addClass('active');
+  });
+
+  jQuery('.#{buttons_class}.examples li:first-child .#{button_class}').click();
+});
+EOF
+end

data/lib/pulsar-jekyll-code-example.rb

@@ -0,0 +1,154 @@
+require_relative 'js/jekyll-code-example-buttons.js.rb'
+require 'htmlentities'
+
+module Jekyll
+  module CodeExampleTags
+
+    def self.code_example_dir(site) 
+      site.fetch('code_example_dir', 'code_examples')
+    end
+
+    # Returns a hash of available code examples (per language) for the provided example name
+    def self.code_examples(context_path, example_name, site)
+      # Collect all relevant files
+      examples_root = File.join(code_example_dir(site), context_path)
+
+      code_folders = Dir.entries(examples_root).select do |entry|
+        File.directory? File.join(examples_root, entry) and !(entry =='.' || entry == '..')
+      end
+
+      examples = {}
+      code_folders.each do |lang|
+        code_folder = File.join(examples_root, lang)
+        example_file = Dir.entries(code_folder).find do |entry|
+          File.file? File.join(code_folder, entry) and entry == example_name
+        end
+        if example_file
+          examples[lang] = File.join(code_folder, example_file)
+        end
+      end
+
+      examples
+    end
+
+    def self.buttons_markup(examples, context)
+      site = context['site']
+      buttons_class = site['code_example_buttons_class'] ? site['code_example_buttons_class'] : 'buttons'
+      button_class = site['code_example_button_class'] ? site['code_example_button_class'] : 'button'
+      list_class = site['code_example_list_class'] ? site['code_example_list_class'] : 'code-tab'
+      menu_items = ""
+
+      examples_reverse = Hash[examples.to_a.reverse]
+
+      examples_reverse.each_key do |lang|
+
+	    menu_items << "<li class='#{list_class}'><a href='#' class='#{button_class}' target='#{lang}'>#{lang.capitalize}</a></li>"
+      end
+      <<EOF
+            <div class="#{buttons_class} examples">
+              <ul class="#{list_class}">
+                #{menu_items}
+              </ul>
+            </div>
+EOF
+    end
+
+    def self.example_markup(language, content)
+      he = HTMLEntities.new
+      <<EOF
+          <div class="example language-#{language} #{language}">
+            <pre class="prettyprint lang-#{language}"><code data-lang="#{language}">#{he.encode(content)}</code></pre>
+          </div>
+EOF
+
+    end
+
+    def self.wrap_examples_div(content)
+      "<div class='code-examples'>#{content}</div>"
+    end
+
+    def self.get_example_name_and_context(example_string)
+      example_string.strip! 
+      if example_string.include?('/')
+        example_arr = example_string.split('/')
+        example_name = example_arr.delete_at(-1)
+        context_path = example_arr.join(File::SEPARATOR) + File::SEPARATOR 
+      else
+        context_path = ''
+        example_name = example_string
+      end
+
+      return context_path, example_name
+    end
+
+    class CodeExampleTag < Liquid::Tag
+      def initialize(tag_name, example_string, tokens)
+        @context_path, @example_name = Jekyll::CodeExampleTags::get_example_name_and_context(example_string) 
+        super
+      end
+
+      def render(context)
+
+        examples = Jekyll::CodeExampleTags::code_examples(@context_path, @example_name, context['site'])
+
+        # Build the code example elements
+        output = Jekyll::CodeExampleTags::buttons_markup(examples, context)
+        examples.each do |lang, path|
+          example_content = File.read(path)
+          output << Jekyll::CodeExampleTags::example_markup(lang, example_content)
+        end
+
+        output = Jekyll::CodeExampleTags::wrap_examples_div(output)
+      end
+    end
+
+    class AllPageCodeExamplesTag < Liquid::Tag
+      def render(context)
+        examples = {}
+        context['page']['content'].scan(/\{%\s*code_example (\S+)\s*%\}/) do |name|
+          context_path, example_name = Jekyll::CodeExampleTags::get_example_name_and_context(name[0])
+          more_examples = Jekyll::CodeExampleTags::code_examples(context_path, example_name, context['site'])
+          examples.merge!(more_examples){|key, pre_example, new_example| "#{pre_example}\n#{new_example}"}
+        end
+
+        # Build the code example elements
+        output = Jekyll::CodeExampleTags::buttons_markup(examples, context)
+        examples.each do |lang, paths|
+          example_content = ""
+          for path in paths.split("\n")
+            example_content << File.read(path)
+          end
+          output << Jekyll::CodeExampleTags::example_markup(lang, example_content)
+        end
+
+        output = Jekyll::CodeExampleTags::wrap_examples_div(output)
+      end
+    end
+
+    class CodeExamplesJsFile < Jekyll::StaticFile
+      def write(dest)
+
+        dest_path = File.join(dest, @dir, @name)
+
+        FileUtils.mkdir_p(File.dirname(dest_path))
+        content = code_example_buttons_js(@site)
+        File.open(dest_path, 'w') do |f|
+          f.write(content)
+        end
+      end
+    end
+
+    class CodeExamplesJsGenerator < Jekyll::Generator
+      safe true
+    
+      def generate(site)
+        name = 'jekyll-code-example-buttons.js'
+        destination = '/js/'
+        site.static_files << CodeExamplesJsFile.new(site, site.source, destination, name)
+      end
+    end
+  end
+end
+
+Liquid::Template.register_tag('code_example', Jekyll::CodeExampleTags::CodeExampleTag)
+Liquid::Template.register_tag('all_page_code_examples', Jekyll::CodeExampleTags::AllPageCodeExamplesTag)

data/pulsar-jekyll-code-example.gemspec

@@ -0,0 +1,20 @@
+Gem::Specification.new do |s|
+  s.name        = 'pulsar-jekyll-code-example'
+  s.version     = '1.0.0'
+  s.date        = '2015-02-03'
+  s.authors     = ['Paul Stanton']
+  s.email       = 'paul.stanton@jadu.net'
+  s.homepage    = 'https://github.com/Stanton/pulsar-jekyll-code-example'
+  s.license     = 'BSD-3-Clause'
+  s.summary     = 'Tags for including code examples in posts and pages.'
+  s.description = %q{Provides a tag that allows you to include in your posts 
+                     and pages code examples for multiple langagues that are 
+                     kept in seperate files. Another tag allows you to combine
+                     all code examples that are on a page.}
+
+  s.add_runtime_dependency 'jekyll'
+  s.add_runtime_dependency 'htmlentities'
+
+  s.files        = `git ls-files`.split($\)
+  s.require_paths = ['lib']
+end

data/spec/all_page_code_examples_spec.rb

@@ -0,0 +1,31 @@
+require_relative './spec_helper.rb'
+require 'pry'
+
+describe 'all_page_code_examples', fakefs: true do
+
+  let(:page) do
+    page = <<EOF
+{% code_example hello_world %}
+{% code_example goodbye_world %}
+{% all_page_code_examples %}
+EOF
+  end
+
+  before(:all) do
+    FakeFS.activate!
+    FileUtils.mkdir_p('code_examples/python')
+    File.open('code_examples/python/hello_world', 'w') { |f| f << 'print "Hello World"'}  
+    File.open('code_examples/python/goodbye_world', 'w') { |f| f << 'print "Goodbye World"'}
+  end
+
+  after(:all) do
+    FakeFS.deactivate!
+  end
+
+  it 'can be used' do
+    t = Liquid::Template.parse(page)
+    o = t.render!({'site' => {}, 'page' => {'content' => page}})
+    o_html = Nokogiri::HTML.parse(o)
+    expect(o_html.search("[text()*='print \"Hello World\"print \"Goodbye World\"']")).not_to be_empty
+  end
+end

data/spec/code_example_spec.rb

@@ -0,0 +1,88 @@
+require_relative './spec_helper.rb'
+
+def check_code_example_conditions(o_obj, buttons_class: 'buttons', button_class: 'button')
+  expect(o_obj.xpath('/div[@class="code-examples"]/div[@class="'+buttons_class+' examples"]/ul/li/a[@class="'+button_class+'"][@target="ruby"][.="Ruby"]')).not_to be_empty
+  expect(o_obj.xpath('/div[@class="code-examples"]/div[@class="'+buttons_class+' examples"]/ul/li/a[@class="'+button_class+'"][@target="python"][.="Python"]')).not_to be_empty
+  ruby_example = o_obj.xpath('/div[@class="code-examples"]/div[@class="highlight example ruby"]/pre/code[@class="language ruby"][@data-lang="ruby"]')
+  expect(ruby_example).not_to be_empty
+  expect(ruby_example.first.content).to eq 'puts "Hello World"'
+  python_example = o_obj.xpath('/div[@class="code-examples"]/div[@class="highlight example python"]/pre/code[@class="language python"][@data-lang="python"]')
+  expect(python_example).not_to be_empty
+  expect(python_example.first.content).to eq 'print "Hello World"'
+end
+
+describe 'code_example', fakefs: true do
+
+  let(:page) { "{% code_example hello_world %}" }
+
+  before(:all) do
+    FakeFS.activate!
+  end
+
+  after(:all) do
+    FakeFS.deactivate!
+  end
+
+  it 'can be used' do
+    FileUtils.mkdir_p('code_examples/ruby')
+    FileUtils.mkdir_p('code_examples/python')
+    File.open('code_examples/ruby/hello_world', 'w') { |f| f << 'puts "Hello World"'}
+    File.open('code_examples/python/hello_world', 'w') { |f| f << 'print "Hello World"'}  
+
+    t = Liquid::Template.parse(page)
+    o = t.render!({'site' => {}})
+    o_obj = Nokogiri::XML.parse(o)
+    check_code_example_conditions(o_obj)
+  end
+
+  it 'can be configured via "code_example_dir"' do
+    FileUtils.mkdir_p('examples/ruby')
+    FileUtils.mkdir_p('examples/python')
+    File.open('examples/ruby/hello_world', 'w') { |f| f << 'puts "Hello World"'}
+    File.open('examples/python/hello_world', 'w') { |f| f << 'print "Hello World"'}  
+
+    t = Liquid::Template.parse(page)
+    o = t.render!({'site' => {'code_example_dir' => 'examples'}})
+    o_obj = Nokogiri::XML.parse(o)
+    check_code_example_conditions(o_obj)
+  end
+
+  it 'can be configured via "code_example_button_class"' do
+    FileUtils.mkdir_p('code_examples/ruby')
+    FileUtils.mkdir_p('code_examples/python')
+    File.open('code_examples/ruby/hello_world', 'w') { |f| f << 'puts "Hello World"'}
+    File.open('code_examples/python/hello_world', 'w') { |f| f << 'print "Hello World"'}  
+
+    t = Liquid::Template.parse(page)
+    o = t.render!({'site' => {'code_example_button_class' => 'button'}})
+    o_obj = Nokogiri::XML.parse(o)
+    check_code_example_conditions(o_obj, button_class: 'button')
+  end
+
+  it 'can be configured via "code_example_buttons_class"' do
+    FileUtils.mkdir_p('code_examples/ruby')
+    FileUtils.mkdir_p('code_examples/python')
+    File.open('code_examples/ruby/hello_world', 'w') { |f| f << 'puts "Hello World"'}
+    File.open('code_examples/python/hello_world', 'w') { |f| f << 'print "Hello World"'}  
+
+    t = Liquid::Template.parse(page)
+    o = t.render!({'site' => {'code_example_buttons_class' => 'button-group'}})
+    o_obj = Nokogiri::XML.parse(o)
+    check_code_example_conditions(o_obj, buttons_class: 'button-group')
+  end
+
+
+  it 'allows for dividing examples via context' do
+    FileUtils.mkdir_p('code_examples/v1/ruby')
+    FileUtils.mkdir_p('code_examples/v1/python')
+    File.open('code_examples/v1/ruby/hello_world', 'w') { |f| f << 'puts "Hello World"'}
+    File.open('code_examples/v1/python/hello_world', 'w') { |f| f << 'print "Hello World"'}  
+
+    page = "{% code_example v1/hello_world %}"
+
+    t = Liquid::Template.parse(page)
+    o = t.render!({'site' => {}})
+    o_obj = Nokogiri::XML.parse(o)
+    check_code_example_conditions(o_obj)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+require 'fakefs/spec_helpers'
+require 'jekyll'
+require 'liquid'
+require 'nokogiri'
+require 'pry'
+require 'rspec'
+require_relative '../lib/pulsar-jekyll-code-example.rb'
+
+RSpec.configure do |config|
+  config.include FakeFS::SpecHelpers, fakefs: true
+end
+
+Pry.config.history.should_save = false;
+Pry.config.history.should_load = false;

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification
+name: pulsar-jekyll-code-example
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Paul Stanton
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: htmlentities
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: "Provides a tag that allows you to include in your posts \n                     and
+  pages code examples for multiple langagues that are \n                     kept
+  in seperate files. Another tag allows you to combine\n                     all code
+  examples that are on a page."
+email: paul.stanton@jadu.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.md
+- README.md
+- lib/js/jekyll-code-example-buttons.js.rb
+- lib/pulsar-jekyll-code-example.rb
+- pulsar-jekyll-code-example.gemspec
+- spec/all_page_code_examples_spec.rb
+- spec/code_example_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/Stanton/pulsar-jekyll-code-example
+licenses:
+- BSD-3-Clause
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Tags for including code examples in posts and pages.
+test_files: []