국제화
국제화 (Internationalization)
antd의 기본 언어는 현재 영어예요. 다른 언어를 사용하고 싶다면 아래 안내를 따라 주세요.
출처: 문서
본문
ConfigProvider
antd는 antd 로케일 텍스트를 전역으로 구성하기 위한 React 컴포넌트 ConfigProvider를 제공해요.
import { ConfigProvider } from 'antd';
import frFR from 'antd/locale/fr_FR';
return (
<ConfigProvider locale={frFR}>
<App />
</ConfigProvider>
);
전체 구성은 여기에서 볼 수 있어요: ConfigProvider.
참고: fr_FR은 파일 이름이며, 아래 표도 같은 규칙을 따라요.
현재 다음 언어가 지원돼요.
지원 언어 (Supported languages):
| Language | Filename |
|---|---|
| Arabic | ar_EG |
| Azerbaijani | az_AZ |
| Bulgarian | bg_BG |
| Bangla (Bangladesh) | bn_BD |
| Belarusian | by_BY |
| Catalan | ca_ES |
| Czech | cs_CZ |
| Danish | da_DK |
| German | de_DE |
| Greek | el_GR |
| English (United Kingdom) | en_GB |
| English | en_US |
| Spanish | es_ES |
| Spanish (United States) | es_US |
| Basque | eu_ES |
| Estonian | et_EE |
| Persian | fa_IR |
| Finnish | fi_FI |
| French (Belgium) | fr_BE |
| French (Canada) | fr_CA |
| French (France) | fr_FR |
| Irish (Ireland) | ga_IE |
| Galician (Spain) | gl_ES |
| Hebrew | he_IL |
| Hindi | hi_IN |
| Croatian | hr_HR |
| Hungarian | hu_HU |
| Armenian | hy_AM |
| Indonesian | id_ID |
| Italian | it_IT |
| Icelandic | is_IS |
| Japanese | ja_JP |
| Georgian | ka_GE |
| Kurdish (Kurmanji) | kmr_IQ |
| Kannada | kn_IN |
| Kazakh | kk_KZ |
| Khmer | km_KH |
| Korean | ko_KR |
| Lithuanian | lt_LT |
| Latvian | lv_LV |
| Macedonian | mk_MK |
| Malayalam (India) | ml_IN |
| Marathi (India) | mr_IN |
| Mongolian | mn_MN |
| Malay (Malaysia) | ms_MY |
| Burmese | my_MM |
| Norwegian | nb_NO |
| Nepali | ne_NP |
| Dutch (Belgium) | nl_BE |
| Dutch | nl_NL |
| Polish | pl_PL |
| Portuguese (Brazil) | pt_BR |
| Portuguese | pt_PT |
| Romanian | ro_RO |
| Russian | ru_RU |
| Sinhalese / Sinhala | si_LK |
| Slovak | sk_SK |
| Serbian | sr_RS |
| Slovenian | sl_SI |
| Albanian | sq_AL |
| Swedish | sv_SE |
| Tamil | ta_IN |
| Thai | th_TH |
| Turkish | tr_TR |
| Turkmen | tk_TK |
| Urdu (Pakistan) | ur_PK |
| Ukrainian | uk_UA |
| Uzbek(latn) | uz_UZ |
| Vietnamese | vi_VN |
| Chinese (Simplified) | zh_CN |
| Chinese (Traditional) | zh_HK |
| Chinese (Traditional) | zh_TW |
더 많은 사용법은 ConfigProvider를 참고하세요.
새 언어 추가하기 (Adding new language)
당신의 언어가 위 목록에 없다면, en_US 언어 팩을 기반으로 로케일 패키지를 만들어 풀 리퀘스트(PR)를 보내 주세요. 참고로 Azerbaijani 언어를 추가한 PR을 예시로 볼 수 있어요.
단계별로 진행해요.
-
antd를 Fork하고 로컬에 git clone 한 뒤feature브랜치로 전환하고, pull 해서 최신 상태인지 확인하고,feature브랜치를 기반으로 새 브랜치를 만들어 모든 작업을 그 안에서 수행해요.git clone [email protected]:<your organization>/ant-design.git cd ant-design/ git remote add upstream [email protected]:ant-design/ant-design.git git checkout -b <your new branch name> upstream/feature -
@rc-component/picker에 언어 지원을 추가해요. 예: 이것.
-
@rc-component/pagination에 언어 지원을 추가해요. 예: 이것.
-
위 내용을 포함한 새 버전이
@rc-component/picker와@rc-component/pagination에서 릴리스되기를 기다려요. -
antd의@rc-component/picker와@rc-component/pagination버전을 업데이트하고 언어에 필요한 나머지 내용을 추가해요. 예: Azerbaijani PR. -
index.test.tsx에 언어에 대한 테스트 케이스를 추가해요.
-
스냅샷을 업데이트해요. 먼저
node_modules, lock 파일(yarn.lock또는package-lock.json)을 삭제하고 재설치해야 할 수도 있어요.npm run test -- components/locale -u -
i18n 목록 docs/react/i18n.en-US.md와 docs/react/i18n.zh-CN.md에 언어를 추가해요.
-
CI 상태를 주시하고, 실패하면 로그를 보고 전부 통과할 때까지 변경해요.
-
이제 리뷰를 받을 준비가 됐어요.