View source for KDE Core/ISO Codes/Country Code

== Country Code ==

The required data and names are already sorted and available from Git in [https://projects.kde.org/projects/kde/kdebase/kde-runtime/repository/revisions/master/raw/l10n/entities.ods an .ods spreadsheet].

The spreadsheet contains the following fields:

{| border="1"
!Field
!Description
|-
|Entity
|Key name of Entity, unique
|-
|Status
|ISO status: Assigned, Transitional, Reserved, or FIPS
|-
|ISO 3166-1 Alpha-2
|ISO 3166-1 Alpha 2 Code
|-
|ISO 3166-1 Alpha-3
|ISO 3166-1 Alpha 3 Code
|-
|ISO 3166-1 Numeric
|ISO 3166-1 Numeric Code
|-
|FIPS-10
|FIPS-10 Code (US Government)
|-
|Convert To ISO
|Use to convert non-ISO entity into nearest ISO entity, usually for FIPS
|-
|Transition To ISO
|Use to convert Transition status ISO entity to Assigned status ISO entity
|-
|ICANN
|ICANN ccTLD Internet Domain code
|-
|ITU
|International Telecommunications Union code
|-
|WMO
|World Meteorology Organization code
|-
|IOC
|International Olympic Committee code
|-
|FIFA
|FIFA code
|-
|MARC-21
|Library of Congress MARC database code
|-
|IDD
|International Direct Dial code
|-
|Name
|Most commonly used name for entity in most natural language for, e.g. “The Bahamas” not “Bahamas, The”.  Required.
|-
|List
|Name to use when listing country to make easy to find, e.g. “Bahamas, The” not “The Bahamas”.  Required even if the same as Name as you cannot tell what form the translated Name may take.
|-
|Official
|The official name of the country, e.g. “Commonwealth of The Bahamas” not “The Bahamas”.  Only populate if different to Name.
|-
|Notes
|Any notes
|-
|KDE
|The current KDE name, use to convert po files
|-
|Klocale
|If KDE includes a locale for the entity
|}

The proposed xml format will be:

 <ENTITY key=
         status=
         convert=
         transition=
         alpha2=
         alpha3=
         numeric=
         fips10=
         icann=
         itu=
         wmo=
         ioc=
         fifa=
         marc21=
         idd=
 >
     <NAME type= lang=></NAME>
     <NOTES lang=></NOTES>
 </ENTITY>

An example entry will be:

 <ENTITY key="NEW ZEALAND"
         status=assigned
         alpha2="NZ"
         alpha3="NZL"
         numeric=554
         fips10="NZ"
         icann=".nz"
         itu="NZL"
         wmo="NZ"
         ioc="NZL"
         fifa="NZL"
         marc21="nz"
         idd="+64"
 >
     <NAME type=default lang=en_US>New Zealand</NAME>
     <NAME type=list lang=en_US>New Zealand</LIST>
 </ENTITY>

The file will be saved in:

  kde-runtime/localization/country

Steps:
# Assemble data - COMPLETED
# Review names
# Convert data to xml
# Checkout full i18n svn
# Script to copy and modify po .desktop files
# Check all po's correct, commit
# Commit xml, wait for merge, pray