mango 0.5.4 → 0.6.0

data/.gitignore

@@ -1,7 +1,6 @@
 .DS_Store
 .bundle
-.rvmrc
+.sass-cache
 .yardoc
 *.gem
 *.tmproj
-yardoc

data/.rvmrc

@@ -0,0 +1 @@
+rvm ruby-1.9.2-p180@mango

data/.yardopts

@@ -1,6 +1,4 @@
---output-dir ./yardoc
 --markup markdown
---plugin yard-sinatra
 -
 LICENSE
-CHANGES.mdown
+CHANGES.md

data/{CHANGES.mdown → CHANGES.md}

@@ -1,5 +1,45 @@
 # CHANGES
 
+## v0.6.0 / 2011-05-29
+
+[Full changes](https://github.com/ryansobol/mango/compare/v0.5.4...v0.6.0)
+
+## Features
+
+  * Add ERB view template support [GH#21](https://github.com/ryansobol/mango/issues/21)
+  * Add ERB 404 template support [GH#26](https://github.com/ryansobol/mango/issues/26)
+  * Add 404 default response [GH#27](https://github.com/ryansobol/mango/issues/27)
+  * Add 404.html public file support [GH#28](https://github.com/ryansobol/mango/issues/28)
+  * Add Scss stylesheet template support [GH#31](https://github.com/ryansobol/mango/issues/31)
+  * Add ERB content page support [GH#33](https://github.com/ryansobol/mango/issues/33)
+  * Use ContentPage as local `page` variable within content page and view templates [GH#34](https://github.com/ryansobol/mango/issues/34)
+  * Add Liquid content page, view template, and 404 template support [GH#40](https://github.com/ryansobol/mango/issues/40)
+  * Add CoffeeScript support and JavaScript route handler [GH#36](https://github.com/ryansobol/mango/issues/36)
+
+### Dependencies
+
+  * Update Sinatra to ~> 1.2.6 [GH#14](https://github.com/ryansobol/mango/issues/14)
+  * Update RSpec to ~> 2.6.0 [GH#32](https://github.com/ryansobol/mango/issues/32)
+  * Add Sass ~> 3.1.1 [GH#24](https://github.com/ryansobol/mango/issues/24)
+  * Update Haml to ~> 3.1.1 [GH#23](https://github.com/ryansobol/mango/issues/23)
+  * Update Rack::Test to ~> 0.6.0 [GH#25](https://github.com/ryansobol/mango/issues/25)
+  * Update YARD to ~> 0.7.1 [GH#38](https://github.com/ryansobol/mango/issues/38)
+
+### Chores
+
+  * Unignore .rvmrc [GH#16](https://github.com/ryansobol/mango/issues/16)
+  * Move `Mango::Application#directory_path?` to `URI.directory?` [GH#29](https://github.com/ryansobol/mango/issues/29)
+  * Move `File.templatize` to `String#templatize` and simplify usage [GH#30](https://github.com/ryansobol/mango/issues/30)
+  * Rename all `.mdown` files to `.md` [GH#37](https://github.com/ryansobol/mango/issues/37)
+  * Remove the `yard` task from the Rakefile [GH#6](https://github.com/ryansobol/mango/issues/6)
+  * Add spec coverage for 404.liquid route handling [GH#42](https://github.com/ryansobol/mango/issues/42)
+  * Update rspec-core to 2.6.2 [GH#41](https://github.com/ryansobol/mango/issues/41)
+  * Update tilt to 1.3.1 [GH#43](https://github.com/ryansobol/mango/issues/43)
+  * Update LICENSE copyright to 2011 [GH#47](https://github.com/ryansobol/mango/issues/47)
+  * Update rspec-core to 2.6.3 [GH#46](https://github.com/ryansobol/mango/issues/46)
+  * Update Tilt to 1.3.2 [GH#45](https://github.com/ryansobol/mango/issues/45)
+  * Update multi_json to 1.0.3 [GH#53](https://github.com/ryansobol/mango/issues/53)
+
 ## v0.5.4 / 2011-04-24
 
 [Full changes](https://github.com/ryansobol/mango/compare/v0.5.3...v0.5.4)

data/Gemfile.lock

@@ -1,39 +1,49 @@
 PATH
   remote: .
   specs:
-    mango (0.5.4)
+    mango (0.6.0)
       bluecloth (~> 2.1.0)
       bundler (~> 1.0.7)
-      haml (~> 3.0.25)
+      coffee-script (~> 2.2.0)
+      haml (~> 3.1.1)
+      liquid (~> 2.2.2)
       rack (~> 1.2.2)
-      sinatra (~> 1.1.4)
+      sass (~> 3.1.1)
+      sinatra (~> 1.2.6)
       thor (~> 0.14.6)
 
 GEM
   remote: http://rubygems.org/
   specs:
     bluecloth (2.1.0)
+    coffee-script (2.2.0)
+      coffee-script-source
+      execjs
+    coffee-script-source (1.1.1)
     diff-lcs (1.1.2)
-    haml (3.0.25)
+    execjs (1.0.0)
+      multi_json (~> 1.0)
+    haml (3.1.1)
+    liquid (2.2.2)
+    multi_json (1.0.3)
     rack (1.2.2)
-    rack-test (0.5.7)
+    rack-test (0.6.0)
       rack (>= 1.0)
-    rspec (2.5.0)
-      rspec-core (~> 2.5.0)
-      rspec-expectations (~> 2.5.0)
-      rspec-mocks (~> 2.5.0)
-    rspec-core (2.5.1)
-    rspec-expectations (2.5.0)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.3)
+    rspec-expectations (2.6.0)
       diff-lcs (~> 1.1.2)
-    rspec-mocks (2.5.0)
-    sinatra (1.1.4)
+    rspec-mocks (2.6.0)
+    sass (3.1.1)
+    sinatra (1.2.6)
       rack (~> 1.1)
       tilt (>= 1.2.2, < 2.0)
     thor (0.14.6)
-    tilt (1.2.2)
-    yard (0.6.8)
-    yard-sinatra (0.5.1)
-      yard (~> 0.6.0)
+    tilt (1.3.2)
+    yard (0.7.1)
 
 PLATFORMS
   ruby
@@ -41,12 +51,14 @@ PLATFORMS
 DEPENDENCIES
   bluecloth (~> 2.1.0)
   bundler (~> 1.0.7)
-  haml (~> 3.0.25)
+  coffee-script (~> 2.2.0)
+  haml (~> 3.1.1)
+  liquid (~> 2.2.2)
   mango!
   rack (~> 1.2.2)
-  rack-test (~> 0.5.7)
-  rspec (~> 2.5.0)
-  sinatra (~> 1.1.4)
+  rack-test (~> 0.6.0)
+  rspec (~> 2.6.0)
+  sass (~> 3.1.1)
+  sinatra (~> 1.2.6)
   thor (~> 0.14.6)
-  yard (~> 0.6.8)
-  yard-sinatra (~> 0.5.1)
+  yard (~> 0.7.1)

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2010 Ryan Sobol
+Copyright (c) 2011 Ryan Sobol
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/{README.mdown → README.md}

@@ -1,5 +1,5 @@
-Mango release 0.5.4 (April 24, 2011)
-====================================
+Mango release 0.6.0 (May 29, 2011)
+==================================
 
 Copyright (c) 2010 Ryan Sobol. Licensed under the MIT license.  Please see the {file:LICENSE} for more information.
 
@@ -27,17 +27,26 @@ Mango integrates with the writing tools you're already familiar with -- the file
 
 Working with a text editor you already know *saves time*.  And writing and revising content in a file *is often easier* then using the clunky administrator interface of a CMS (e.g. WordPress).  Plus, files *match perfectly* with version control systems, like [Git](http://git-scm.com/), for powerful revision history.  Bonus!
 
+Mango supports the following *easy to write* content formats:
+
+  * [Markdown](http://daringfireball.net/projects/markdown/basics)
+  * [Haml](http://haml-lang.com/tutorial.html)
+  * [ERB](http://ruby-doc.org/stdlib/libdoc/erb/rdoc/classes/ERB.html)
+  * [Liquid](https://github.com/tobi/liquid/wiki)
+
+Don't see your favorite content format?  [Patches are welcomed](https://github.com/ryansobol/mango/issues)
+
 ### Easy to theme
 
-Mango separates a website's theme from it's content.  This makes it *easy to change* the look-and-feel of a single page or an entire website.  Mango also supports powerful template languages that make it *easy to have uniformity*  with major sections (i.e. headers, footers, navigation, sidebars, etc.) across multiple pages.  The following web and template formats are supported by Mango:
+Mango separates a website's theme from it's content.  This makes it *easy to change* the look-and-feel of a single page or an entire website.  Mango also supports powerful template languages that make it *easy to have uniformity*  with major sections (i.e. headers, footers, navigation, sidebars, etc.) across multiple pages.  In addition to the standard browser formats -- HTML, CSS, and JavaScript --  Mango also supports the following template engines:
 
-  * HAML
-  * HTML
-  * SASS
-  * CSS
-  * JavaScript
+  * [Haml](http://haml-lang.com/)
+  * [ERB](http://ruby-doc.org/stdlib/libdoc/erb/rdoc/classes/ERB.html)
+  * [Liquid](https://github.com/tobi/liquid/wiki)
+  * [Scss](http://sass-lang.com/) and [Sass](http://sass-lang.com/)
+  * [CoffeeScript](http://jashkenas.github.com/coffee-script/)
 
-with [more](https://github.com/sinatra/sinatra/blob/1.1.0/CHANGES#L12) on the way.
+Don't see your favorite template engine?  [Patches are welcomed](https://github.com/ryansobol/mango/issues)
 
 ### Easy to publish
 
@@ -53,7 +62,7 @@ With a strong separation of writing, theming and publishing, Mango applications
 
 ### Easy to maintain
 
-Mango is a database-less web framework.  With no database to install, configure, or manage, the maintenance needed to keep your website in working order is *drastically reduced*.  And because Mango is distributed as a RubyGem and respects [Semantic Versioning](http://semver.org/), *upgrading is painless andi backwards-compatible* between patch releases.
+Mango is a database-less web framework.  With no database to install, configure, or manage, the maintenance needed to keep your website in working order is *drastically reduced*.  And because Mango is distributed as a RubyGem and respects [Semantic Versioning](http://semver.org/), *upgrading is painless and backwards-compatible* between patch releases.
 
 ### Easy to scale
 
@@ -74,18 +83,20 @@ REQUIREMENTS
   * [RubyGems](https://rubygems.org/) >= 1.3.7 (bundled with Ruby)
   * [Bundler](http://gembundler.com/) ~> 1.0.7
   * [Rack](http://rack.rubyforge.org/) ~> 1.2.2
-  * [Sinatra](http://www.sinatrarb.com/) ~> 1.1.4
-  * [Haml](http://haml-lang.com/) ~> 3.0.25
-  * [Sass](http://sass-lang.com/) ~> 3.0.25 (bundled with Haml)
+  * [Sinatra](http://www.sinatrarb.com/) ~> 1.2.6
+  * [Haml](http://haml-lang.com/) ~> 3.1.1
+  * [Sass](http://sass-lang.com/) ~> 3.1.1
   * [BlueCloth](http://deveiate.org/projects/BlueCloth) ~> 2.1.0
+  * [Liquid](http://www.liquidmarkup.org/) ~> 2.2.2
+  * [CoffeeScript](http://jashkenas.github.com/coffee-script/) ~> 2.2.0
   * [Thor](https://github.com/wycats/thor) ~> 0.14.6
 
 ### Optional development dependencies
 
   * [Rake](http://rake.rubyforge.org/) ~> 0.8.7 (bundled with Ruby)
-  * [Rack::Test](https://github.com/brynary/rack-test) ~> 0.5.7
-  * [RSpec](http://rspec.info/) ~> 2.5.0
-  * [YARD](http://yardoc.org/) ~> 0.6.8
+  * [Rack::Test](https://github.com/brynary/rack-test) ~> 0.6.0
+  * [RSpec](http://rspec.info/) ~> 2.6.0
+  * [YARD](http://yardoc.org/) ~> 0.7.1
   * [YARD::Sinatra](https://github.com/rkh/yard-sinatra) ~> 0.5.1
   * [BlueCloth](http://deveiate.org/projects/BlueCloth) ~> 2.1.0
 
@@ -117,7 +128,7 @@ Simply edit the gem version in your application's `Gemfile` and re-install with
     $ cat Gemfile
     # encoding: UTF-8
     source "http://rubygems.org"
-    gem "mango", "~> 0.5.4"
+    gem "mango", "~> 0.6.0"
     $ bundle install
 
 **TIP:** If you're working in the insolation of an [RVM gemset](http://rvm.beginrescueend.com/gemsets/basics/), type `gem clean` to uninstall outdated gems.
@@ -166,21 +177,22 @@ Now that the newly generated Mango application is running, here's how the applic
     ├── README.md
     ├── config.ru
     ├── content
-    │   └── index.md
+    │   └── index.erb
     └── themes
         └── default
+            ├── javascripts
+            │   └── timer.coffee
             ├── public
             │   ├── favicon.ico
             │   ├── images
             │   │   └── particles.gif
             │   ├── javascripts
-            │   │   ├── fireworks.js
-            │   │   └── timer.js
+            │   │   └── fireworks.js
             │   ├── robots.txt
-            │   └── styles
+            │   └── stylesheets
             │       ├── fireworks.css
             │       └── reset.css
-            ├── styles
+            ├── stylesheets
             │   └── screen.sass
             └── views
                 ├── 404.haml
@@ -193,11 +205,10 @@ Now that the newly generated Mango application is running, here's how the applic
 
   * First, Mango tries to route an HTTP request to a static file found in `themes/default/public/`.
   * If no static file is found, Mango tries to route the request to a template file.
-    * For routes ending in `.css`, Mango searches for [Sass](http://sass-lang.com/) styles found in `themes/styles/`.
-    * For all other routes:
-      * Mango searches for [Markdown](http://daringfireball.net/projects/markdown/syntax) or [Haml](http://haml-lang.com/) content pages in `content/`.
-      * Mango will also try to wrap the content page within [Haml](http://haml-lang.com/) page and layout templates in `themes/default/views`.
-  * If no static or template file is found, Mango routes unknown HTTP requests to a customizable 404 page found in `themes/default/views`.
+    * For routes ending in `.js`, Mango searches for a stylesheet template in `themes/javascripts/`.
+    * For routes ending in `.css`, Mango searches for a stylesheet template in `themes/stylesheets/`.
+    * For all other routes, Mango searches for a content page in `content/` and wraps it within a view template in `themes/default/views`.
+  * If no static or template file is found, Mango routes unknown HTTP requests to a customizable 404 page found in either `themes/default/public` or `themes/default/views`.
 
 WRITING
 -------

data/Rakefile

@@ -15,19 +15,6 @@ end
 
 ###################################################################################################
 
-begin
-  require "yard"
-  require "bluecloth" # for Markdown support
-  require "yard/sinatra" # for Sinatra support
-  YARD::Rake::YardocTask.new(:yard) do |t|
-    t.options += ["--title", "Mango #{Mango::VERSION} Documentation"]
-  end
-rescue LoadError => e
-  Mango::Dependencies.create_warning_for(e)
-end
-
-###################################################################################################
-
 namespace :gem do
   desc "Builds a gem from the current project's Gem::Specification"
   task :build do

data/lib/mango.rb

@@ -4,7 +4,12 @@
 require File.expand_path("mango/dependencies", File.dirname(__FILE__))
 
 require_relative "mango/version"
+require_relative "mango/core_ext/string"
+require_relative "mango/core_ext/uri"
 require_relative "mango/rack/debugger"
 require_relative "mango/application"
 require_relative "mango/flavored_markdown"
 require_relative "mango/content_page"
+
+# @see http://en.wikipedia.org/wiki/Mango
+module Mango; end

data/lib/mango/application.rb

@@ -2,6 +2,10 @@
 require "sinatra/base"
 require "haml"
 require "sass"
+require "erb"
+require "liquid"
+require "bluecloth"
+require "coffee_script"
 
 module Mango
   # It's probably no surprise that `Mango::Application` is a modular **application controller**
@@ -12,10 +16,11 @@ module Mango
   # For **every HTTP request**, the application will first attempt to match the request URI path to
   # a public file found within `settings.public` and send that file with a 200 response code.
   #
-  # In addition to serving static assets, the application has two dynamic route handlers:
+  # In addition to serving static assets, the application has these dynamic route handlers:
   #
   #   * Content page templates with `GET *`
-  #   * Style sheet templates with `GET /styles/*.css`
+  #   * JavaScript templates with `GET /javascripts/*.js`
+  #   * Stylesheet templates with `GET /stylesheets/*.css`
   #
   # and one error handler:
   #
@@ -23,7 +28,7 @@ module Mango
   #
   # # Serving public files found within `settings.public`
   #
-  # ### Example requests routed to public files (with potential security holes)
+  # ### Example requests routed to public files
   #
   #     |-- content
   #     |   `-- override.haml
@@ -47,86 +52,199 @@ module Mango
   #
   # # Content page templates with `GET *`
   #
-  # ### Example `GET *` requests routed to content pages (with potential security holes)
+  # ### Example `GET *` requests routed to content page templates
   #
   #     |-- content
   #     |   |-- about
-  #     |   |   |-- index.haml
+  #     |   |   |-- index.erb
   #     |   |   `-- us.haml
-  #     |   |-- index.haml
+  #     |   |-- index.markdown
   #     |   |-- override.haml
   #     |   `-- turner+hooch.haml
   #     `-- security_hole.haml
   #
-  #     GET /                      => 200 content/index.haml
-  #     GET /index                 => 200 content/index.haml
-  #     GET /index?foo=bar         => 200 content/index.haml
-  #     GET /about/                => 200 content/about/index.haml
-  #     GET /about/index           => 200 content/about/index.haml
+  #     GET /                      => 200 content/index.markdown
+  #     GET /index                 => 200 content/index.markdown
+  #     GET /index?foo=bar         => 200 content/index.markdown
+  #     GET /about/                => 200 content/about/index.erb
+  #     GET /about/index           => 200 content/about/index.erb
   #     GET /about/us              => 200 content/about/us.haml
   #     GET /turner%2Bhooch        => 200 content/turner+hooch.haml
   #
   #     GET /page_not_found        => pass to NOT_FOUND error handler
   #     GET /../security_hole      => pass to NOT_FOUND error handler
   #
-  # # Style sheet templates with `GET /styles/*.css`
+  # # JavaScript templates with `GET /javascripts/*.js`
   #
-  # ### Example `GET /styles/*.css` requests routed to style sheets (with potential security holes)
+  # ### Example `GET /javascripts/*.js` requests routed to JavaScript files and templates
+  #
+  #     `-- themes
+  #       `-- default
+  #           |-- javascripts
+  #           |   |-- override.coffee
+  #           |   |-- siblings.coffee
+  #           |   `-- songs
+  #           |       `-- happy.coffee
+  #           |-- public
+  #           |   |-- root.js
+  #           |   `-- stylesheets
+  #           |       |-- econ.js
+  #           |       |-- math
+  #           |       |  `-- opposite.js
+  #           |       `-- override.js
+  #           `-- security_hole.js
+  #
+  #     GET /javascripts/siblings.js    => 200 themes/default/stylesheets/siblings.coffee
+  #     GET /javascripts/songs/happy.js => 200 themes/default/stylesheets/songs/happy.coffee
+  #
+  #     GET /javascripts/econ.js          => 200 themes/default/public/javascripts/econ.js
+  #     GET /javascripts/override.js      => 200 themes/default/public/javascripts/override.js
+  #     GET /root.js                      => 200 themes/default/public/root.js
+  #     GET /javascripts/math/opposite.js => 200 themes/default/public/javascripts/math/opposite.js
+  #
+  #     GET /javascripts/not_found.js        => pass to NOT_FOUND error handler
+  #     GET /siblings.js                     => pass to NOT_FOUND error handler
+  #     GET /javascripts/../security_hole.js => pass to NOT_FOUND error handler
+  #
+  # # Stylesheet templates with `GET /stylesheets/*.css`
+  #
+  # ### Example `GET /stylesheets/*.css` requests routed to stylesheets files and templates
   #
   #     `-- themes
   #       `-- default
   #           |-- public
   #           |   |-- default.css
-  #           |   `-- styles
+  #           |   `-- stylesheets
   #           |       |-- override.css
   #           |       |-- reset.css
-  #           |       `-- subfolder
-  #           |           `-- another.css
+  #           |       `-- folder
+  #           |           `-- print.css
   #           |-- security_hole.sass
-  #           `-- styles
+  #           `-- stylesheets
   #               |-- override.sass
-  #               |-- screen.sass
-  #               `-- subfolder
-  #                   `-- screen.sass
+  #               |-- screen.scss
+  #               `-- folder
+  #                   `-- mobile.sass
   #
-  #     GET /styles/screen.css            => 200 themes/default/styles/screen.sass
-  #     GET /styles/subfolder/screen.css  => 200 themes/default/styles/subfolder/screen.sass
+  #     GET /stylesheets/screen.css        => 200 themes/default/stylesheets/screen.scss
+  #     GET /stylesheets/folder/mobile.css => 200 themes/default/stylesheets/folder/mobile.sass
   #
-  #     GET /styles/reset.css             => 200 themes/default/public/styles/reset.css
-  #     GET /styles/override.css          => 200 themes/default/public/styles/override.css
+  #     GET /stylesheets/reset.css        => 200 themes/default/public/stylesheets/reset.css
+  #     GET /stylesheets/override.css     => 200 themes/default/public/stylesheets/override.css
   #     GET /default.css                  => 200 themes/default/public/default.css
-  #     GET /styles/subfolder/another.css => 200 themes/default/public/styles/subfolder/another.css
+  #     GET /stylesheets/folder/print.css => 200 themes/default/public/stylesheets/folder/print.css
   #
-  #     GET /styles/style_not_found.css  => pass to NOT_FOUND error handler
-  #     GET /screen.css                  => pass to NOT_FOUND error handler
-  #     GET /styles/../security_hole.css => pass to NOT_FOUND error handler
+  #     GET /stylesheets/not_found.css        => pass to NOT_FOUND error handler
+  #     GET /screen.css                       => pass to NOT_FOUND error handler
+  #     GET /stylesheets/../security_hole.css => pass to NOT_FOUND error handler
   #
   # # 404 Page Not Found with `NOT_FOUND`
   #
   # When a requested URI path cannot be matched with a public file or template file, the error
-  # handler renders the 404 template and sends it with a 404 response.
+  # handler attempts to send a 404 public file or a rendered a 404 template with a 404 HTTP
+  # response.
+  #
+  # ### Example `GET /page_not_found` request routed to a 404 public file
+  #
+  #     `-- themes
+  #         `-- default
+  #             `-- public
+  #                 `-- 404.html
+  #
+  #     GET /page_not_found => 404 themes/default/public/404.html
+  #
+  # ### Example `GET /page_not_found` request routed to a 404 Haml template
+  #
+  #     |-- content
+  #     |   `-- index.haml
+  #     `-- themes
+  #         `-- default
+  #             `-- views
+  #                 `-- 404.haml
+  #
+  #     GET /page_not_found => 404 themes/default/views/404.haml
+  #
+  # If no 404 public file or template is found, the application sends a basic "Page Not Found" page
+  # with a 404 HTTP response.
   #
   class Application < Sinatra::Base
-    set :root, Dir.getwd
-    set :theme, "default"
-    set :views, lambda { File.join(root, "themes", theme, "views") }
-    set :public, lambda { File.join(root, "themes", theme, "public") }
-    set :styles, lambda { File.join(root, "themes", theme, "styles") }
-    set :content, lambda { File.join(root, "content") }
+    # @macro [attach] sinatra.set
+    #   Defines `settings.$1`
+    #   @attribute
+    #   @overload $*
+    #   @return [String]
+    set :root,        Dir.getwd
+    set :theme,       "default"
+    set :javascripts, lambda { File.join(root, "themes", theme, "javascripts") }
+    set :public,      lambda { File.join(root, "themes", theme, "public") }
+    set :stylesheets, lambda { File.join(root, "themes", theme, "stylesheets") }
+    set :views,       lambda { File.join(root, "themes", theme, "views") }
+    set :content,     lambda { File.join(root, "content") }
+
+    # @macro [attach] sinatra.mime_type
+    #   Registers `$2` as the mime type for static files ending with `$1`
+    #   @scope class
+    #   @attribute
+    #   @overload $*
+    #   @return [String]
+    mime_type "", "text/html"
 
+    # @macro [attach] sinatra.configure
+    #   Run once, at startup, when the environment is set to `${1--1}`
+    #   @scope class
+    #   @attribute
+    #   @overload configure ${1--1}
     configure :development do
       use Mango::Rack::Debugger
     end
 
-    # For static files that don't have an extension, send the file as HTML content
-    #
-    mime_type "", "text/html"
+    # Supported JavaScript template engines
+    JAVASCRIPT_TEMPLATE_ENGINES = {
+      Tilt::CoffeeScriptTemplate => :coffee
+    }
+
+    # Supported stylesheet template engines
+    STYLESHEET_TEMPLATE_ENGINES = {
+      Tilt::ScssTemplate => :scss,
+      Tilt::SassTemplate => :sass
+    }
+
+    # Supported view template engines
+    VIEW_TEMPLATE_ENGINES = {
+      Tilt::HamlTemplate   => :haml,
+      Tilt::ERBTemplate    => :erb,
+      Tilt::LiquidTemplate => :liquid
+    }
+
+    ###############################################################################################
+
+    private
 
-    # Renders the `404.haml` template found within `settings.views` and sends it with 404 HTTP
-    # response.
+    # Renders a 404 page with a 404 HTTP response code.
     #
-    # The `404.haml` template is **not** wrapped within the `layout.haml` template when rendered,
-    # even if one exists within `settings.views`.
+    # First, the application attempts to render a public 404 file stored in `settings.public`.  If
+    # a public 404 file is found, the application will:
+    #
+    #   * Send the public 404 file with a 404 HTTP response code
+    #   * Halt execution
+    #
+    #  For example:
+    #
+    #     `-- themes
+    #         `-- default
+    #             `-- public
+    #                 `-- 404.html
+    #
+    #     GET /page_not_found => 404 themes/default/public/404.html
+    #
+    # If no match is found, the application attempts to render a 404 template stored in
+    # `settings.views`. If a 404 template is found, the application *will not* render it within a
+    # layout template, even if an appropriately named layout template exists within
+    # `settings.views`.  If a 404 template is found, the application will:
+    #
+    #   * Render the 404 template, without a layout template, as HTML
+    #   * Send the rendered 404 template with a 404 HTTP response code
+    #   * Halt execution
     #
     # For example:
     #
@@ -139,16 +257,53 @@ module Mango
     #
     #     GET /page_not_found => 404 themes/default/views/404.haml
     #
+    # Finally, if no matches are found, the application sends a basic "Page Not Found" page with a
+    # 404 HTTP response code.
+    #
+    # @method not_found
+    # @visibility public
+    #
     not_found do
-      haml :"404", :layout => false
+      file_name = "404"
+      render_404_public_file! file_name
+      render_404_template! file_name
+      "<!DOCTYPE html><title>404 Page Not Found</title><h1>404 Page Not Found</h1>"
     end
 
-    # Attempts to render style sheet templates found within `settings.styles`
+    # Given a file name, attempts to send an public 404 file, if it exists, and halt
     #
-    # First, the application attempts to match the URI path with a public CSS file stored in
-    # `settings.public`.  If a public CSS file is found, the handler will:
+    # @param [String] file_name
     #
-    #   * Send the public CSS file with a 200 HTTP response code
+    def render_404_public_file!(file_name)
+      four_oh_four_path = File.expand_path("#{file_name}.html", settings.public)
+      return unless File.file?(four_oh_four_path)
+      send_file four_oh_four_path
+    end
+
+    # Given a template name, and with a prioritized list of template engines, attempts to render a
+    # 404 template, if one exists, and halt.
+    #
+    # @param [String] template_name
+    # @see VIEW_TEMPLATE_ENGINES
+    #
+    def render_404_template!(template_name)
+      VIEW_TEMPLATE_ENGINES.each do |engine, extension|
+        @preferred_extension = extension.to_s
+        find_template(settings.views, template_name, engine) do |file|
+          next unless File.file?(file)
+          halt send(extension, template_name.to_sym, :layout => false)
+        end
+      end
+    end
+
+    ###############################################################################################
+
+    # Attempts to render JavaScript templates found within `settings.javascripts`
+    #
+    # First, the application attempts to match the URI path with a public JavaScript file stored in
+    # `settings.public`.  If a public JavaScript file is found, the application will:
+    #
+    #   * Send the public JavaScript file with a 200 HTTP response code
     #   * Halt execution
     #
     #  For example:
@@ -156,68 +311,135 @@ module Mango
     #     `-- themes
     #         `-- default
     #             `-- public
-    #                 `-- styles
-    #                     `-- reset.css
+    #                 `-- javascripts
+    #                     `-- jquery.js
     #
-    #     GET /styles/reset.css => 200 themes/default/public/styles/reset.css
+    #     GET /javascripts/jquery.js => 200 themes/default/public/javascripts/jquery.js
     #
-    # If no match is found, the route handler attempts to match the URI path with a style sheet
-    # template stored in `settings.styles`.  If a style sheet template is found, the handler will:
+    # If no match is found, the route handler attempts to match the URI path with a JavaScript
+    # template stored in `settings.javascripts`.  If a JavaScript template is found, the
+    # application will:
     #
-    #   * Convert the style sheet template from Sass to CSS
-    #   * Send the converted style with a 200 HTTP response code
+    #   * Render the template as Javascript
+    #   * Send the rendered template with a 200 HTTP response code
     #   * Halt execution
     #
     # For example:
     #
     #     `-- themes
     #         `-- default
-    #             `-- styles
-    #                 `-- screen.sass
+    #             `-- javascripts
+    #                 `-- bundle.coffee
     #
-    #     GET /styles/screen.css => 200 themes/default/styles/screen.sass
+    #     GET /javascripts/bundle.js => 200 themes/default/javascripts/bundle.coffee
     #
-    # **It's intended that requests to public CSS files and requests to style sheet templates share
-    # the `/styles/` prefix.**
+    # **It's intended that requests to public JavaScript files and requests to JavaScript templates
+    # share the `/javascripts/` prefix.**
     #
     # Finally, if no matches are found, the route handler passes execution to the `NOT_FOUND` error
     # handler.
     #
-    get "/styles/*.css" do |uri_path|
-      render_style_sheet! uri_path
+    # @macro [attach] sinatra.get
+    #   @overload get "$1"
+    #   @visibility public
+    # @method get_js
+    #
+    get "/javascripts/*.js" do |uri_path|
+      render_javascript_template! uri_path
       not_found
     end
 
-    ###############################################################################################
-
-    private
-
-    # Given a URI path, attempts to render a style sheet, if it exists, and halt
+    # Given a URI path, attempts to render a JavaScript template, if it exists, and halt
     #
     # @param [String] uri_path
+    # @see JAVASCRIPT_TEMPLATE_ENGINES
     #
-    def render_style_sheet!(uri_path)
-      styles_match     = File.join(settings.styles, "*")
-      style_sheet_path = build_style_sheet_path(uri_path)
+    def render_javascript_template!(uri_path)
+      javascript_match = File.join(settings.javascripts, "*")
+      javascript_path  = File.expand_path(uri_path, settings.javascripts)
 
-      return unless File.fnmatch(styles_match, style_sheet_path)
-      return unless File.file?(style_sheet_path)
+      return unless File.fnmatch(javascript_match, javascript_path)
 
-      content_type "text/css"
-      halt sass(uri_path.to_sym, :views => settings.styles)
+      JAVASCRIPT_TEMPLATE_ENGINES.each do |engine, extension|
+        @preferred_extension = extension.to_s
+        find_template(settings.javascripts, uri_path, engine) do |file|
+          next unless File.file?(file)
+          halt send(extension, uri_path.to_sym, :views => settings.javascripts)
+        end
+      end
     end
 
-    # Given a URI path, build a path to a potential style sheet
+    ###############################################################################################
+
+    # Attempts to render stylesheet templates found within `settings.stylesheets`
+    #
+    # First, the application attempts to match the URI path with a public stylesheet file stored in
+    # `settings.public`.  If a public stylesheet file is found, the application will:
+    #
+    #   * Send the public stylesheet file with a 200 HTTP response code
+    #   * Halt execution
+    #
+    #  For example:
+    #
+    #     `-- themes
+    #         `-- default
+    #             `-- public
+    #                 `-- stylesheets
+    #                     `-- reset.css
+    #
+    #     GET /stylesheets/reset.css => 200 themes/default/public/stylesheets/reset.css
+    #
+    # If no match is found, the route handler attempts to match the URI path with a stylesheet
+    # template stored in `settings.stylesheets`.  If a stylesheet template is found, the
+    # application will:
+    #
+    #   * Render the template as CSS
+    #   * Send the rendered template with a 200 HTTP response code
+    #   * Halt execution
+    #
+    # For example:
+    #
+    #     `-- themes
+    #         `-- default
+    #             `-- stylesheets
+    #                 `-- screen.scss
+    #
+    #     GET /stylesheets/screen.css => 200 themes/default/stylesheets/screen.scss
+    #
+    # **It's intended that requests to public stylesheet files and requests to stylesheet templates
+    # share the `/stylesheets/` prefix.**
+    #
+    # Finally, if no matches are found, the route handler passes execution to the `NOT_FOUND` error
+    # handler.
+    #
+    # @method get_css
+    #
+    get "/stylesheets/*.css" do |uri_path|
+      render_stylesheet_template! uri_path
+      not_found
+    end
+
+    # Given a URI path, attempts to render a stylesheet template, if it exists, and halt
     #
     # @param [String] uri_path
-    # @param [String] format (defaults to `sass`)
-    # @return [String] The path to a potential style sheet
+    # @see STYLESHEET_TEMPLATE_ENGINES
     #
-    def build_style_sheet_path(uri_path, format = "sass")
-      File.expand_path("#{uri_path}.#{format}", settings.styles)
+    def render_stylesheet_template!(uri_path)
+      stylesheet_match = File.join(settings.stylesheets, "*")
+      stylesheet_path  = File.expand_path(uri_path, settings.stylesheets)
+
+      return unless File.fnmatch(stylesheet_match, stylesheet_path)
+
+      STYLESHEET_TEMPLATE_ENGINES.each do |engine, extension|
+        @preferred_extension = extension.to_s
+        find_template(settings.stylesheets, uri_path, engine) do |file|
+          next unless File.file?(file)
+          halt send(extension, uri_path.to_sym, :views => settings.stylesheets)
+        end
+      end
     end
 
-    public
+    ###############################################################################################
 
     # Attempts to render content page templates found within `settings.content`
     #
@@ -237,52 +459,55 @@ module Mango
     #     GET /hello_word.html => 200 themes/default/public/hello_word.html
     #
     # If no match is found, the route handler attempts to match the URI path with a content page
-    # template stored in `settings.content`.  If a content page template is found, the handler will:
+    # template stored in `settings.content`.  If a content page template is found, the application
+    # will:
     #
-    #   * Read the content page into memory and assign it to the `@content_page` instance variable
+    #   * Read the content page from disk and render the data in memory
     #   * Render the content page's view template file (see `Mango::ContentPages`)
-    #     * A `RuntimeError` is raised if the view template does not exist within `settings.views`
+    #     * An exception is raised if a registered engine for the view template file cannot be
+    #       found or if the view template file cannot be found within `settings.views`.
     #   * Send the rendered page with a 200 HTTP response code and halt execution
     #
-    # In addition, if a `layout.haml` template exists within `settings.views`, the page's view
-    # template is wrapped within this layout when rendered.
+    # In addition, if a `layout` template file exists within `settings.views` and that layout
+    # template file shares the same file extension as the view template, then the page's view
+    # template is wrapped within this layout template when rendered.
     #
-    # For example:
+    # For example, given the following mango application:
     #
     #     |-- content
-    #     |   `-- index.haml
+    #     |   `-- index.markdown
     #     `-- themes
     #         `-- default
     #             `-- views
     #                 |-- layout.haml
     #                 `-- page.haml
     #
-    #     GET /index => 200 content/index.haml +
+    # where the `index.markdown` content page's view template file is `page.haml`, then:
+    #
+    #     GET /index => 200 content/index.markdown +
     #                       themes/default/views/page.haml +
     #                       themes/default/views/layout.haml
     #
     # Finally, if no matches are found, the route handler passes execution to the `NOT_FOUND` error
     # handler.
     #
+    # @method get_all
+    #
     get "/*" do |uri_path|
       render_index_file! uri_path
       render_content_page! uri_path
       not_found
     end
 
-    ###############################################################################################
-
-    private
-
     # Given a URI path, attempts to send an index.html file, if it exists, and halt
     #
     # @param [String] uri_path
     #
     def render_index_file!(uri_path)
-      return unless directory_path?(uri_path)
+      return unless URI.directory?(uri_path)
 
       index_match     = File.join(settings.public, "*")
-      index_file_path = build_index_file_path(uri_path)
+      index_file_path = File.expand_path(uri_path + "index.html", settings.public)
 
       return unless File.fnmatch(index_match, index_file_path)
       return unless File.file?(index_file_path)
@@ -290,65 +515,72 @@ module Mango
       send_file index_file_path
     end
 
-    # Given a URI path, build a path to a potential index.html file
-    #
-    # @param [String] uri_path
-    # @return [String] The path to a potential index.html file
-    #
-    def build_index_file_path(uri_path)
-      uri_path += "index.html"
-      File.expand_path(uri_path, settings.public)
-    end
+    # Raised when a content page is not found on disk
+    class ContentPageNotFound < RuntimeError; end
 
-    ###############################################################################################
+    # Raised when a registered engine for the content page's view template cannot be found in
+    # `VIEW_TEMPLATE_ENGINES`
+    class RegisteredEngineNotFound < RuntimeError; end
 
-    private
+    # Raised when the content page's view template cannot be found on disk
+    class ViewTemplateNotFound < RuntimeError; end
 
     # Given a URI path, attempts to render a content page, if it exists, and halt
     #
     # @param [String] uri_path
-    # @raise [RuntimeError] Raised when the content page's view template cannot be found
+    # @raise [RegisteredEngineNotFound] Raised when a registered engine for the content page's
+    #   view template cannot be found
+    # @raise [ViewTemplateNotFound] Raised when the content page's view template cannot be found
     #
     def render_content_page!(uri_path)
+      uri_path += "index" if URI.directory?(uri_path)
+
       content_match     = File.join(settings.content, "*")
-      content_page_path = build_content_page_path(uri_path)
+      content_page_path = File.expand_path(uri_path, settings.content)
       return unless File.fnmatch(content_match, content_page_path)
 
       begin
-        @content_page = Mango::ContentPage.find_by_path(content_page_path)
-      rescue Mango::ContentPage::PageNotFound
+        content_page = find_content_page(uri_path)
+      rescue ContentPageNotFound
         return
       end
 
+      view_template_path = File.expand_path(content_page.view, settings.views)
+
+      begin
+        engine = VIEW_TEMPLATE_ENGINES.fetch(Tilt[content_page.view])
+      rescue KeyError
+        message = "Cannot find registered engine for view template file -- #{view_template_path}"
+        raise RegisteredEngineNotFound, message
+      end
+
       begin
-        halt haml(@content_page.view)
+        halt send(engine, content_page.view.to_s.templatize, :locals => { :page => content_page })
       rescue Errno::ENOENT
-        view_path = File.expand_path("#{@content_page.view}.haml", settings.views)
-        raise "Unable to find a view template file -- #{view_path}"
+        message = "Cannot find view template file -- #{view_template_path}"
+        raise ViewTemplateNotFound, message
       end
     end
 
-    # Given a URI path, build a path to a potential content page
+    # Given a URI path, creates a new `ContentPage` instance by searching for and reading a content
+    # file from disk. Content files are searched consecutively until a page with a supported
+    # content page template engine is found.
     #
     # @param [String] uri_path
-    # @return [String] The path to a potential content page
-    #
-    def build_content_page_path(uri_path)
-      uri_path += "index" if directory_path?(uri_path)
-      File.expand_path(uri_path, settings.content)
-    end
-
-    ###############################################################################################
-
-    private
+    # @raise [ContentPageNotFound] Raised when a content page cannot be found for the uri path
+    # @return [ContentPage] A new instance is created and returned when found
+    # @see ContentPage::TEMPLATE_ENGINES
+    #
+    def find_content_page(uri_path)
+      ContentPage::TEMPLATE_ENGINES.each do |engine, extension|
+        @preferred_extension = extension.to_s
+        find_template(settings.content, uri_path, engine) do |file|
+          next unless File.file?(file)
+          return ContentPage.new(:data => File.read(file), :engine => engine)
+        end
+      end
 
-    # Given a URI path, determine whether or no it looks like a directory path
-    #
-    # @param [String] uri_path
-    # @return [Boolean] `true` if the path is empty or has a trailing `/`, otherwise `false`
-    #
-    def directory_path?(uri_path)
-      uri_path.empty? || uri_path[-1] == "/"
+      raise ContentPageNotFound, "Cannot find content page for path -- #{uri_path}"
     end
   end
 end