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...