资源说明:A simple internationalization library for easily creating multilanguage ruby program
# Simple I18n
Using this gem is very easy to add multilanguage support for small projects.
## Installation
Add this line to your application's Gemfile:
gem 'simple_i18n'
And then execute:
$ bundle
Or install it yourself as:
$ gem install simple_i18n
## Usage
First you'd create a language specification file. This file is recommended to
named as `i18nspec.rb` and put in the root directory of project.
Which shall contain the content like:
require 'simple_i18n'
SimpleI18n.load_language_file('language/en')
SimpleI18n.load_language_file('language/zh')
# ... other languages
SimpleI18n.set_default_language('en')
Where you'd create a directory names `language` too. And inside there shall be
the language translation files, right name as form of `lang-en` as above.
The language files should contain the translation tables. Fortunately they are
defined in ruby also, in the form of:
# in file `en`
define_language('en', 'English') do |en|
en['display-username'] = 'Display Username'
en['reset-password'] = 'Reset Password'
# ... others translations
end
Different translation tables should define same tokens, for example:
# in file `zh`
# -*- encoding: utf-8 -*-
define_language('zh', '中文') do |zh|
zh['display-username'] = '顯示用戶名'
zh['reset-password'] = '重置密碼'
# ... blah blah blah
end
Note the encoding specification might be required for non-ascii files.
Then you can use these in your code:
# a file in project
require '../i18nspec'
def turn_to_english
swith_language('en')
end
def turn_to_chinese
switch_language('zh')
end
def foo
tr['display-username'] #=> 'Display Username' or '顯示用戶名'
end
Via refering translations with `tr` and changing current language with
`switch_language` methods whereever you need.
If there are places that you don't understand, you can move on the
demonstration project, which is located in `demo_project` directory.
And if that doesn't help too, welcome to write to me.
## Contributing
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request
本源码包内暂不包含可直接显示的源代码文件,请下载源码包。
English
