Added a Site Index page to the upper-right menus

Author: tjgrathwell

lib/contents.rb

@@ -149,7 +149,7 @@ def toc_list toc_items
   end
 
   def content
-    div class: "toc" do
+    div id: "table_of_contents", class: "toc" do
       h1 "Contents"
       toc_list hierarchy
 

lib/doc_page.rb

@@ -1,6 +1,7 @@
 require 'erector'
 require "github_flavored_markdown"
 require "contents"
+require "site_index"
 
 class InstallfestExternalRenderer < ExternalRenderer
   # render <style> tags plainly, without "text/css" (which browsers will assume by default)
@@ -216,8 +217,9 @@ def git_url
 
   def top_links
     [
+      TopLink.new(:name => "sites", :href => "#", :onclick => "$('#site_index').toggle(); return false;"),
       TopLink.new(:name => "src", :href => "#{file_name.split('.').first}/src"),
-      TopLink.new(:name => "toc", :href => "#", :onclick => "$('div.toc').toggle(); return false;"),
+      TopLink.new(:name => "toc", :href => "#", :onclick => "$('#table_of_contents').toggle(); return false;"),
       TopLink.new(:name => "git", :href => git_url),
     ]
   end
@@ -233,6 +235,7 @@ def body_content
     }
 
     widget Contents, site_name: site_name
+    widget SiteIndex
 
     div(:class=>:main) {
       h1 doc_title, :class=>"doc_title"

lib/site_index.rb

@@ -0,0 +1,29 @@
+class SiteIndex < Erector::Widget
+  @@here = File.expand_path(File.dirname(__FILE__))
+  @@project_root = File.dirname(@@here)
+  @@sites_dir = File.expand_path("sites", @@project_root)
+
+  def sites
+    return @sites if @sites
+    all_sites = Dir.glob("#{@@sites_dir}/**").map { |filename| File.basename(filename) }.sort
+    @sites = all_sites - ['es']
+  end
+
+  def site_link site
+    path = "/#{site}/"
+    li do
+      a(site, :href => path)
+    end
+  end
+
+  def content
+    div id: "site_index", class: "toc" do
+      h1 "Site List"
+      ul do
+        sites.each do |site|
+          site_link site
+        end
+      end
+    end
+  end
+end

spec/site_index_spec.rb

@@ -0,0 +1,15 @@
+here = File.expand_path File.dirname(__FILE__)
+require "#{here}/spec_helper"
+
+require "#{here}/../app"
+require "#{here}/../lib/site_index"
+
+describe Contents do
+  before :all do
+    @site_index = SiteIndex.new
+  end
+
+  it "lists all sites in the /sites/ directory, sorted, except 'es'" do
+    @site_index.sites.should == ["curriculum", "frontend", "installfest", "workshop"]
+  end
+end