Added rake task to generate a table of contents page

Author: Tom Clark

Gemfile

@@ -0,0 +1,5 @@
+source :rubygems
+
+gem 'fileutils'
+gem 'jekyll'
+gem 'tempfile'

Gemfile.lock

@@ -0,0 +1,32 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    albino (1.3.3)
+      posix-spawn (>= 0.3.6)
+    classifier (1.3.3)
+      fast-stemmer (>= 1.0.0)
+    directory_watcher (1.4.1)
+    fast-stemmer (1.0.1)
+    fileutils (0.7)
+      rmagick (>= 2.13.1)
+    jekyll (0.11.2)
+      albino (~> 1.3)
+      classifier (~> 1.3)
+      directory_watcher (~> 1.1)
+      kramdown (~> 0.13)
+      liquid (~> 2.3)
+      maruku (~> 0.5)
+    kramdown (0.13.7)
+    liquid (2.3.0)
+    maruku (0.6.0)
+      syntax (>= 1.0.0)
+    posix-spawn (0.3.6)
+    rmagick (2.13.1)
+    syntax (1.0.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  fileutils
+  jekyll

Rakefile

@@ -0,0 +1,32 @@
+require 'rubygems'
+require 'rake'
+
+task :default => :update_toc
+
+desc "Regenerate the table of contents to include links to newest tutorials"
+task :update_toc do
+  require 'jekyll'
+  require 'tempfile'
+  require 'fileutils'
+
+  site = Jekyll::Site.new(Jekyll.configuration({})) and site.read
+
+  pages = site.pages.reject {|p| p.data["ignore"] }.reverse
+
+  toc_path = File.join(FileUtils.pwd, "pages", "table_of_contents.md")
+  temp = Tempfile.new("table_of_contents.md")
+
+  begin
+    File.readlines(toc_path).each do |line|
+      line =~ /^<!--- BEGIN TOC -->$/ ? break : temp.puts(line)
+    end
+    temp.puts "<!--- BEGIN TOC -->"
+    pages.each_with_index do |page, index|
+      temp.puts " * [#{page.data["title"]}](#{page.destination('')})"
+    end
+    temp.puts "<!--- END TOC -->"
+    FileUtils.mv(temp.path, toc_path)
+  ensure
+    temp.delete
+  end
+end

foo.md

@@ -1,6 +1,7 @@
 ---
 layout: default
 title: Decentralized Polyglot Tutorials
+ignore: true
 ---
 
 README

index.md

@@ -1,6 +1,7 @@
 ---
 layout: default
 title: Test
+ignore: true
 ---
 
 Hello, World!

pages/another_test.md

@@ -0,0 +1,12 @@
+---
+layout: default
+title: Table of Contents
+ignore: true
+---
+
+This is the TOC.  It should not be edited
+
+<!--- BEGIN TOC -->
+ * [Installing MySQL](/pages/installing-mysql.html)
+ * [Hello, World!](/pages/hello-world.html)
+<!--- END TOC -->

pages/table_of_contents.md

@@ -1,6 +1,7 @@
 ---
 layout: default
 title: Test
+ignore: true
 ---
 
 Javascript Testing