threedaymonk-l10nizer 0.0.2 → 0.0.3

data/README.md

@@ -0,0 +1,50 @@
+L10nizer
+========
+
+Automagic _ex post facto_ localisation for Rails templates.
+
+What it does
+------------
+
+Processes all your `html.erb` templates, extracts text, replaces it with `t()` calls, and generates a YAML file of localisations.
+
+For example, given a file `app/views/things/show.html.erb` with this content:
+
+    <div class="thing">
+      <h1>Some heading</h1>
+      <p>This thing is called <%= h(@thing.name)</p>
+    </div>
+
+l10nizer will change it to:
+
+    <div class="thing">
+      <h1><%= t("things.some_heading") %></h1>
+      <p><%= t("things.this_thing_is_called_a", :a => (h(@thing.name))) %></p>
+    </div>
+
+and generate the following entries in `config/locales/l10nized.yml`:
+
+    things:
+      some_heading: Some heading
+      this_thing_is_called_a: This thing is called {{a}}
+
+You can then use `l10nized.yml` as a basis for the localisation file for your current locale, e.g. `en_GB.yml`.
+
+Usage
+-----
+
+From within a Rails application directory:
+
+    l10nizer
+
+Specifying the application path explicitly:
+
+    l10nizer /path/to/my/rails/app
+
+Limitations
+-----------
+
+* Perhaps ironically for a _localisation_ utility, l10nizer assumes that your templates are written in English or generally in ASCII, and ignores non-alphanumeric content when generating localisation keys. This could be fixed by modifying or replacing the L10nizer::KeyGenerator class.
+* L10nizer takes no position on HTML entities or escaping. You __will__ need to review the changes it makes.
+* Similarly, pluralisation is outside the scope of this application and will require attention.
+* Strings that should be single entities but which contain HTML will be broken into multiple localisation strings.

data/Rakefile

@@ -29,7 +29,7 @@ spec = Gem::Specification.new do |s|
 
   s.has_rdoc          = false
 
-  s.files             = %w(Rakefile) + Dir.glob("{bin,test,lib}/**/*")
+  s.files             = %w(Rakefile README.md) + Dir.glob("{bin,test,lib}/**/*")
   s.executables       = FileList["bin/**"].map { |f| File.basename(f) }
 
   s.require_paths     = ["lib"]

data/lib/l10nizer/node.rb

@@ -43,7 +43,7 @@ module L10nizer
 
       params = ['"' + key + '"']
       vars.each_with_index do |v, i|
-        params << %{:#{variable_name(i)} => #{v}}
+        params << %{:#{variable_name(i)} => (#{v})}
       end
 
       %{<%= t(#{params * ", "}) %>}

data/lib/l10nizer/version.rb

@@ -2,7 +2,7 @@ module L10nizer #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
     MINOR = 0
-    TINY  = 2
+    TINY  = 3
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

data/test/test_processor.rb

@@ -36,7 +36,7 @@ class ProcessorTest < Test::Unit::TestCase
     end
 
     should "pass values to t()" do
-      expected = %{<%= t("string_a_with_b", :a => 27, :b => 42) %>}
+      expected = %{<%= t("string_a_with_b", :a => (27), :b => (42)) %>}
       assert_equal expected, @l10nizer.reformed
     end
 
@@ -53,7 +53,7 @@ class ProcessorTest < Test::Unit::TestCase
     end
 
     should "pass values to t() reusing placeholder variables" do
-      expected = %{<p><%= t("string_a_with_b", :a => 27, :b => 42) %></p><p><%= t("another_a", :a => 'x') %></p>}
+      expected = %{<p><%= t("string_a_with_b", :a => (27), :b => (42)) %></p><p><%= t("another_a", :a => ('x')) %></p>}
       assert_equal expected, @l10nizer.reformed
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: threedaymonk-l10nizer
 version: !ruby/object:Gem::Version 
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors: 
 - Paul Battley
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-07-12 00:00:00 -07:00
+date: 2009-07-13 00:00:00 -07:00
 default_executable: l10nizer
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -52,6 +52,7 @@ extra_rdoc_files: []
 
 files: 
 - Rakefile
+- README.md
 - bin/l10nizer
 - test/samples
 - test/samples/input.html.erb
@@ -90,7 +91,7 @@ requirements: []
 rubyforge_project: 
 rubygems_version: 1.2.0
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: Automatically extract strings from ERB templates and replace with calls to t()
 test_files: []