Initial commit

Rakefile

@@ -0,0 +1,85 @@
+require 'open-uri'
+require 'yaml'
+
+desc 'Build site into docs directory'
+task :build do
+  jekyll_build
+end
+
+desc 'Update index.md and spec folder based on versions in _config.yml'
+task :update do
+  config = YAML.load_file('_config.yml')
+  current_version = config['current_version']
+  versions = config['versions']
+
+  remove_all_specs(config['update'])
+
+  puts ''
+  puts 'Fetching configured spec versions:'
+  versions.each do |version|
+    spec = fetch_spec(version, config['update'])
+
+    if current_version == version
+      write_file('index.md', spec[:body], " (#{version})")
+    end
+
+    filename = File.join(config['update']['output_dir'], version)
+    write_file("#{filename}.md", spec[:body])
+    write_file("#{filename}.svg", spec[:diagram]) if spec[:diagram]
+  end
+
+  jekyll_build
+end
+
+def jekyll_build
+  puts 'Rebuilding output into docs directory...'
+  exec 'jekyll build --destination docs && touch docs/.nojekyll'
+end
+
+def write_file(file, content, comment = nil)
+  puts " - #{file}#{comment}"
+  File.write(file, content)
+end
+
+def fetch_spec(version, config)
+  document = get(build_file_url('document', version, config))
+
+  if config['files']['diagram']
+    diagram = get(build_file_url('diagram', version, config))
+    img_tag = config['img_tpl'].gsub('{{file}}', "#{version}.svg")
+    document.gsub!(/\A(.*\n=+\n)/, "\\1\n#{img_tag}\n")
+  end
+
+  title = document.split("\n", 2).first
+  body = config['body_tpl'].gsub('{{content}}', document)
+                           .gsub('{{title}}', title)
+                           .gsub('{{version}}', version)
+
+  {
+    version: version,
+    title: title,
+    body: body,
+    diagram: diagram
+  }
+end
+
+def build_file_url(file, version, config)
+  config['url_tpl']
+    .gsub('{{version}}', version)
+    .gsub('{{file}}', config['files'][file])
+end
+
+def get(url)
+  URI.parse(url).read
+rescue OpenURI::HTTPError
+  nil
+end
+
+def remove_all_specs(config)
+  puts ''
+  puts 'Removing existing spec files:'
+  Dir["#{config['output_dir']}/*"].each do |file|
+    puts "   #{file.gsub(File.dirname(__FILE__), '')}"
+    File.delete(file)
+  end
+end