shoulder-specs-doc/src/main/asciidoc/ref/language.adoc

= 国际化开发规范-附录

== 国际化语言标识表 footnote:[全球各国语言代码缩写与国家对照表, https://zh.wikipedia.org/wiki/ISO_639-1%E4%BB%A3%E7%A0%81%E8%A1%A8,
https://cloud.tencent.com/developer/article/1365452]

每种语言代码由两个小写字母表示（由 `ISO-639` 标准定义）每个国家/地区代码由两个大写字母表示（由 `ISO-3166` 标准定义）。

[cols="1,4,2"]
.国际标准语言和地区标识表
|===
| 序号 | 语言_国家 | 语言ID

| 1 | 南非荷兰语 | af
| 2 | 阿拉伯语（阿拉伯联合酋长国） | ar_AE
| 3 | 阿拉伯语（巴林） | ar_BH
| 4 | 阿拉伯语（阿尔及利亚） | ar_DZ
| 5 | 阿拉伯语（埃及） | ar_EG
| 6 | 阿拉伯语（伊拉克） | ar_IQ
| 7 | 阿拉伯语（约旦） | ar_JO
| 8 | 阿拉伯语（科威特） | ar_KW
| 9 | 阿拉伯语（黎巴嫩） | ar_LB
| 10 | 阿拉伯语（利比亚） | ar_LY
| 11 | 阿拉伯语（摩洛哥） | ar_MA
| 12 | 阿拉伯语（阿曼） | ar_OM
| 13 | 阿拉伯语（卡塔尔） | ar_QA
| 14 | 阿拉伯语（沙特阿拉伯） | ar_SA
| 15 | 阿拉伯语（叙利亚） | ar_SY
| 16 | 阿拉伯语（突尼斯） | ar_TN
| 17 | 阿拉伯语（也门） | ar_YE
| 18 | 贝劳语 | be
| 19 | 保加利亚语 | bg
| 20 | 加泰罗尼亚语 | ca
| 21 | 捷克语 | cs
| 22 | 丹麦语 | da
| 23 | 德语（标准） | de
| 24 | 德语（奥地利） | de_AT
| 25 | 德语（瑞士） | de_CH
| 26 | 德语（列支敦士登） | de_LI
| 27 | 德语（卢森堡） | de_LU
| 28 | 希腊语 | el
| 29 | 英语 | en
| 30 | 英语（加勒比） | en
| 31 | 英语（澳大利亚） | en_AU
| 32 | 英语（伯利兹） | en_BZ
| 33 | 英语（加拿大） | en_CA
| 34 | 英语（英国） | en_GB
| 35 | 英语（爱尔兰） | en_IE
| 36 | 英语（牙买加） | en_JM
| 37 | 英语（新西兰） | en_NZ
| 38 | 英语（特立尼达） | en_TT
| 39 | 英语（美国） | en_US
| 40 | 英语（南非） | en_ZA
| 41 | 西班牙语（西班牙传统） | es
| 42 | 西班牙语（西班牙现代） | es
| 43 | 西班牙语（阿根廷） | es_AR
| 44 | 西班牙语（玻利维亚） | es_BO
| 45 | 西班牙语（智利） | es_CL
| 46 | 西班牙语（哥伦比亚） | es_CO
| 47 | 西班牙语（哥斯达黎加） | es_CR
| 48 | 西班牙语（多米尼加共和国） | es_DO
| 49 | 西班牙语（厄瓜多尔） | es_EC
| 50 | 西班牙语（危地马拉） | es_GT
| 51 | 西班牙语（洪都拉斯） | es_HN
| 52 | 西班牙语（墨西哥） | es_MX
| 53 | 西班牙语（尼加拉瓜） | es_NI
| 54 | 西班牙语（巴拿马） | es_PA
| 55 | 西班牙语（秘鲁） | es_PE
| 56 | 西班牙语（波多黎各） | es_PR
| 57 | 西班牙语（巴拉圭） | es_PY
| 58 | 西班牙语（萨尔瓦多） | es_SV
| 59 | 西班牙语（乌拉圭） | es_UY
| 60 | 西班牙语（委内瑞拉） | es_VE
| 61 | 爱沙尼亚语 | et
| 62 | 巴斯克语 | eu
| 63 | 波斯语 | fa
| 64 | 芬兰语 | fi
| 65 | 法罗语 | fo
| 66 | 法语（标准） | fr
| 67 | 法语（比利时） | fr_BE
| 68 | 法语（加拿大） | fr_CA
| 69 | 法语（瑞士） | fr_CH
| 70 | 法语（卢森堡） | fr_LU
| 71 | 盖尔语（苏格兰） | gd
| 72 | 盖尔语（爱尔兰） | gd_IE
| 73 | 希伯来语 | he
| 74 | 北印度语 | hi
| 75 | 克罗地亚语 | hr
| 76 | 匈牙利语 | hu
| 77 | 印度尼西亚语 | in
| 78 | 冰岛语 | is
| 79 | 意大利语（标准） | it
| 80 | 意大利语（瑞士） | it_CH
| 81 | 日语 | ja
| 82 | 依地语 | ji
| 83 | 朝鲜语 | ko
| 84 | 朝鲜语（韩国） | ko
| 85 | 立陶宛语 | lt
| 86 | 拉脱维亚语 | lv
| 87 | FYRO | mk
| 88 | 马来西亚语 | ms
| 89 | 马耳他语 | mt
| 90 | 荷兰语（标准） | nl
| 91 | 荷兰语（比利时） | nl_BE
| 92 | 挪威语（博克马尔） | no
| 93 | 挪威语（尼诺斯克） | no
| 94 | 波兰语 | pl
| 95 | 葡萄牙语（葡萄牙） | pt
| 96 | 葡萄牙语（巴西） | pt_BR
| 97 | 拉丁语系 | rm
| 98 | 罗马尼亚语 | ro
| 99 | 罗马尼亚语（摩尔达维亚） | ro_MO
| 100 | 俄语 | ru
| 101 | 俄语（摩尔达维亚） | ru_MO
| 102 | 索布语 | sb
| 103 | 斯洛伐克语 | sk
| 104 | 斯洛文尼亚语 | sl
| 105 | 阿尔巴尼亚语 | sq
| 106 | 塞尔维亚语（拉丁） | sr
| 107 | 塞尔维亚语（西里尔） | sr
| 108 | 瑞典语 | sv
| 109 | 瑞典语（芬兰） | sv_FI
| 110 | 苏图语 | sx
| 111 | 萨摩斯语（拉普兰） | sz
| 112 | 泰语 | th
| 113 | 瓦纳语 | tn
| 114 | 土耳其语 | tr
| 115 | 汤加语 | ts
| 116 | 乌克兰语 | uk
| 117 | 乌尔都语 | ur
| 118 | 文达语 | ve
| 119 | 越南语 | vi
| 120 | 科萨语 | xh
| 121 | 中文（中华人民共和国） | zh_CN
| 122 | 中文（中国香港特别行政区） | zh_HK
| 123 | 中文（新加坡） | zh_SG
| 124 | 中文（中国台湾） | zh_TW
| 125 | 祖鲁语 | zu
|===


== 当地语言标识

.当地语言标识
|===
| 中文 | 英文 | 官方语言

| 简体中文 | Simplified_Chinese | 简体中文
| 繁体中文 | Traditional_Chinese | 繁體中文
| 英语 | English | English
| 法语 | French | Français
| 德语 | German | Deutsch
| 日语 | Japanese | 日本語
| 俄语 | Russian | Русский_язык
| 丹麦语 | Danish | Dansk
| 荷兰语 | Dutch | Nederlandse
| 芬兰语 | Finnish | Suomi
| 希腊语 | Greek | Ελληνικά
| 印地语 | Hindi | हिन्दी
| 拉丁语 | Latin | Latin
| 朝鲜语/韩语 | Korean | 한국어
| 马来语 | Malay | Melayu
| 挪威语 | Norwegian | Norske
| 波兰语 | Polish | Polska
| 瑞典语 | Swedish | Svenska
| 土耳其语 | Turkish | Türkçe
| 阿拉伯语 | Arabic | ةيبرعلا
| 爱尔兰语 | Irish | Na_hÉireann
| 意大利语 | Italian | Italiano
| 越南语 | Vietnamese | Tiếng Việt
| 印尼语 | Bahasa_Indonesia | Bahasa_Indonesia
| 白俄罗斯语 | Belarusian | Беларуская
| 西班牙语 | Spanish | Español
| 波斯语 | Persian | سرافی
| 葡萄牙语 | Portuguese | Português
| 泰语 | Thai | ไทย
| 斯瓦希里语 | Swahili | Swahili
| 塞尔维亚语 | SerbianСрпски | језик
|===

== 默认编码与分割符

[cols="1,3,1"]
.各国语言习惯的字符编码与分隔符格式
|====
| 语言 | 编码 | csv 文件中的分隔符

| bg | iso-8859-5 | 分号
| cs | iso-8859-2 | 分号
| da | iso-8859-1 | 分号
| de | iso-8859-1 | 分号
| es | iso-8859-1 | 分号
| fr | iso-8859-15 | 分号
| hu | iso-8859-2 | 分号
| it | iso-8859-1 | 分号
| ja | shift-jis | 逗号
| nl | iso-8859-1 | 分号
| pl | iso-8859-2 | 分号
| pt | iso-8859-1 | 分号
| ru | iso-8859-5 | 分号
| th | iso-8859-11 | 分号
| tr | iso-8859-3 | 分号
| zh_cn | gb2312 | 逗号
| zh | gb2312 | 逗号
| zh_tw | big5 | 逗号
| ko | EUC-KR | 逗号
| fi | iso-8859-15 | 分号
| vi | Windows-1258 | 分号
| et | iso-8859-4 | 分号
| el | iso-8859-7 | 分号
| sk | iso-8859-2 | 分号
| ro | iso-8859-2 | 分号
| sv | iso-8859-10 | 分号
| nb | iso-8859-10 | 分号
| hr | iso-8859-2 | 分号
| sl | iso-8859-2 | 分号
| sr | iso-8859-2 | 分号
| lv | iso-8859-5 | 分号
| lt | iso-8859-4 | 分号
| pt-BR | iso-8859-15 | 分号
| kk | iso-8859-5 | 分号
| ky | iso-8859-5 | 分号
| ar | iso-8859-6 | 分号
| fa | iso-8859-6 | 分号
| he | iso-8859-8 | 分号
| uz | iso-8859-9 | 分号
| 其他 | utf-8 | 逗号
|====


// tag::i18nKeySpec[]

. 字符 key 必须采用 ASCII 码编写，仅可包含【数字、英文字母、下划线（`_`）、中划线（`-`）、英文句号（`.`）】，尽量避免使
用容易产生混淆的组合，如 0 和 1，两者与小写英文字母 o 和 l 。
. Key 最大长度限制为 128 位。
. 代码中只能使用字符 `Key`，展示层负责翻译显示。
. 在代码、脚本等文件中除注释外，不应存在任何的特定语言文本信息（如：中文），涉及的文件类型包含但不仅限于：.java、.js、.json、.properties、.sql、.vue、.html、.xml、.ui、.h、.cpp 等。
. 不允许用多个 `Key` 来拼接组成词或句子，语法不一定正确。
. 用于界面显示的多语言 `Key` 包含三部分组成，格式定义为 `<应用标识>.<i18nKey>.<类型标识>` 。

[cols="1,1,5", options="header"]
.类型标识
|===
| 类型 | 标识 | 说明
| 名称 | name | 名词短语，如：name、label、tab、menu、type 等。
| 句子 | msg  | 描述语句，如 msg、desc(description)、intro(introduction)、info(information)、sug(suggestion)、warn(warning) 等。
| 按钮 | button | 动词短语，如 btn(button)。
|===

// end::i18nKeySpec[]