brochure 0.3.0 → 0.3.1

data/README.md

@@ -1,7 +1,9 @@
 Brochure
 ========
 
-A Rack application for serving static sites with ERB templates.
+A Rack application for serving static sites with ERB templates (or any
+of the many [template languages supported by
+Tilt](http://github.com/rtomayko/tilt/blob/master/TEMPLATES.md#readme)).
 
 Sample application structure:
 
@@ -20,17 +22,52 @@ Sample application structure:
 Sample `config.ru`:
 
     require "brochure"
-    run Brochure.app(File.dirname(__FILE__))
+    ROOT = File.dirname(__FILE__)
+    run Brochure.app(ROOT)
 
-URLs are automatically mapped to template names. So `/` will render
-`templates/index.html.erb`, `/signup` will render
-`templates/signup.html.erb`, `/help/` will render
-`templates/help/index.html.erb`, and so on.
 
-Templates can render partials. Partials are denoted by a leading
-underscore in their filename. So `<%= render "shared/header" %>` will
+## Templates and URL mapping
+
+URLs are automatically mapped to template names:
+
+* `/` &rarr; `templates/index.html.erb`
+* `/signup` &rarr; `templates/signup.html.erb`
+* `/help/` &rarr; `templates/help/index.html.erb`
+
+Templates can render partials. A partial is denoted by a leading
+underscore in its filename. So `<%= render "shared/header" %>` will
 render `templates/shared/_header.html.erb` inline.
 
+Templates have access to the Rack environment via the `env` method and
+to the Brochure application via the `application` method.
+
+
+## Helper methods and instance variables
+
+You can make additional helper methods and instance variables
+available to your templates. Helper methods live in Ruby modules and
+can be included with the `:helpers` option to `Brochure.app`:
+
+    module AssetHelper
+      def asset_path(filename)
+        local_path = File.join(application.asset_root, filename)
+        if File.file?(local_path)
+          cache_buster = "?#{Digest::MD5.hexdigest(IO.read(local_path))}"
+        else
+          cache_buster = ""
+        end
+        "#{filename}#{cache_buster}"
+      end
+    end
+
+    run Brochure.app(ROOT, :helpers => [AssetHelper])
+
+Similarly, instance variables can be defined with the `:assigns`
+option:
+
+    run Brochure.app(ROOT, :assigns => { :domain => "37signals.com" })
+
+
 # Installation
 
     $ gem install brochure
@@ -39,6 +76,7 @@ Requires [Hike](http://github.com/sstephenson/hike),
 [Rack](http://rack.rubyforge.org/), and
 [Tilt](http://github.com/rtomayko/tilt).
 
+
 # License
 
 Copyright (c) 2010 Sam Stephenson and Josh Peek.

data/lib/brochure.rb

@@ -3,7 +3,7 @@ require "rack"
 require "tilt"
 
 module Brochure
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 
   autoload :Application,      "brochure/application"
   autoload :Context,          "brochure/context"

data/lib/brochure/application.rb

@@ -94,10 +94,10 @@ module Brochure
       template.render(context, locals)
     end
 
-    def respond_with(status, body, content_type = "text/html, charset=utf-8")
+    def respond_with(status, body, content_type = "text/html; charset=utf-8")
       headers = {
         "Content-Type"   => content_type,
-        "Content-Length" => body.length.to_s
+        "Content-Length" => Rack::Utils.bytesize(body).to_s
       }
       [status, headers, [body]]
     end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: brochure
 version: !ruby/object:Gem::Version 
-  hash: 19
+  hash: 17
   prerelease: false
   segments: 
   - 0
   - 3
-  - 0
-  version: 0.3.0
+  - 1
+  version: 0.3.1
 platform: ruby
 authors: 
 - Sam Stephenson
@@ -16,7 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-10-21 00:00:00 -05:00
+date: 2010-10-22 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency