rails-template-inheritance 0.0.1 → 0.0.2

data/.gitignore

@@ -0,0 +1 @@
+/*.gem

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "examples"]
+	path = examples
+	url = git://github.com/botanicus/rango-in-rails.git

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2009 Jakub Šťastný aka Botanicus
+Copyright (c) 2009 – 2010 Jakub Šťastný aka Botanicus
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.textile

@@ -1,10 +1,58 @@
 h1. About
 
+This Rails plugin provides *template inheritance* from "Rango":http://github.com/botanicus/rango for Rails, so you can just install it and enjoy advantages of template inheritance without any framework switching.
+
+Please note that this plugin works just with *Ruby 1.9.1 and higher*!
+
+See an "example application":http://github.com/botanicus/rango-in-rails
+
 h2. Template Inheritance
 
+"Template inheritance":http://wiki.github.com/botanicus/rango/template-inheritance is incredibly simple, powerful and flexible way how to handle layout/template. You usually needs more levels of layouting and you can do it very easily with template inheritance. You can have i. e. @app/views/admin/posts/show.html.haml@ with post-specific stuff, then @app/views/admin/base.html.haml@ with administration-specific layout and then @app/views/base.html.haml@ with the most generic layout.
+
+See also "explanation at DjangoProject.com":http://docs.djangoproject.com/en/dev/topics/templates/#template-inheritance
+
 h2. Rango
 
+"Rango":http://github.com/botanicus/rango is a light-weight web framework suitable for both smaller web services and bigger sites. It's builded on top of Rack and it has very flexible and modular architecture. So modular that we can even use it in Rails as a drop-in replacement for Rails rendering layer.
+
+- "Rango Wiki":http://wiki.github.com/botanicus/rango
+- "Rango Introduction from Ruby Manor 2009":http://www.slideshare.net/botanicus/rango
+
+h2. Template Adapters
+
+Thanks to "Tilt":http://github.com/rtomayko/tilt you can use Erubis or Haml, just by using the proper extension. Tilt itself supports much more, however Rango currently support just these two engines. Some engines won't be supported just because they don't support Ruby code in templates (Mustache and Liquid) etc.
+
 h1. Usage
 
-# As a plugin: @./script/plugin install git://github.com/botanicus/rails-template-inheritance.git@
-# As a gem:
+h2. As a Plugin
+
+@./script/plugin install git://github.com/botanicus/rails-template-inheritance.git@
+
+h2. As a Gem
+
+Add these lines into your @config/environment.rb@:
+
+<pre>
+config.gem "tilt"
+config.gem "rango", lib: nil
+config.gem "rails-template-inheritance", lib: nil
+</pre>
+
+Now run following tasks:
+
+<pre>
+rake gems:install
+rake gems:unpack
+</pre>
+
+h2. Via "bundler":http://github.com/wycats/bundler
+
+This is definitely the best solution since plugins can't handle dependencies and Rails 2 bundling tasks are just general pain in the ass.
+
+Just put @gem "rails-template-inheritance"@ to your @Gemfile@ and run @gem bundle@ (you have to have bundler installed). Then you have to setup your @config/environment.rb@:
+
+<pre>
+require_relative "../vendor/gems/environment"
+Bundler.require_env(Rails.env)
+</pre>

data/TODO.txt

@@ -0,0 +1,2 @@
+- add examples/blog or something with more sophisticated setup, so users can see the real benefit of template inheritance
+- move examples to examples/basic and add some specs

data/lib/rails-template-inheritance.rb

@@ -6,13 +6,14 @@ end
 
 require "tilt"
 require "rango/mixins/render"
+require "action_view/helpers"
 
 # Rango setup
 Tilt.register "erb", Tilt::ErubisTemplate # extension "erb" => erubis template
 Rango.logger = Rails.logger
 
 # Rango::Template has just getter, because then it holds just one object,
-# so if you create a reference, it will just work.
+# so if you create a reference to, it will just work.
 # You can use Rango::Template.template.paths.clear.unshift(path)
 module Rango
   class Template
@@ -28,7 +29,22 @@ module ActionController
       Rango::Template.template_paths = @template.view_paths
       path = template_path.respond_to?(:path_without_format_and_extension) ? template_path.path_without_format_and_extension : template_path
       logger.info("Rendering #{path}" + (status ? " (#{status})" : '')) if logger
-      render_for_text Rango::RenderMixin.render(template_path.template_path, self, locals), status
+      render_for_text Rango::RenderMixin.render(template_path.template_path, self.scope, self.locals), status
+    end
+
+    def locals
+      @locals ||= {request: request}
+    end
+
+    def scope
+      self.dup.tap do |scope|
+        scope.extend(self.class.master_helper_module)
+        ActionView::Helpers.constants.grep(/Helper$/).each do |name|
+          helper = ActionView::Helpers.const_get(name)
+          scope.extend(helper)
+          scope.instance_variable_set(:@controller, self)
+        end
+      end
     end
   end
 end

data/rails-template-inheritance.gemspec

@@ -1,19 +1,22 @@
 #!/usr/bin/env gem build
 # encoding: utf-8
 
+require "base64"
+
 Gem::Specification.new do |s|
   s.name = "rails-template-inheritance"
-  s.version = "0.0.1"
+  s.version = "0.0.2"
   s.authors = ["Jakub Šťastný aka Botanicus"]
   s.homepage = "http://github.com/botanicus/rails-template-inheritance"
   s.summary = "Template inheritance provided by Rango in Rails!"
   s.description = "" # TODO: long description
   s.cert_chain = nil
-  s.email = ["knava.bestvinensis", "gmail.com"].join("@")
+  s.email = Base64.decode64("c3Rhc3RueUAxMDFpZGVhcy5jeg==\n")
   s.has_rdoc = true
 
   # files
-  s.files = Dir.glob("{lib,spec}/**/*") + Dir["*"]
+  s.files = `git ls-files`.split("\n")
+
   s.require_paths = ["lib"]
 
   # Ruby version

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification 
 name: rails-template-inheritance
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors: 
 - "Jakub \xC5\xA0\xC5\xA5astn\xC3\xBD aka Botanicus"
 autorequire: 
 bindir: bin
 cert_chain: 
-date: 2009-12-14 00:00:00 +00:00
+date: 2010-01-16 00:00:00 +00:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -32,7 +32,7 @@ dependencies:
         version: "0"
     version: 
 description: ""
-email: knava.bestvinensis@gmail.com
+email: stastny@101ideas.cz
 executables: []
 
 extensions: []
@@ -40,11 +40,14 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- lib/rails-template-inheritance.rb
-- init.rb
+- .gitignore
+- .gitmodules
 - LICENSE
-- rails-template-inheritance.gemspec
 - README.textile
+- TODO.txt
+- init.rb
+- lib/rails-template-inheritance.rb
+- rails-template-inheritance.gemspec
 has_rdoc: true
 homepage: http://github.com/botanicus/rails-template-inheritance
 licenses: []