Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cgwalters/iso-codes

Copy of iso-codes git
https://github.com/cgwalters/iso-codes

Last synced: 1 day ago
JSON representation

Copy of iso-codes git

Awesome Lists containing this project

README 

        
iso-codes

=========



This package provides lists of various ISO standards (e.g. country,

language, language scripts, and currency names) in one place, rather

than repeated in many programs throughout the system.



Currently there are lists of languages and countries embedded in

several different programs, which leads to dozens of lists of

200 languages, translated into more than 30 languages ... not

very efficient.



With this package, we create a single "gettext domain" for every

supported ISO standard which contains the translations of

that domain. It is easy for a programmer to re-use those

translations instead of maintaining their own translation

infrastructure. Moreover, the programmer does not need to follow

changes in the ISO standard and will not work with outdated

information.



To use this translation infrastructure, the programmer just needs

to call dgettext() in their program.



Example:

    dgettext("iso_639", "French")

will return the translation for "French", depending on the

current locale.



Furthermore, this package provides the ISO standards as XML files

to be used by other applications as well. All those XML files

are stored in the directory "/usr/share/xml/iso-codes".



NEWS: iso_3166.tab and iso_639.tab removed

==========================================



Please note that the plain text tabular files "iso_3166.tab" and

"iso_639.tab" have been removed from the directory /usr/share/iso-codes.

If you need that specific format, you can easily regenerate those

files. Install the package isoquery and run the following commands:



$ isoquery | cut -f 1,4 | sort > iso_3166.tab



$ isoquery --iso=639 | \

  sed -e "s/\t\t/\tXX\t/" | \

  awk -F"\t" '{print $2"\t"$1"\t"$3"\t"$4}' | \

  sort > iso_639.tab



See the output of "isoquery --help" or "man isoquery" for more

information and usage examples.



ISO 3166

========



This lists the 2-letter country code and "short" country name. The

official ISO 3166 maintenance agency is ISO. The gettext domain is

"iso_3166".



ISO 639

=======



This lists the 2-letter and 3-letter language codes and language

names. The official ISO 639 maintenance agency is the Library of

Congress. The gettext domain is "iso_639".



ISO 639-3

=========



This is a further development of ISO 639-2, see above. All codes

of ISO 639-2 are included in ISO 639-3. ISO 639-3 attempts to

provide as complete an enumeration of languages as possible,

including living, extinct, ancient, and constructed languages,

whether major or minor, written or unwritten. The gettext

domain is "iso_639_3". The official ISO 639-3 maintenance agency

is SIL International.



ISO 4217

========



This lists the currency codes and names. The official ISO 4217

maintenance agency is the British Standards Institution. The

gettext domain is "iso_4217".



ISO 15924

=========



This lists the language scripts names. The official ISO 15924

maintenance agency is the Unicode Consortium. The gettext

domain is "iso_15924".



ISO 3166-2

==========



The ISO 3166 standard includes a "Country Subdivision Code",

giving a code for the names of the principal administrative

subdivisions of the countries coded in ISO 3166. The official

ISO 3166-2 maintenance agency is ISO. The gettext domain is

"iso_3166_2".



Tracking updates to the various ISO standards

=============================================



Below is a list of websites we use to check for updates to the

standards. Please note that ISO 4217 is missing, because the BSI

does not provide a list of changes.



ISO 3166 and ISO 3166-2:

http://www.iso.org/iso/country_codes/check_what_s_new.htm

http://www.iso.org/iso/country_codes/updates_on_iso_3166.htm

http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1-semic.txt



ISO-639:

http://www.loc.gov/standards/iso639-2/php/code_changes.php



ISO 639-3:

http://www.sil.org/iso639-3/codes.asp?order=639_3&letter=%25



ISO-15924:

http://unicode.org/iso15924/codechanges.html



Adding or updating translations

===============================



You can send your translation as a bug report against the package

iso-codes to the Debian Bug Tracking System. You can either send an email

or use the tool reportbug. More details are on this website:



  



Another way to send in a translation is using the Translation

Project (TP). You can find more information about it on their

website:



  



Reporting a bug

===============



If you find a bug in iso-codes, there are several ways to contact us.



* Alioth Bug Tracking System

  

  This system can be accessed via webbrowser.



* Debian Bug Tracking System

  

  This system can be accessed via e-mail.



* Development mailing list

  

  You can subscribe or unsubscribe at this webpage:

  



Developing using pkgconfig

==========================



A pkgconfig file has been included to aid developing with this

package. You can detect the prefix where the translations have

been placed using



$ pkg-config --variable=prefix iso-codes

/usr



You can detect which gettext domains have been installed using

$ pkg-config --variable=domains iso-codes

iso_15924 iso_3166 iso_4217 iso_639 iso_3166_2 iso_639_3



-- 

Alastair McKinstry, , 2003-12-24

Christian Perrier, , 2007-09-09

Tobias Quathamer, , 2008-01-22