]> git.openstreetmap.org Git - rails.git/blob - vendor/plugins/i18n_data/README.markdown
04b8095bd8f841e3ac7f328ac989642fec38bbc8
[rails.git] / vendor / plugins / i18n_data / README.markdown
1 Problem
2 =======
3  - Present users coutries/languages in their language
4  - Convert a country/language-name to its code
5
6 Solution
7 ========
8  - A list of 2-letter-code/name pairs for all countries/languages in all languages
9  - A tool to convert a coutry/language name into 2-letter-code
10  - Write countries/language into a cache-file, and use this file for production applications languages/countries list
11
12 Containing
13 ==========
14 Translations through [pkg-isocodes](http://svn.debian.org/wsvn/pkg-isocodes/trunk/iso-codes/)  
15 185 Language codes (iso 639 - 2 letter)  
16 in 66 Languages  
17 246 Country codes (iso 3166 - 2 letter)  
18 in 85 Languages  
19
20 Usage
21 =====
22
23     sudo gem install grosser-i18n_data
24     require 'i18n_data'
25     ...
26     I18nData.languages        # {"DE"=>"German",...}
27     I18nData.languages('DE')  # {"DE"=>"Deutsch",...}
28     I18nData.languages('FR')  # {"DE"=>"Allemand",...}
29     ...
30
31     I18nData.countries        # {"DE"=>"Germany",...}
32     I18nData.countries('DE')  # {"DE"=>"Deutschland",...}
33     ...
34
35     #Not yet implemented...
36     I18nData.language_code('German')       # DE
37     I18nData.language_code('Deutsch')      # DE
38     I18nData.language_code('Allemand')     # DE
39     ..
40
41     I18nData.country_code('Germany')       # DE
42     I18nData.country_code('Deutschland')   # DE
43     ..
44
45 Data Providers
46 ==============
47  - FileDataProvider: _FAST_ (default) (loading data from cache-files)
48  - LiveDataProvider: _SLOW_ (fetching up-to-date data from svn repos)
49
50 TODO
51 ====
52  - include other language/country code formats (3-letter codes...) ?
53  
54 Author
55 ======
56 Michael Grosser  
57 grosser.michael@gmail.com  
58 Hereby placed under public domain, do what you want, just do not hold me accountable...