high_voltage 0.9.3 → 1.0.1

data/{README.rdoc → README.md}

@@ -1,14 +1,16 @@
-= High Voltage
+# High Voltage [![Build Status](http://travis-ci.org/thoughtbot/high_voltage.png)](http://travis-ci.org/thoughtbot/high_voltage)
 
 Rails engine for static pages.
 
 ... but be careful. [Danger!](http://www.youtube.com/watch?v=HD5tnb2RBYg)
 
-== Static pages?
+Static pages?
+-------------
 
 Yeah, like "About us", "Directions", marketing pages, etc.
 
-== Installation
+Installation
+------------
 
     $ gem install high_voltage
 
@@ -16,15 +18,17 @@ Include in your Gemfile:
 
     gem "high_voltage"
 
-For Rails versions prior to 3.0, use the rails2 branch of high_voltage:
-https://github.com/thoughtbot/high_voltage/tree/rails2    
+For Rails versions prior to 3.0, use the 0.9.2 tag of high_voltage:
 
-== Usage
+    https://github.com/thoughtbot/high_voltage/tree/v0.9.2
+
+Usage
+-----
 
 Write your static pages and put them in the RAILS_ROOT/app/views/pages directory.
 
-    mkdir app/views/pages
-    touch app/views/pages/about.html.erb
+    $ mkdir app/views/pages
+    $ touch app/views/pages/about.html.erb
 
 After putting something interesting there, you can link to it from anywhere in your app with:
 
@@ -34,9 +38,14 @@ This will also work, if you like the more explicit style:
 
     link_to "About", page_path(:id => "about")
 
+You can nest pages in a directory structure, if that makes sense from a URL perspective for you:
+
+    link_to "Q4 Reports", page_path("about/corporate/policies/HR/en_US/biz/sales/Quarter-Four")
+
 Bam.
 
-== Routes
+Routes
+------
 
 By default, the static page routes will be like /pages/:id (where :id is the view filename).
 
@@ -48,13 +57,22 @@ In that case, you'd need an app/views/pages/home.html.erb file.
 
 Generally speaking, you need to route to the 'show' action with an :id param of the view filename.
 
+High Voltage will generate a named route method of `page_path` which you can use, as well.  If you 
+want to generate a named route (with the :as routing option) for some route which will be handled 
+by High Voltage, make sure not to use :page as the name, because that will conflict with the named 
+route generated by High Voltage itself.  For example, this will work for top-level routes (we will 
+get a named route called `static_path` which does not conflict with the generated `page_path` method):
+
+    match '/:id' => 'high_voltage/pages#show', :as => :static, :via => :get
+
 You can route the root url to a high voltage page like this:
 
     root :to => 'high_voltage/pages#show', :id => 'home'
 
 Which will render a homepage from app/views/pages/home.html.erb
 
-== Override
+Override
+--------
 
 Most common reasons to override?
 
@@ -63,7 +81,12 @@ Most common reasons to override?
 
 Create a PagesController of your own:
 
-    script/generate controller pages
+    $ rails generate controller pages
+
+Override the default route:
+
+    # in config/routes.rb
+    resources :pages
 
 Then modify it to subclass from High Voltage, adding whatever you need:
 
@@ -82,7 +105,8 @@ Then modify it to subclass from High Voltage, adding whatever you need:
         end
     end
 
-== Testing
+Testing
+-------
 
 Just a suggestion, but you can test your pages using Shoulda pretty easily:
 
@@ -103,6 +127,23 @@ If you're not using a custom PagesController be sure to test <code>HighVoltage::
 
 Enjoy!
 
-== License
+Contributing
+------------
+
+Please see CONTRIBUTING.md for details.
+
+Credits
+-------
+
+![thoughtbot](http://thoughtbot.com/images/tm/logo.png)
+
+High Voltage is maintained and funded by [thoughtbot, inc](http://thoughtbot.com/community)
+
+Thank you to all [the contributors](https://github.com/thoughtbot/high_voltage/contributors)!
+
+The names and logos for thoughtbot are trademarks of thoughtbot, inc.
+
+License
+-------
 
-Copyright (c) thoughtbot, inc -- released under the MIT license.
+High Voltage is Copyright © 2009-2011 thoughtbot. It is free software, and may be redistributed under the terms specified in the MIT-LICENSE file.

data/app/controllers/high_voltage/pages_controller.rb

@@ -2,7 +2,13 @@ class HighVoltage::PagesController < ApplicationController
 
   unloadable
 
-  rescue_from ActionView::MissingTemplate, :with => :invalid_page
+  rescue_from ActionView::MissingTemplate do |exception|
+    if exception.message =~ %r{Missing template pages/}
+      raise ActionController::RoutingError, "No such page: #{params[:id]}"
+    else
+      raise exception
+    end
+  end
 
   def show
     render :template => current_page
@@ -10,12 +16,13 @@ class HighVoltage::PagesController < ApplicationController
 
   protected
 
-    def invalid_page
-      raise ActionController::RoutingError, "No such page: #{params[:id]}"
+    def current_page
+      "pages/#{clean_path}"
     end
 
-    def current_page
-      "pages/#{params[:id].to_s.downcase}"
+    def clean_path
+      path = Pathname.new "/#{params[:id]}"
+      path.cleanpath.to_s[1..-1]
     end
 
 end

data/config/routes.rb

@@ -1,3 +1,3 @@
 Rails.application.routes.draw do
-  resources :pages, :controller => 'high_voltage/pages', :only => :show
+  match '/pages/*id' => 'high_voltage/pages#show', :as => :page, :format => false
 end

metadata

@@ -1,75 +1,58 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: high_voltage
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 9
-  - 3
-  version: 0.9.3
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+  prerelease: 
 platform: ruby
-authors: 
-- Dan Croak
+authors:
 - Matt Jankowski
-- Tammer Saleh
+- Dan Croak
 - Nick Quaranto
-- Tristan Dunn
 - Chad Pytel
 - Joe Ferris
+- J. Edward Dewyea
+- Tammer Saleh
+- Mike Burns
+- Tristan Dunn
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2010-12-30 00:00:00 -05:00
-default_executable: 
+date: 2011-09-04 00:00:00.000000000Z
 dependencies: []
-
 description: Fire in the disco.  Fire in the ... taco bell.
 email: support@thoughtbot.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - MIT-LICENSE
-- README.rdoc
+- README.md
 - app/controllers/high_voltage/pages_controller.rb
 - config/routes.rb
 - lib/high_voltage/engine.rb
 - lib/high_voltage.rb
-has_rdoc: true
 homepage: http://github.com/thoughtbot/high_voltage
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
 summary: Simple static page rendering controller
 test_files: []
-