@@ -31,4 +31,25 @@ which sets up a new Radius context and parser to expand tags in the "rr" namespa == Using other namespaces -If you need to render more than twice, you can change the namespace used for a particular parser and context using the <tt>rerender_with_namespace(text, namespace, options)</tt> method. \ No newline at end of file +If you need to render more than twice, you can change the namespace used for a particular parser and context using the <tt>rerender_with_namespace(text, namespace, options)</tt> method. + +== <r:rerender> + +This extension includes one tag that acts as a basic rerenderer. Sometimes the tag that contains a rerenderable tag doesn't need to do anything but call it with the correct namespace due to the fact that tags may have side-effects. For example, the example above can be + +<tt> +<r:rerender> + <rr:table_of_contents/> + +<r:h1>Foo</r:h1> + +... + +<r:h2>Bar</r:h2> + +... + +</r:rerender> +</tt> + +...as long as the <r:hx> tags add effect an instance variable of the page that's accessible to tag.globals.page. \ No newline at end of file README @@ -1,11 +1,22 @@ module RerenderText include Radiant::Taggable + + desc %{ + Use this to render the contained content twice - def rerender_text(text, options) + Usage: + <pre><code><r:rerender [prefix="rr"]>...</r:rerender></code></pre> + } + tag "rerender" do |tag| + prefix = tag.attr["prefix"] || "rr" + rerender_text_with_prefix(tag.expand, prefix) + end + + def rerender_text(text, options = {}) rerender_text_with_prefix(text, "rr", options) end - def rerender_text_with_prefix(text, prefix, options) + def rerender_text_with_prefix(text, prefix, options = {}) _context = RerenderContext.new(self, text, options) _parser = Radius::Parser.new(_context, :tag_prefix => prefix) new_text = _parser.parse(text) lib/rerender_text.rb @@ -51,6 +51,8 @@ unless String.method_defined? :to_slug end class Page + attr_reader :headers + 6.times do |i| tag "h#{i + 1}" do |tag| contents = tag.expand @@ -61,15 +63,10 @@ class Page end end - desc "Pulls out all of the headers in a page" - tag "capture_headers" do |tag| - rerender_text(tag.expand, :headers => @headers) - end - desc "Renders the page table of contents" tag "toc" do |tag| str = "<ul id='toc'>" - tag.locals.headers.each do |header| + tag.globals.page.headers.each do |header| str += %{<li><a href="##{header[:id]}">#{header[:text]}</a></li>} end str += "</ul>" @@ -85,7 +82,7 @@ describe Page, "with a more complicated rerender tag" do @page = Page.new(:title => "Test Page", :slug => "test-page", :status_id => 100, :breadcrumb => "Test Page") rerender_text = %{ -<r:capture_headers> +<r:rerender> <rr:toc/> <r:h1>Foo</r:h1> @@ -113,7 +110,7 @@ magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. -</r:capture_headers> +</r:rerender> } @page.parts << PagePart.new(:name => "body", :content => rerender_text, :filter_id => "Textile") @page.save! spec/models/page_with_rerender_text_spec.rb 709124fe3e1e779c3d74d2a31b32f4cdb59c5d3c Andrew O'Brien aobrien@monkeydrome.local http://github.com/AndrewO/rerender_text/commit/5b5c14cc05050327bc0dcfe50846e08a8bc99302 5b5c14cc05050327bc0dcfe50846e08a8bc99302 2008-03-19T13:50:59-07:00 2008-03-19T13:50:59-07:00 Added simple rerender tag. 5e75d5ea7098529fb2b8abdb2f17ddec9f06ace1 Andrew O'Brien aobrien@monkeydrome.local