hobo_rapid 1.4.0.pre2

data/taglibs/hobo_rapid.dryml

@@ -0,0 +1,14 @@
+<!-- This comment shouldn't appear in the cookbook -->
+
+<include src="buttons/*"/>
+<include src="cache/*"/>
+<include src="cards/*"/>
+<include src="editors/*"/>
+<include src="forms/*"/>
+<include src="html/*"/>
+<include src="i18n/*"/>
+<include src="inputs/*"/>
+<include src="lists/*"/>
+<include src="pages/*"/>
+<include src="plus/*"/>
+<include src="views/*"/>

data/taglibs/html/a.dryml

@@ -0,0 +1,156 @@
+<!--
+`<a>` is extended in Rapid to automatically provide URLs for Hobo model routes
+
+### Usage
+
+The tag behaves as a regular HTML link or anchor if either the href or name attribute is given:
+
+    <a href="/admin">Admin</a> -> Output is exactly as provided, untouched by Rapid
+
+If no href or name is given then the _context_ is used to determine the link URL.
+The helper method `object_url` is used to construct the URL using restful routing:
+
+If the context is a class then the link will be an index page:
+
+    <a with="&BlogPost">My Blog</a> -> <a href="/blog_posts">My Blog</a>
+
+If the context is a hobo model instance then the link will be a show page:
+
+    <% blog_post = BlogPost.find(1) %>
+    <a with="&blog_post">My Blog Post</a> -> <a href="/blog_posts/1">My Blog Post</a>
+
+An action can be provided for an alternative show page:
+
+    <a with="&blog_post" action="edit">Edit Post</a> -> <a href="/blog_posts/1/edit">Edit Post</a>
+
+Or a new page if the context is a class:
+
+    <a with="&BlogPost" action="new">New Blog Post</a> -> <a href="/blog_posts/new">New Blog Post</a>
+
+### Additional Features
+
+* If the constructed route does not exist then the link will not be created, but the content of the link will still be output. E.g. when `/blog_posts` does not exist (because the hobo model controller does not exist or the index action is disabled):
+
+        <a with="&BlogPost">My Blog</a> -> My Blog
+
+    when the show action `/blog_posts/:id` does not exist:
+
+        <a with="&blog_post">My Blog Post</a> -> My Blog Post
+* If no content text is provided then `<a>` will use the name method on the context to provide the text. E.g.
+
+        <a with="&blog_post"/> -> <a href="/blog_posts/1">My First Blog Post</a>`
+        <a with="&BlogPost"/> -> <a href="/blog_posts">Blog Posts</a>`
+* If `action="new"` then `<a>` will check that the current user has permission to create the object
+* Several useful classes are added automatically to the output `<a>`.
+
+### AJAX
+
+The standard AJAX form attributes are supported.  This can be used for conventional Ajax:
+
+    <a href="&refresh_path" update="results">Refresh results</a>
+
+Or it can be used with push-state to provide faster links:
+
+    <a href="somewhere/else" update="body" push-state new-title="Somewhere else">Go somewhere else.</a>
+
+In this case the entire body is being refreshed but the headers
+aren't, so will work to link between two dissimilar pages as long as
+the headers are identical.
+
+AJAX attributes are supported in both modes: in the "magic" mode where
+RAPID determines the href target or in "passthrough" where you supply
+the href or name.
+
+### Attributes
+
+The standard AJAX attributes are supported.
+
+* action:  If "new", triggers the special behaviour listed above.  Otherwise, contains the action to be performed on the context.   If neither `action` nor `method` are specified, the action will be "index" or "show", as appropriate.
+
+* to:  Use this item as the target instead of the current context.
+
+* params:  These are appended to the target as a query string after a "?".  Params are passed as a ruby hash.  Example: `params="&{id=>17, name=>'joe'}"`
+
+* query-params: if set, current query parameters are mirrored onto the link.   If true or blank, all non-ajax query parameters are used.   (`query-params`, `query-params="&true"` or `query-params=""`)  Otherwise, the specified query parameters are used.   (`query-params="page,sort,search"`)
+
+* href, name:  If either of these attributes are present, the smart features of this tag are turned off.
+
+* format: this adds ".#{format}" to the end of the url
+
+* subsite: routes the URL using the subsite
+
+* force: overrides the permission check if `action` is "new"
+
+* method: "get", "put", "post" or "delete".  "get" is the default
+
+-->
+<def tag="a" attrs="action, to, params, query-params, href, format, subsite, force"><%=
+  content = parameters.default
+
+  ajax_attrs, attributes = attributes.partition_hash(HoboRapidHelper::AJAX_ATTRS)
+  unless ajax_attrs.blank?
+    add_data_rapid!(attributes, "a", :ajax_attrs => ajax_attrs)
+  end
+
+
+  if query_params
+    if query_params==true || query_params.blank?
+      query_params = query_parameters_filtered
+    else
+      query_params = query_parameters_filtered(:only => comma_split(query_params))
+    end
+    params = query_params.merge(params || HashWithIndifferentAccess.new)
+  end
+
+  if href || attributes[:name]
+    # Regular link
+    href += "?" + params.map { |n, v| "#{n}=#{v}" }.join('&') if !params.blank?
+    element(:a, attributes.update(:href => href), content)
+  else
+    target = to || this
+
+    if target.nil?
+      Dryml.last_if = false
+      nil_view
+    elsif action == "new"
+      # Link to a new object form
+      new_record = target.new
+      new_record.set_creator(current_user)
+      href = object_url(target, "new", params._?.merge(:subsite => subsite))
+
+      if href && (force || can_create?(new_record))
+        new_class_name = if target.respond_to?(:proxy_reflection)
+                           target.proxy_association.reflection.klass.name
+                         else
+                           target.name
+                         end
+
+        add_classes!(attributes, "new-#{new_class_name.underscore}-link")
+        content = "New #{new_class_name.titleize}" if content.blank?
+        Dryml.last_if = true
+        element(:a, attributes.update(:href => href), content)
+      else
+        Dryml.last_if = false
+        ""
+      end
+    else
+      # Link to an existing object
+
+      content = name if content.blank?
+
+      href = object_url(target, action, (params || {}).merge(:subsite => subsite)) unless (action.nil? && target.try.new_record?)
+      if href.nil?
+        # This target is registered with Hobo::Routes as not linkable
+        content
+      else
+        css_class = target.try.origin_attribute || target.class.name.underscore.dasherize
+        add_classes!(attributes, "#{css_class}-link")
+
+        href.sub!(/\?|$/, ".#{format}\\0") unless format.blank?
+
+        # Set default link text if none given
+        element(:a, attributes.update(:href => href), content)
+      end
+    end
+  end
+%></def>

data/taglibs/html/aside.dryml

@@ -0,0 +1,5 @@
+<!-- A proposed HTML 5 semantic tag. Outputs `<div class="aside">` and works in the same way as `<section>` with empty content. -->
+<def tag="aside" attrs="empty">
+  <set body="&parameters.default"/>
+  <div class="aside" merge-attrs if="&!body.blank? || empty"><%= body %></div>
+</def>

data/taglibs/html/doctype.dryml

@@ -0,0 +1,39 @@
+<!-- Renders one of five HTML DOCTYPE declarations, according to the `version` attribute.
+
+### Attributes
+ - 'version' - the doctype version, must be one of:
+
+   - HTML 4.01 STRICT
+   - HTML 4.01 TRANSITIONAL
+   - XHTML 1.0 STRICT
+   - XHTML 1.0 TRANSITIONAL
+   - XHTML 1.1
+   - HTML
+   - html
+   - HTML5
+   - html5
+
+See the source for the actual output
+
+ -->
+<def tag="doctype" attrs="version"><%=raw(
+  case version.upcase
+    when "HTML 4.01 STRICT"
+      '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" ' +
+        '"http://www.w3.org/TR/html4/strict.dtd">'
+    when "HTML 4.01 TRANSITIONAL"
+      '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" ' +
+        '"http://www.w3.org/TR/html4/loose.dtd">'
+    when "XHTML 1.0 STRICT"
+      '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" ' +
+        '"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">'
+    when "XHTML 1.0 TRANSITIONAL"
+      '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" ' +
+        '"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">'
+    when "XHTML 1.1"
+      '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" ' +
+      '"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">'
+    when "HTML", "html", "HTML5", "html5"
+      '<!DOCTYPE html>'
+  end)
+%></def>

data/taglibs/html/empty_tag.dryml

@@ -0,0 +1,23 @@
+<!-- empty tags should be written as <br> in HTML and <br /> in XHTML -->
+<!-- nodoc. -->
+<def tag="empty-tag" attrs="tag-name"><%= element(tag_name, attributes, nil, true, true) %></def>
+<!-- nodoc. -->
+<def tag="base"><empty-tag tag-name="base" merge/></def>
+<!-- nodoc. -->
+<def tag="meta"><empty-tag tag-name="meta" merge/></def>
+<!-- nodoc. -->
+<def tag="link"><empty-tag tag-name="link" merge/></def>
+<!-- nodoc. -->
+<def tag="img"><empty-tag tag-name="img" merge/></def>
+<!-- nodoc. -->
+<def tag="br"><empty-tag tag-name="br" merge/></def>
+<!-- nodoc. -->
+<def tag="hr"><empty-tag tag-name="hr" merge/></def>
+<!-- nodoc. -->
+<def tag="frame"><empty-tag tag-name="frame" merge/></def>
+<!-- nodoc. -->
+<def tag="area"><empty-tag tag-name="area" merge/></def>
+<!-- nodoc. -->
+<def tag="param"><empty-tag tag-name="param" merge/></def>
+<!-- nodoc. -->
+<def tag="col"><empty-tag tag-name="col" merge/></def>

data/taglibs/html/footer.dryml

@@ -0,0 +1,5 @@
+<!-- A proposed HTML 5 semantic tag. Outputs `<div class="footer">` and works in the same way as `<section>` with empty content. -->
+<def tag="footer" attrs="empty">
+  <set body="&parameters.default"/>
+  <div class="footer" merge-attrs if="&!body.blank? || empty"><%= body %></div>
+</def>

data/taglibs/html/header.dryml

@@ -0,0 +1,5 @@
+<!-- A proposed HTML 5 semantic tag. Outputs `<div class="header">` and works in the same way as `<section>` with empty content. -->
+<def tag="header" attrs="empty">
+  <set body="&parameters.default"/>
+  <div class="header" merge-attrs if="&!body.blank? || empty"><%= body %></div>
+</def>

data/taglibs/html/html.dryml

@@ -0,0 +1,18 @@
+<!-- Standard HTML tags that have been enhanced in RAPID, as well as
+closely related tags -->
+
+
+<!-- Renders an `<html>` tag along with the DOCTYPE specified in the `doctype` attribute.
+
+### Attributes
+
+ - `doctype` - the version of the DOCTYPE required. See the `version` attribute to `<doctype>`
+ -->
+<def tag="html" attrs="doctype">
+  <% doctype ||= 'html' -%>
+  <doctype version="&doctype"/>
+  <% attributes.reverse_merge!(:xmlns => "http://www.w3.org/1999/xhtml") if doctype.upcase =~ /^XHTML/ -%>
+  <%=raw "<html#{tag_options(attributes, true)}>" %>
+    <set-scoped xmldoctype="&doctype.upcase =~ /^XHTML/"><do param="default"/></set-scoped>
+  <%=raw "</html>" %>
+</def>

data/taglibs/html/if_ie.dryml

@@ -0,0 +1,11 @@
+<!-- Renders a conditional comment in order to have some content ignored by all browsers other than Internet Explorer
+
+### Example
+
+
+    <if-ie version="lt IE 7"> ... </if-ie>
+
+ -->
+<def tag="if-ie" attrs="version">
+  <%=raw "<!--[if #{version || 'IE'}]>" %><do param="default"/><%=raw "<![endif]-->" %>
+</def>

data/taglibs/html/image.dryml

@@ -0,0 +1,11 @@
+<!--
+Provides a short hand way of displaying images.  All attributes supported by `image_tag` are supported.
+
+### Usage
+
+    <image src="hobo.png"/> -> <img src="/images/hobo.png"/>
+    <image src="blog/funny.jpg" alt="Funny Scene"/> -> <img src="/images/blog/funny.jpg" alt="Funny Scene"/>
+-->
+<def tag="image" attrs="src"><%=
+  image_tag(src, Hash[deunderscore_attributes(attributes)])
+%></def>

data/taglibs/html/javascript.dryml

@@ -0,0 +1,12 @@
+<!-- Simple wrapper for the `javascript_include_tag` helper. The `name` attribute can be a comma-separated list of script file names.
+ -->
+<def tag="javascript" attrs="name">
+  <if test="&name.is_a?(Symbol)">
+    <%= javascript_include_tag name %>
+  </if>
+  <else>
+    <repeat with="&comma_split(name)">
+      <%= javascript_include_tag this %>
+    </repeat>
+  </else>
+</def>

data/taglibs/html/section.dryml

@@ -0,0 +1,12 @@
+<!-- A proposed HTML 5 tag for representing a generic document or application section. Slightly more semantic than `<div>` for indicating document structure. For the time being, `<section>` is output as `<div class="section">`. In Hobo, `<section>` also has one other important behaviour which is different to using `<div>` directly, when the content of the section is empty, the wrapper tag will disappear. e.g.
+
+    <section>My Section</section> -> <div class="section">My Section</div>
+    <section><%# empty %></section> -> (nothing is generated)
+-->
+<def tag="section" attrs="empty, with-flash-messages">
+  <set body="&parameters.default" flash="&with_flash_messages && !scope.flash_rendered"/>
+  <div class="section #{'with-flash' if flash}" merge-attrs if="&!body.blank? || empty || flash">
+    <flash-messages if="&flash"/>
+    <%= body %>
+  </div>
+</def>

data/taglibs/html/section_group.dryml

@@ -0,0 +1,11 @@
+<!-- Used as a semantic wrapper around a group of sections and asides. CSS layouts can be provided based on this structure.
+
+### Usage
+
+    <section-group>
+      <section>My First Section</section>
+      <section>My Second Section</section>
+      <aside>My Aside</aside>
+    </section-group>
+-->
+<def tag="section-group"><div class="section-group"><div class="section-group-inner" merge-attrs param="default"></div></div></def>

data/taglibs/html/stylesheet.dryml

@@ -0,0 +1,5 @@
+<!-- Simple wrapper for the `stylesheet_link_tag` helper. The `name` attribute can be a comma-separated list of stylesheet names.
+ -->
+<def tag="stylesheet" attrs="name">
+  <%= stylesheet_link_tag *(comma_split(name) + [deunderscore_attributes(attributes)]) %>
+</def>

data/taglibs/html/table.dryml

@@ -0,0 +1,174 @@
+<!--
+`<table>` is extended in Rapid to provide a shorthand way to output a set of fields for a given collection. This is enabled using the `field` attribute (without the `field` attribute this is just the regular HTML `<table>` tag)
+
+### Usage
+
+If the context is an array of blog posts...
+
+    <table fields="name, created_at, description"/>
+
+This will output a header row containing "Name", "Created At" and "Description" followed by a row for each record in the collection. By default, the `<view/>` tag is called for each field in the row. This can be altered with the `field-tag` attribute, e.g.
+
+    <table fields="name, created_at, description" field-tag="input"/>
+
+This will use `<input/>` as the tag in each table cell instead of `<view/>`
+
+### Additional Notes
+
+* `<table>` provides parameters based on the names of the fields which can be used to further customise the output. For each field a heading parameter is provided, e.g. name-heading, created-at-heading, description-heading. These can be used to customise the headings:
+
+        <table fields="name, created_at, description">
+          <created-at-heading:>Creation Date</created-at-heading:>
+        </table>
+* Similarly, "view" parameters are provided as an additional way to customise the table cells of the table body, e.g. `name-view`, `created-at-view`, `description-view`:
+
+        <table fields="name, created_at, description">
+          <created-at-view:><view format="%d %B %Y"/></created-at-view:>
+        </table>
+* By adding an empty `control` parameter, the default control column is enable adding an edit link and delete button for each table row:
+
+        <table fields="name, created_at, description">
+          <controls:/>
+        </table>
+
+    The controls can be further customised using the "edit-link" and "delete-button" parameters:
+
+        <table fields="name, created_at, description">
+          <controls:/>
+          <delete-button: label="Nuke Me"/>
+        </table>
+
+    or by providing completely new content for the control column:
+
+        <table fields="name, created_at, description">
+          <controls:>my controls!</controls:>
+        </table>
+
+### Using table without ActiveRecord
+
+Typical usage for table is to supply the results of an ActiveRecord query as the context.   However, it is possible to supply a more generic array as the context instead.
+
+#### using the tr parameter
+
+If you use the tr parameter you can pass pretty much anything in the array, since you then are supplying the formatting for the row.  Giving:
+
+    <table with="&[1,2,3]">
+      <thead:><tr><th>Heading</th></tr></thead:>
+      <tr:><td><%= this+7 %></td></tr:>
+    </table>
+
+Produces:
+
+    <table>
+      <thead>
+        <tr><th>Heading</th></tr>
+      </thead>
+      <tbody>
+        <tr class='odd fixnum'><td>8</td></tr>
+        <tr class='even fixnum'><td>9</td></tr>
+        <tr class='odd fixnum'><td>10</td></tr>
+      </tbody>
+    </table>
+
+#### using OpenStruct
+
+If you supply an array of generic objects, you can supply method names to fields and `<table>` will produce a valid table.   The only major difference from passing ActiveRecord objects is that this mechanism will not translate table headings.
+
+If you've got a Hash, you can use OpenStruct to make the data available via methods.  Giving:
+
+    <% require 'ostruct' %>
+ {: .hidden}
+
+    <table fields="a,b" with="&[OpenStruct.new(:a => 1, :b => 2), OpenStruct.new(:a => 3, :b => 4)]">
+       <a-heading:>A</a-heading:>
+       <b-heading:>B</b-heading:>
+    </table>
+
+Produces:
+
+      <table>
+        <thead>
+          <tr class='field-heading-row'>
+            <th class='a-heading'>A</th>
+            <th class='b-heading'>B</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr class='odd open_struct'>
+            <td class='a-view'><span class='view '>1</span></td>
+            <td class='b-view'><span class='view '>2</span></td>
+          </tr>
+          <tr class='even open_struct'>
+            <td class='a-view'><span class='view '>3</span></td>
+            <td class='b-view'><span class='view '>4</span></td>
+          </tr>
+        </tbody>
+      </table>
+
+#### without the magic
+
+If you don't use either the fields attribute or the tr parameter, all processing is turned off, and your table is emitted verbatim.  Giving:
+
+    <table>
+      <thead>
+        <tr><th>a</th></tr>
+      </thead>
+      <tbody>
+        <tr><td>b</td></tr>
+      </tbody>
+    </table>
+
+Will emit the above table verbatim.
+
+Produces:
+ {: .hidden}
+
+    <table>
+      <thead>
+        <tr><th>a</th></tr>
+      </thead>
+      <tbody>
+        <tr><td>b</td></tr>
+      </tbody>
+    </table>
+ {: .hidden}
+-->
+<def tag="table" attrs="fields, field-tag, empty">
+  <if test="&!(fields || all_parameters.tr?)">
+    <%= element("table", attributes, all_parameters.default) %>
+  </if>
+  <else>
+    <% field_tag ||= "view" %>
+    <unless test="&this.empty? && !empty">
+      <%= element "table", attributes - attrs_for(:with_fields) do %>
+      <thead if="&all_parameters[:thead] || fields" param>
+        <tr param="field-heading-row">
+          <with-field-names merge-attrs="&all_attributes & attrs_for(:with_fields)">
+            <th param="#{scope.field_name}-heading"><%= this.member_class ? this.member_class.human_attribute_name(scope.field_name) : scope.field_name.to_s.titleize %></th>
+          </with-field-names>
+          <th if="&all_parameters[:controls]" class="controls"/>
+        </tr>
+      </thead>
+      <tbody param>
+        <repeat>
+          <tr param if="&can_view?"
+              class="#{scope.even_odd} #{this_type.name.underscore}" data-rapid-context="&typed_id">
+            <if test="&fields">
+              <with-fields merge-attrs="&all_attributes & attrs_for(:with_fields)" force-all>
+                <td param="#{scope.field_name.to_s.sub('?', '').gsub('.', '-')}-view"><call-tag tag="&field_tag"/></td>
+              </with-fields>
+              <td class="controls" param="controls" if="&all_parameters[:controls]">
+                <a param="edit-link" action="edit" if="&can_edit?">
+                  <t key="hobo.actions.edit_control">Edit</t>
+                </a>
+                <delete-button param/>
+              </td>
+            </if>
+          </tr>
+        </repeat>
+      </tbody>
+      <tfoot if="&all_parameters[:tfoot]" param/>
+      <% end %>
+    </unless>
+  </else>
+</def>

data/taglibs/i18n/ht.dryml

@@ -0,0 +1,48 @@
+<!--
+Wrapper around the Rails :translate helper with hobo added features.
+
+It can be used as a regular helper or as a dryml tag.
+
+### Hobo Added Features
+
+`ht` adds some conventions for easier hobo translation.
+
+1. Assumes the first part of the key to be a model name (e.g.: users.index.title -> user)
+2. Tries to translate the model by lookup for: (e.g.: user-> activerecord.models.user)
+3. Adds a default fallback to the beginning of the fallback chain by replacing the first part of the key with "hobo" and using the translated model name as additional attribute. This allows us to have default translations (e.g.: hobo.index.title: "{{model}} Index")
+
+You can also pass any other :translate option like for example :count.
+
+Is also used as a tag in the dryml-view files. The syntax is:
+
+      <ht key="my.app">My Application</ht>
+
+Will lookup the "my.app"-key for your locale and replaces the "My Application" content if found.
+
+      <ht key="my" app="Program">My Application</ht>
+
+Will look up both the "my"- and "app"-key for your locale, and replaces the "My Application" with the "my"-key contents (interpolated using the "app"-key.
+
+sample.no.yml-file:
+
+      "no":
+        my: "Mitt {{app}}"
+
+The output should be: Mitt Program
+
+Another example:
+
+    <%= ht :key=>'user.index.title', :default=>'Index'  %>
+    <ht key="user.index.title">Index</ht>
+    #=> "Index" # if "user.index.title" or "hobo.index.title" is not found
+    #=> "User Index" # with the below en.yml file
+
+    === en.yml ===
+    en:
+      hobo:
+        index:
+          title: %{model} Index
+-->
+<fakedef tag="ht">
+<!-- actually defined in translations.rb -->
+</fakedef>

data/taglibs/i18n/human_attribute_name

@@ -0,0 +1,18 @@
+<!-- Wrapper around ActiveRecord::Base.human_attribute_name.
+
+#### Attributes
+
+ - attribute - the attribute to lookup
+ - model - (optional) should be a model class or a record object (default to this)
+ - count - (optional) should be an integer
+
+ -->
+<def tag="human-attribute-name" attrs="attribute, model"><%=
+  model ||= this
+  model = model.class unless model.kind_of? Class
+  # prepare symbolized attributes for merging
+  attrs = {}
+  all_attributes.each_pair{|k,v| attrs[k.to_sym] = v}
+  model.human_attribute_name( attribute.to_sym, attrs )
+%>
+</def>

data/taglibs/i18n/human_collection_name.dryml

@@ -0,0 +1,69 @@
+<!-- Used to localize and pluralize collection names.
+A collection name is a special case of an attribute name, (indeed you should store the collection names as attribute names in the locale files), so this tag internally uses human_attribute_name to return them.
+
+With the `your` attribute and in the special case the context is a Hobo::Model::UserMixin instance it automatically embeds the `your` tag funtionality. (note: :name is added by default as an interpolable variable)
+
+### Attributes
+
+ - collection - the attribute/collection key to lookup in the `activerecord.attributes` namespace. (e.g. 'roles')
+ - count - used to pick the inflected string for the collection. It should be an integer.
+ - your - wraps the collection name in a `Your` tag
+
+### Example
+
+
+    it:
+      activerecord:
+        attributes:
+          post:
+            comments:
+              one: "Commento"
+              other: "Commenti"
+          user:
+            roles:
+              one: "Ruolo"
+              other: "Ruoli"
+      tags:
+        your:
+          roles:
+            current_user:
+              one: "Il tuo Ruolo"
+              other: "I tuoi Ruoli"
+            other_user:
+              one: "Ruolo di {{name}}"
+              other: Ruoli di {{name}}"
+
+  context is a Post instance ('your' is ignored)
+
+    <human-collection-name collection="comments" count="&user.comments.count" your/>
+    I18n.locale = :en => "Comment" or "Comments"
+    I18n.locale = :it => "Commento" or "Commenti"
+
+  context is a User instance
+
+    <human-collection-name collection="roles' count="&user.roles.count" your/>
+    I18n.locale = :en => "Your Role" or "Jim's Role" or "Your Roles" or "Jim's Roles"
+    I18n.locale = :it => "Il tuo Ruolo" or "Il Ruolo di Jim" or "I tuoi Ruoli" or "I Ruoli di Jim"
+
+  (output is the same as `<Your key="roles" count=>"&user.roles.count"/>`)
+
+    <human-collection-name collection="roles" count="&user.roles.count"/>
+    I18n.locale = :en => "Role" or "Roles"
+    I18n.locale = :it => "Ruolo" or "Ruoli"
+-->
+<def tag="human-collection-name" attrs="collection, count, your"><%
+  raise Hobo::Error, "The 'collection' attribute must be defined" if collection.blank?
+  belong_class = this.kind_of?(Class) ? this : this.class
+  raise Hobo::Error, "The context is not an ActiveRecord::Base instance or class. (this = #{this.typed_id rescue this.inspect})" unless belong_class < ActiveRecord::Base
+  # prepare symbolized attributes for merging
+  attrs = {}
+  all_attributes.each_pair{|k,v| attrs[k.to_sym] = v} -%>
+<% if your && belong_class < Hobo::Model::UserBase && this.kind_of?(Hobo::Model::UserBase) && I18n.locale == :en -%>
+    <your key="&collection" merge-attrs="&{:name=>name(:no_wrapper => true)}.merge(attrs)" capitalize>
+      <%= belong_class.human_attribute_name(collection.to_sym, attrs) %>
+    </your>
+<% else -%>
+    <%= belong_class.human_attribute_name( collection.to_sym, attrs ) %>
+<% end %>
+</def>
+

data/taglibs/i18n/i18n.dryml

@@ -0,0 +1 @@
+<!-- Rapid i18n provides tags related with the Rails-I18n project -->