i18n-inflector 1.0.0

data/docs/README

@@ -0,0 +1,101 @@
+= Simple Inflector for I18n
+
+<b>i18n-inflector version <tt>1.0.0</tt></b> (<b><tt>Aropsaid</tt></b>)
+
+
+
+* http://rubygems.org/gems/i18n-inflector
+* https://github.com/siefca/i18n-inflector/tree
+* mailto:pw@gnu.org
+
+== Description
+
+This backend module for Ruby's I18n overwrites the Simple backend
+translate method so that it will interpolate additional inflection
+tokens present in translations. These tokens may appear in *patterns*
+which are contained within <tt>@{</tt> and <tt>}</tt>
+symbols.
+
+You can choose different kinds (gender, title, person, time, author, etc.)
+of tokens to group them in a meaningful, semantical sets. That means you can
+apply Inflector to do simple inflection by a gender or a person, when some
+language requires it.
+
+To achieve similar functionality lambdas can be used but there might be
+some areas of appliance that including proc objects in translations
+is prohibited.
+
+If you have a troop of happy translators that shouldn't have the
+ability to execute any code yet you need some simple inflection
+then you can make use of this module.
+
+== Synopsis
+
+  require 'i18n-inflector'
+  i18n.translate('welcome')
+
+Detailed example:
+
+  I18n.locale = :en
+  I18n.backend.store_translations 'en', :i18n => { :inflections => {
+                                                     :gender => {
+                                                       :f => 'female',
+                                                       :m => 'male',
+                                                       :n => 'neuter',
+                                                       :default => 'n' }}}
+   
+   I18n.backend.store_translations 'en', 'welcome' => 'Dear @{f:Lady|m:Sir|n:You|All}'
+  
+   I18n.t('welcome')
+   # => "Dear You"
+   
+   I18n.t('welcome', :gender => :male)
+   # => "Dear Sir"
+   
+   I18n.t('welcome', :gender => :unknown)
+   # => "Dear All"
+   
+   I18n.t('welcome', :gender => nil)
+   # => "Dear All"
+
+See I18n::Backend::Inflector module documentation for more examples and definitions.
+
+== Requirements
+
+* i18n[https://rubygems.org/gems/i18n]
+* rake[https://rubygems.org/gems/rake]
+* rubygems[http://docs.rubygems.org/]
+
+== Download
+
+==== Source code
+
+* https://github.com/siefca/i18n-inflector/tree
+* <tt>git clone git://github.com/siefca/i18n-inflector.git</tt>
+
+==== Gem
+
+* https://rubygems.org/gems/i18n-inflector
+
+== Installation
+
+* <tt>sudo gem install i18n-inflector</tt>
+
+== More information
+
+See i18n-inflector module's documentation for more information.
+
+== License
+
+Copyright (c) 2010 by Paweł Wilk.
+
+\i18n-inflector is copyrighted software owned by Paweł Wilk (pw@gnu.org).
+You may redistribute and/or modify this software as long as you
+comply with either the terms of the LGPL (see the file {LGPL-LICENSE}[link:docs/LGPL-LICENSE.html]),
+or Ruby's license (see the file {COPYING}[link:docs/COPYING.html]).
+
+THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS
+OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE.
+

data/docs/rdoc.css

@@ -0,0 +1,20 @@
+@import "rdoc_base.css";
+
+#documentation > ul:first-of-type {
+  padding-bottom: 2em;
+  padding-top: 1.5em;
+  background-position: 20em 0%;
+  background-repeat: no-repeat;
+  }
+
+#documentation .method-description > p:first-of-type + p {
+  margin-top: 0.5em;
+}
+
+#documentation .method-description > ul {
+  margin-left: 1.2em;
+}
+
+#documentation .method-description > p + ul {
+  margin-left: 1.8em;
+}