wax_tasks 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0f3ee5c37e9bdd609505415066d2e024f0ae2c98
-  data.tar.gz: c0f9c31e128a27ba5e474df8987c9105317a1a98
+  metadata.gz: 823956054c121e807115077ba59f73c6e1a11bd8
+  data.tar.gz: c3e1e49fa4f00782b45359857aa102382aa61828
 SHA512:
-  metadata.gz: b57d647c1cbc1851d67bf5c1e5bd267a7feb3224d906dbfd8b59ac9e73f4a91645542051447d74e5e31157a0cdcf6d6e665ea1ab715b13ca6a9da993d5d09ecc
-  data.tar.gz: 65574cf6e3366c037df690884f06b8f2944d1241998c180c46f11964b58af8bd5417da3a0de5ee23b06c629f40539da128057062cb419dfcc34a556bf133cb28
+  metadata.gz: 9753ef5e8f16ad101cec17e5282dd8a0f6c374b678a0b3cb4492286002ca2645bfeaecedc87a9d61438d9788cc37b4e734f3181d754f97df8b887476de9c87a2
+  data.tar.gz: edef1c3c3c8781a694efa195f31ca8c6724f8c4e8511d7acaecab66037eff1658f5dbb56c9335486bced3e6d84604e10cdd7fde24c7215fc55e71481a8784728

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/lib/tasks/config.rake

@@ -7,9 +7,9 @@ namespace :wax do
     begin
       $config = YAML.load_file('_config.yml')
       $argv = ARGV.drop(1)
-      $argv.each { |a| task a.to_sym do ; end }
-    rescue
-      puts "Cannot load _config.yml".magenta
+      $argv.each { |a| task a.to_sym do; end }
+    rescue StandardError
+      puts('Cannot load _config.yml').magenta
       exit 1
     end
   end

data/lib/tasks/ghbranch.rake

@@ -1,34 +1,33 @@
 require 'jekyll'
 require 'tmpdir'
 require 'fileutils'
-require 'colorized_string'
 
 namespace :wax do
   desc 'build site with gh-baseurl and publish to gh-pages branch'
   task :ghbranch => :config do
     FileUtils.rm_rf('_site')
 
-    baseurl = $config['gh-baseurl']
+    opts = {
+      'source' => '.',
+      'destination' => '_site',
+      'config' => '_config.yml',
+      'baseurl' => $config['gh-baseurl'],
+      'incremental' => true,
+      'verbose' => true
+    }
 
-    Jekyll::Site.new(Jekyll.configuration({
-      "source"      => ".",
-      "destination" => "_site",
-      "config" => "_config.yml",
-      "baseurl" => baseurl,
-      "incremental" => true,
-      "verbose" => true
-    })).process
+    Jekyll::Site.new(Jekyll.configuration(opts)).process
 
     origin = `git config --get remote.origin.url`
 
     Dir.mktmpdir do |tmp|
-      cp_r "_site/.", tmp
+      cp_r '_site/.', tmp
       Dir.chdir tmp
 
-      system "git init" # Init the repo.
-      system "git add . && git commit -m 'Site updated at #{Time.now.utc}'"
-      system "git remote add origin #{origin}"
-      system "git push origin master:refs/heads/gh-pages --force"
+      system 'git init' # Init the repo.
+      system "git add . && git commit -m 'Site updated at " + Time.now.utc + "'"
+      system 'git remote add origin ' + origin
+      system 'git push origin master:refs/heads/gh-pages --force'
     end
   end
 end

data/lib/tasks/iiif.rake

@@ -3,48 +3,48 @@ require 'iiif_s3'
 
 namespace :wax do
   task :iiif => :config do
-
-    FileUtils::mkdir_p 'tiles'
+    FileUtils.mkdir_p './_iiif/tiles'
     imagedata = []
     id_counter = 0
-
     if $argv.empty?
-      puts "You must specify one or more collections after 'bundle exec rake wax:iiif' to generate.".magenta
+      puts("You must specify one or more collections after 'bundle exec rake wax:iiif' to generate.").magenta
       exit 1
     else
+      build_opts = {
+        :base_url => $config['baseurl'] + '/tiles',
+        :output_dir => './_iiif/tiles',
+        :tile_scale_factors => [1, 2],
+        :verbose => true
+      }
       $argv.each do |a|
-        dirpath = './_iiif/' + a
-        unless Dir.exist?(dirpath)
-          puts ("Source path '" + dirpath + "' does not exist. Exiting.").magenta
-          exit 1
-        else
-          id_counter+=1
-          imagefiles = Dir[dirpath + "/*"].sort!
+        dirpath = './_iiif/source_images/' + a
+        if Dir.exist?(dirpath)
+          id_counter += 1
+          imagefiles = Dir[dirpath + '/*'].sort!
           counter = 1
           imagefiles.each do |imagefile|
             begin
-              basename = File.basename(imagefile, ".*")
-              opts = {}
-              opts[:id] = basename
-              opts[:is_document] = false
-              opts[:path] = imagefile
-              opts[:label] = $config["title"] + " - " + a + " - " + basename
-              i = IiifS3::ImageRecord.new(opts)
-              counter = counter + 1
+              basename = File.basename(imagefile, '.*').to_s
+              record_opts = {
+                :id => a + '-' + basename,
+                :is_document => false,
+                :path => imagefile,
+                :label => $config['title'] + ' - ' + a + ' - ' + basename
+              }
+              i = IiifS3::ImageRecord.new(record_opts)
+              counter += 1
               imagedata.push(i)
-            rescue
-              puts ("Failed to convert image " + imagefile + ".").magenta
+            rescue StandardError
+              puts('Failed to convert image ' + imagefile + '.').magenta
               exit 1
             end
           end
+        else
+          puts("Source path '" + dirpath + "' does not exist. Exiting.").magenta
+          exit 1
         end
       end
-      builder = IiifS3::Builder.new({
-        :base_url => $config["baseurl"] + "/tiles",
-        :output_dir => "./tiles",
-        :tile_scale_factors => [1,2],
-        :verbose => true
-      })
+      builder = IiifS3::Builder.new(build_opts)
       builder.load(imagedata)
       builder.process_data()
     end

data/lib/tasks/lunr.rake

@@ -5,75 +5,66 @@ require 'colorized_string'
 namespace :wax do
   desc 'build lunr search index'
   task :lunr => :config do
-
-    meta = $config['lunr']['meta']
-    name = $config['lunr']['name'].to_s
     total_fields = []
     count = 0
-
     front_matter = "---\nlayout: null\n---"
     store_string = "\nvar store = ["
     index_string = "\nvar index = new elasticlunr.Index;\nindex.setRef('lunr_id');\nindex.saveDocument(false);"
-    if $config['lunr']['multi-language'].to_s == 'true'
-      index_string += "\nindex.pipeline.remove(elasticlunr.trimmer);" # remove elasticlunr.trimmer if multilanguage is true
+    index_string += "\nindex.pipeline.remove(elasticlunr.trimmer);" if $config['lunr_language']
+    collections = $config['collections']
+    has_content = false
+    collections.each do |c|
+      if c[1].key?('lunr_index') && c[1]['lunr_index'].key?('fields')
+        total_fields.concat c[1]['lunr_index']['fields']
+      end
+      has_content = true if c[1]['lunr_index']['content']
     end
-
-    if meta.to_s.empty?
-      puts "Lunr index parameters are not properly cofigured.".magenta
+    total_fields << 'content' if has_content
+    if total_fields.uniq.empty?
+      puts "Fields are not properly configured.".magenta
       exit 1
     else
-      meta.each { |group| total_fields += group['fields'] }
-      if total_fields.uniq.empty?
-        puts "Fields are not properly configured.".magenta
-        exit 1
-      else
-        total_fields.uniq.each do |f|
-          index_string += "\nindex.addField(" + "'" + f + "'" + "); "
-        end
-
-        meta.each do |collection|
-
-          dir = collection['dir']
-          perma = collection['permalink']
-          fields = collection['fields']
-
-          puts ("Loading pages from " + dir).cyan
-
-          Dir.glob(dir+"/*").each do |md|
+      total_fields.uniq.each { |f| index_string += "\nindex.addField(" + "'" + f + "'" + "); " }
+      collections.each do |collection|
+        name = collection[0]
+        collection = collection[1]
+        if collection.key?('lunr_index') && collection['lunr_index'].key?('fields')
+          dir = collection['directory'] || '_' + name
+          fields = collection['lunr_index']['fields']
+          puts "Loading pages from #{dir}".cyan
+          Dir.glob(dir + '/*.md').each do |md|
             begin
               yaml = YAML.load_file(md)
-              hash = Hash.new
+              hash = {}
               hash['lunr_id'] = count
-              hash['link'] = "{{ site.baseurl }}" + yaml['permalink']
-              fields.each { |f| hash[f] = clean(yaml[f].to_s) }
-              if $config['lunr']['content']
+              hash['link'] = '{{ site.baseurl }}' + yaml['permalink']
+              fields.uniq.each { |f| hash[f] = yaml[f].to_s }
+              if collection['lunr_index']['content']
                 hash['content'] = clean(File.read(md))
               end
               index_string += "\nindex.addDoc(" + hash.to_json + "); "
               store_string += "\n" + hash.to_json + ", "
               count += 1
-            rescue
-              puts ("Cannot load data from markdown pages in " + dir + ".").magenta
+            rescue StandardError
+              puts "Cannot load data from markdown pages in #{dir}.".magenta
               exit 1
             end
           end
         end
-
-        store_string = store_string.chomp(", ") + "];"
-
-        Dir.mkdir('js') unless File.exists?('js')
-        File.open("js/lunr-index.js", 'w') { |file| file.write( front_matter + index_string + store_string ) }
-        puts ("Writing lunr index to " + "js/lunr-index.js").green
       end
+      store_string = store_string.chomp(', ') + '];'
+      Dir.mkdir('js') unless File.exist?('js')
+      File.open('js/lunr-index.js', 'w') { |file| file.write(front_matter + index_string + store_string) }
+      puts "Writing lunr index to js/lunr-index.js".cyan
     end
   end
 end
 
 def clean(str)
-  str = str.gsub(/\A---(.|\n)*?---/, "") # remove yaml front matter
-  str = str.gsub(/{%(.*)%}/, "") # remove functional liquid
-  str = str.gsub(/<\/?[^>]*>/, "") # remove html
-  str = str.gsub("\\n", "").gsub(/\s+/, ' ') # remove newlines and extra space
-  str = str.gsub('"',"'").to_s # replace double quotes with single
+  str = str.gsub(/\A---(.|\n)*?---/, '') # remove yaml front matter
+  str = str.gsub(/{%(.*)%}/, '') # remove functional liquid
+  str = str.gsub(/<\/?[^>]*>/, '') # remove html
+  str = str.gsub('\\n', '').gsub(/\s+/, ' ') # remove newlines and extra space
+  str = str.tr('"', "'").to_s # replace double quotes with single
   return str
 end

data/lib/tasks/pagemaster.rake

@@ -1,10 +1,11 @@
 require 'yaml'
 require 'csv'
+require 'json'
+require 'colorized_string'
 
 namespace :wax do
   desc 'generate collection md pages from yaml or csv data source'
   task :pagemaster => :config do
-
     collections = $config['collections']
     if $argv.empty?
       puts "You must specify one or more collections after 'bundle exec rake wax:pagemaster' to generate.".magenta
@@ -13,26 +14,22 @@ namespace :wax do
       $argv.each do |a|
         collection = collections[a]
         if collection.nil?
-          puts ("The collection '" + a + "' does not exist. Check for typos in terminal and _config.yml.").magenta
+          puts "The collection '#{a}' does not exist. Check for typos in terminal and _config.yml.".magenta
           exit 1
         else
-
-          meta = Hash.new
-          meta['src']     = '_data/' + File.basename( collection['source'], ".*" ) + ".csv"
-          meta['layout']  = File.basename( collection['layout'], ".*" )
-          meta['dir']     = collection['directory']
-
-          $skipped, $completed = 0,0
-
-          unless [ meta['src'], meta['dir'], meta['layout'] ].all?
-            puts ("Your collection " + a +" is missing one or more of the required parameters (source, directory, layout) in config. please fix and rerun.").magenta
+          meta = {}
+          meta['src'] = '_data/' + collection['source']
+          meta['layout'] = File.basename(collection['layout'], '.*')
+          meta['dir'] = collection['directory']
+          if [meta['src'], meta['dir'], meta['layout']].all?
+            FileUtils.mkdir_p meta['dir']
+            data = ingest(meta['src'])
+            info = generate_pages(meta, data)
+            puts "\n#{info[:completed]} pages were generated to #{meta['dir']} directory.".cyan
+            puts "\n#{info[:skipped]} pre-existing items were skipped.".cyan
+          else
+            puts "\nYour collection '#{a}' is missing one or more of the required parameters (source, directory, layout) in config. please fix and rerun.".magenta
             exit 1
-      		else
-      			FileUtils::mkdir_p meta['dir']
-      			data = ingest(meta['src'])
-            generate_pages(meta, data)
-      			puts ("\n" + $completed.to_s + " pages were generated to " + meta['dir'] + " directory.").green
-      			puts ($skipped.to_s + " pre-existing items were skipped.").green
           end
         end
       end
@@ -41,41 +38,46 @@ namespace :wax do
 end
 
 def ingest(src)
-  begin
-    data = CSV.read(src, :headers => true, :encoding => 'utf-8')
-    duplicates = data['pid'].detect{ |i| data.count(i) > 1 }.to_s
-    unless duplicates.empty?
-      puts ("Your collection has the following duplicate ids. please fix and rerun.\n").magenta + duplicates +"\n"
-      exit 1
-    end
-    puts ("\nProcessing " + src + "....\n").cyan
-    return data.map(&:to_hash)
-  rescue
-    puts ("Cannot load " + src + ". check for typos and rebuild.").magenta
+  src_type = File.extname(src)
+  if src_type == '.csv'
+    data = CSV.read(src, :headers => true, :encoding => 'utf-8').map(&:to_hash)
+  elsif src_type == '.json'
+    data = JSON.parse(File.read(src).encode("UTF-8"))
+  else
+    puts "File type for #{src} must be .csv or .json. Please fix and rerun."
     exit 1
   end
+  pids = []
+  data.each { |d| pids << d['pid'] }
+  duplicates = pids.detect { |p| pids.count(p) > 1 } || []
+  unless duplicates.empty?
+    puts "\nYour collection has the following duplicate ids. please fix and rerun.\n#{duplicates} \n".magenta
+    exit 1
+  end
+  puts "Processing #{src}...."
+  return data
+rescue standardError
+  puts "Cannot load #{src}. check for typos and rebuild.".magenta
+  exit 1
 end
 
 def generate_pages(meta, data)
-  if $config['permalink'] == 'pretty'
-    perma_ext = "/"
-  else
-    perma_ext = ".html"
-  end
+  perma_ext = '.html'
+  perma_ext = '/' if $config['permalink'] == 'pretty'
+  info = { :completed => 0, :skipped => 0 }
   data.each do |item|
-    begin
-      pagename = item['pid']
-      pagepath = meta['dir'] + "/" + pagename + ".md"
-      if !File.exist?(pagepath)
-        File.open(pagepath, 'w') { |file| file.write( item.to_yaml.to_s + "permalink: /" + meta['dir'] + "/" + pagename + perma_ext + "\n" + "layout: " + meta['layout'] + "\n---" ) }
-        $completed+=1
-      else
-        puts pagename + ".md already exits. Skipping."
-        $skipped+=1
-      end
-    rescue
-      puts ($completed.to_s + " pages were generated before failure, most likely a record is missing a valid 'pid' value.").magenta
-      exit 1
+    pagename = item['pid']
+    pagepath = meta['dir'] + '/' + pagename + '.md'
+    if !File.exist?(pagepath)
+      File.open(pagepath, 'w') { |file| file.write(item.to_yaml.to_s + 'permalink: /' + meta['dir'] + '/' + pagename + perma_ext + "\n" + 'layout: ' + meta['layout'] + "\n---") }
+      info[:completed] += 1
+    else
+      puts "#{pagename}.md already exits. Skipping."
+      info[:skipped] += 1
     end
   end
+  return info
+rescue standardError
+  puts "#{info[:completed]} pages were generated before failure, most likely a record is missing a valid 'pid' value.".magenta
+  exit 1
 end

data/lib/tasks/s3branch.rake

@@ -1,33 +1,33 @@
 require 'jekyll'
 require 'tmpdir'
 require 'fileutils'
-require 'iiif_s3'
 
 namespace :wax do
   desc 'build site with baseurl and publish to s3 branch'
   task :s3branch => :config do
     FileUtils.rm_rf('_site')
-    baseurl = $config['baseurl']
 
-    Jekyll::Site.new(Jekyll.configuration({
-      "source"      => ".",
-      "destination" => "_site",
-      "config" => "_config.yml",
-      "incremental" => true,
-      "verbose" => true,
-      "baseurl" => baseurl
-    })).process
+    opts = {
+      'source'      => '.',
+      'destination' => '_site',
+      'config' => '_config.yml',
+      'incremental' => true,
+      'verbose' => true,
+      'baseurl' => $config['baseurl']
+    }
+
+    Jekyll::Site.new(Jekyll.configuration(opts)).process
 
     origin = `git config --get remote.origin.url`
 
     Dir.mktmpdir do |tmp|
-      cp_r "_site/.", tmp
+      cp_r '_site/.', tmp
       Dir.chdir tmp
 
-      system "git init" # Init the repo.
+      system 'git init' # Init the repo.
       system "git add . && git commit -m 'Site updated at #{Time.now.utc}'"
-      system "git remote add origin #{origin}"
-      system "git push origin master:refs/heads/s3 --force"
+      system 'git remote add origin ' + origin
+      system 'git push origin master:refs/heads/s3 --force'
     end
   end
 end

data/lib/tasks/test.rake

@@ -1,10 +1,10 @@
 require 'html-proofer'
-require 'iiif_s3'
+require 'colorized_string'
 
 namespace :wax do
   desc 'run htmlproofer, rspec if exists'
-    task :test do
-      options = {
+  task :test do
+    opts = {
       :check_external_hash => true,
       :allow_hash_href => true,
       :check_html => true,
@@ -14,12 +14,10 @@ namespace :wax do
       :verbose => true
     }
     begin
-      HTMLProofer.check_directory("./_site", options).run
-    rescue => msg
-      puts "#{msg}"
-    end
-    if File.exist?('.rspec')
-      sh 'bundle exec rspec'
+      HTMLProofer.check_directory('./_site', opts).run
+    rescue StandardError
+      puts('Failed to run wax:texts. Make sure you are using `bundle exec`.').magenta
     end
+    sh 'bundle exec rspec' if File.exist?('.rspec')
   end
 end

metadata

@@ -1,29 +1,85 @@
 --- !ruby/object:Gem::Specification
 name: wax_tasks
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
-- Marii Nyröp
+- Marii Nyrop
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-01-12 00:00:00.000000000 Z
+date: 2018-01-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: faker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12'
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.52'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.52'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12'
+        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: html-proofer
   requirement: !ruby/object:Gem::Requirement
@@ -53,27 +109,41 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.1'
 - !ruby/object:Gem::Dependency
-  name: colorize
+  name: jekyll
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '3.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
-description: 'Rake tasks for minimal exhibition sites with Jekyll. See: minicomp/wax.'
+        version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+description: Rake tasks for minimal iiif exhibition sites with Jekyll.
 email:
 - m.nyrop@columbia.edu
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- README.md
+- Gemfile
 - lib/tasks/config.rake
 - lib/tasks/ghbranch.rake
 - lib/tasks/iiif.rake
@@ -101,7 +171,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.9
+rubygems_version: 2.6.14
 signing_key: 
 specification_version: 4
 summary: Rake tasks for minimal exhibitions.

data/README.md

@@ -1,92 +0,0 @@
-# wax_tasks [![Gem Version](https://badge.fury.io/rb/wax_tasks.svg)](https://badge.fury.io/rb/wax_tasks) [![Dependency Status](https://gemnasium.com/badges/github.com/mnyrop/wax_tasks.svg)](https://gemnasium.com/github.com/mnyrop/wax_tasks)
-
-## [minicomp](https://github.com/minicomp) rake tasks for jekyll [wax](https://minicomp.github.io/wax)
-
-### current tasks:
-
-`wax:pagemaster`: generates markdown pages for jekyll collections from csv or yaml files. (same as [`pagemaster`](https://github.com/mnyrop/pagemaster) gem).
-
-`wax:iiif`: generates iiif image tiles and associated json for jekyll collections from local jpgs. (uses [`iiif_s3`](https://github.com/cmoa/iiif_s3) gem).
-
-`wax:ghbranch`: builds your jekyll site and overwrites the `gh-pages` branch to publish your compiled `_site` directory with `gh-baseurl`.
-
-`wax:s3branch`: builds your jekyll site and overwrites the `s3` branch to publish your compiled `_site` directory with `baseurl`.
-
-`wax:lunr` builds a Lunrjs search index for your site.
-
-`wax:test` runs htmlproofer and, if there is an .rspec file, runs your rspec tests.
-
-
-### set-up:
-1. add the `wax_tasks` gem to your jekyll site's `Gemfile` and install with `bundle install`:
-```
- gem 'wax_tasks'
-```
-2. Create a `Rakefile` in the root of your jekyll site and add the following to load the wax_tasks:
-```
-spec = Gem::Specification.find_by_name 'wax_tasks'
-Dir.glob("#{spec.gem_dir}/lib/tasks/*.rake").each {|r| load r}
-```
-3. Configure the collection information in your site's `_config.yaml`.
-```yaml
-# Collection params for wax:pagemaster
-collections:
-  paintings:
-    output: true
-    source: paintings-metadata.csv
-    directory: paintings
-    layout: painting-page
-  artists:
-    output: true
-    source: artist-data.yaml
-    directory: artists
-    layout: author-info-page
-```
-4. If generating a Lunrjs search index, add Lunr Params to `_config.yaml`.
-```bash
-# Lunr Search Params (for wax:lunr)
-lunr:
-  content: true
-  multi-language: true
-  meta:
-    - dir: "_projects"
-      permalink: "/projects"
-      fields:
-        - title
-        - era
-        - tags
-    - dir: "_posts"
-      permalink: "posts"
-      fields:
-        - title
-        - category
-        - tags
-```
-### to use:
-```bash
-$ bundle exec rake wax:<task_name> <option>
-```
-#### ex 1: generate md pages for `paintings` and `artists` from data files
-```bash
-$ bundle exec rake wax:pagemaster paintings artists
-```
-#### ex 2: generate iiif image tiles and associated json for `paintings` from local jpgs:
-```bash
-$ bundle exec rake wax:iiif paintings
-```
-#### ex 3: publish `_site` to `gh-pages` branch
-```bash
-$ bundle exec rake wax:ghbranch
-```
-#### ex 4: publish `_site` to `s3` branch
-```bash
-$ bundle exec rake wax:s3branch
-```
-#### ex 5: (re)generate lunrjs search index
-```bash
-$ bundle exec rake wax:lunr
-```
-#### ex 6: run CI test(s)
-```bash
-$ bundle exec rake wax:test
-```