Skip to content

Latest commit

 

History

History
635 lines (618 loc) · 33.1 KB

File metadata and controls

635 lines (618 loc) · 33.1 KB

Translation Guide

Help make Planify available in your language! This guide will walk you through creating a new translation.

Getting Started

Prerequisites

  • A text editor or translation tool (recommended: Poedit)
  • Basic understanding of your target language
  • Familiarity with Git (for contributing back)

Step 1: Choose Your Language Code

Find your language code from the table below. Use the format language_COUNTRY (e.g., es_ES for Spanish from Spain, pt_BR for Portuguese from Brazil).

Step 2: Create Your Translation File

  1. Copy an existing .po file (e.g., es.po) as a template
  2. Rename it to your language code (e.g., fr.po for French)
  3. Open the file in your preferred editor

Step 3: Update File Headers

Modify the header information in your .po file:

"Language: YOUR_LANGUAGE_CODE\n"
"Language-Team: YOUR_LANGUAGE_NAME\n"
"Last-Translator: Your Name <your.email@example.com>\n"

Step 4: Translate Strings

Translate each msgstr entry:

msgid "Hello"
msgstr "Hola"  # Replace with your translation

Translation Tips:

  • Keep UI elements concise
  • Maintain consistent terminology
  • Test special characters and accents
  • Consider context (buttons vs. descriptions)
  • Preserve placeholders like %s, %d

Step 5: Add to LINGUAS File

Add your language code to the LINGUAS file.

Step 6: Test Your Translation

  1. Build Planify with your translation
  2. Check for text overflow or layout issues
  3. Verify all strings are translated

Step 7: Submit Your Translation

  1. Fork the repository
  2. Add your .po file and update LINGUAS
  3. Create a pull request

Translation Tools

  • Poedit: User-friendly GUI editor
  • Lokalize: KDE translation tool
  • Text editors: VS Code, Vim, etc. with gettext plugins

Need Help?

  • Check existing translations for reference
  • Ask questions in GitHub issues
  • Join our community discussions

Language Codes Reference

Code Language
af Afrikaans
af_NA Afrikaans (Namibia)
af_ZA Afrikaans (South Africa)
ak Akan
ak_GH Akan (Ghana)
sq Albanian
sq_AL Albanian (Albania)
sq_XK Albanian (Kosovo)
sq_MK Albanian (Macedonia)
am Amharic
am_ET Amharic (Ethiopia)
ar Arabic
ar_DZ Arabic (Algeria)
ar_BH Arabic (Bahrain)
ar_TD Arabic (Chad)
ar_KM Arabic (Comoros)
ar_DJ Arabic (Djibouti)
ar_EG Arabic (Egypt)
ar_ER Arabic (Eritrea)
ar_IQ Arabic (Iraq)
ar_IL Arabic (Israel)
ar_JO Arabic (Jordan)
ar_KW Arabic (Kuwait)
ar_LB Arabic (Lebanon)
ar_LY Arabic (Libya)
ar_MR Arabic (Mauritania)
ar_MA Arabic (Morocco)
ar_OM Arabic (Oman)
ar_PS Arabic (Palestinian Territories)
ar_QA Arabic (Qatar)
ar_SA Arabic (Saudi Arabia)
ar_SO Arabic (Somalia)
ar_SS Arabic (South Sudan)
ar_SD Arabic (Sudan)
ar_SY Arabic (Syria)
ar_TN Arabic (Tunisia)
ar_AE Arabic (United Arab Emirates)
ar_EH Arabic (Western Sahara)
ar_YE Arabic (Yemen)
hy Armenian
hy_AM Armenian (Armenia)
as Assamese
as_IN Assamese (India)
az Azerbaijani
az_AZ Azerbaijani (Azerbaijan)
az_Cyrl_AZ Azerbaijani (Cyrillic, Azerbaijan)
az_Cyrl Azerbaijani (Cyrillic)
az_Latn_AZ Azerbaijani (Latin, Azerbaijan)
az_Latn Azerbaijani (Latin)
bm Bambara
bm_Latn_ML Bambara (Latin, Mali)
bm_Latn Bambara (Latin)
eu Basque
eu_ES Basque (Spain)
be Belarusian
be_BY Belarusian (Belarus)
bn Bengali
bn_BD Bengali (Bangladesh)
bn_IN Bengali (India)
bs Bosnian
bs_BA Bosnian (Bosnia & Herzegovina)
bs_Cyrl_BA Bosnian (Cyrillic, Bosnia & Herzegovina)
bs_Cyrl Bosnian (Cyrillic)
bs_Latn_BA Bosnian (Latin, Bosnia & Herzegovina)
bs_Latn Bosnian (Latin)
br Breton
br_FR Breton (France)
bg Bulgarian
bg_BG Bulgarian (Bulgaria)
my Burmese
my_MM Burmese (Myanmar (Burma))
ca Catalan
ca_AD Catalan (Andorra)
ca_FR Catalan (France)
ca_IT Catalan (Italy)
ca_ES Catalan (Spain)
zh Chinese
zh_CN Chinese (China)
zh_HK Chinese (Hong Kong SAR China)
zh_MO Chinese (Macau SAR China)
zh_Hans_CN Chinese (Simplified, China)
zh_Hans_HK Chinese (Simplified, Hong Kong SAR China)
zh_Hans_MO Chinese (Simplified, Macau SAR China)
zh_Hans_SG Chinese (Simplified, Singapore)
zh_Hans Chinese (Simplified)
zh_SG Chinese (Singapore)
zh_TW Chinese (Taiwan)
zh_Hant_HK Chinese (Traditional, Hong Kong SAR China)
zh_Hant_MO Chinese (Traditional, Macau SAR China)
zh_Hant_TW Chinese (Traditional, Taiwan)
zh_Hant Chinese (Traditional)
kw Cornish
kw_GB Cornish (United Kingdom)
hr Croatian
hr_BA Croatian (Bosnia & Herzegovina)
hr_HR Croatian (Croatia)
cs Czech
cs_CZ Czech (Czech Republic)
da Danish
da_DK Danish (Denmark)
da_GL Danish (Greenland)
nl Dutch
nl_AW Dutch (Aruba)
nl_BE Dutch (Belgium)
nl_BQ Dutch (Caribbean Netherlands)
nl_CW Dutch (Curaçao)
nl_NL Dutch (Netherlands)
nl_SX Dutch (Sint Maarten)
nl_SR Dutch (Suriname)
dz Dzongkha
dz_BT Dzongkha (Bhutan)
en English
en_AS English (American Samoa)
en_AI English (Anguilla)
en_AG English (Antigua & Barbuda)
en_AU English (Australia)
en_BS English (Bahamas)
en_BB English (Barbados)
en_BE English (Belgium)
en_BZ English (Belize)
en_BM English (Bermuda)
en_BW English (Botswana)
en_IO English (British Indian Ocean Territory)
en_VG English (British Virgin Islands)
en_CM English (Cameroon)
en_CA English (Canada)
en_KY English (Cayman Islands)
en_CX English (Christmas Island)
en_CC English (Cocos (Keeling) Islands)
en_CK English (Cook Islands)
en_DG English (Diego Garcia)
en_DM English (Dominica)
en_ER English (Eritrea)
en_FK English (Falkland Islands)
en_FJ English (Fiji)
en_GM English (Gambia)
en_GH English (Ghana)
en_GI English (Gibraltar)
en_GD English (Grenada)
en_GU English (Guam)
en_GG English (Guernsey)
en_GY English (Guyana)
en_HK English (Hong Kong SAR China)
en_IN English (India)
en_IE English (Ireland)
en_IM English (Isle of Man)
en_JM English (Jamaica)
en_JE English (Jersey)
en_KE English (Kenya)
en_KI English (Kiribati)
en_LS English (Lesotho)
en_LR English (Liberia)
en_MO English (Macau SAR China)
en_MG English (Madagascar)
en_MW English (Malawi)
en_MY English (Malaysia)
en_MT English (Malta)
en_MH English (Marshall Islands)
en_MU English (Mauritius)
en_FM English (Micronesia)
en_MS English (Montserrat)
en_NA English (Namibia)
en_NR English (Nauru)
en_NZ English (New Zealand)
en_NG English (Nigeria)
en_NU English (Niue)
en_NF English (Norfolk Island)
en_MP English (Northern Mariana Islands)
en_PK English (Pakistan)
en_PW English (Palau)
en_PG English (Papua New Guinea)
en_PH English (Philippines)
en_PN English (Pitcairn Islands)
en_PR English (Puerto Rico)
en_RW English (Rwanda)
en_WS English (Samoa)
en_SC English (Seychelles)
en_SL English (Sierra Leone)
en_SG English (Singapore)
en_SX English (Sint Maarten)
en_SB English (Solomon Islands)
en_ZA English (South Africa)
en_SS English (South Sudan)
en_SH English (St. Helena)
en_KN English (St. Kitts & Nevis)
en_LC English (St. Lucia)
en_VC English (St. Vincent & Grenadines)
en_SD English (Sudan)
en_SZ English (Swaziland)
en_TZ English (Tanzania)
en_TK English (Tokelau)
en_TO English (Tonga)
en_TT English (Trinidad & Tobago)
en_TC English (Turks & Caicos Islands)
en_TV English (Tuvalu)
en_UG English (Uganda)
en_GB English (United Kingdom)
en_US English (United States)
en_UM English (U.S. Outlying Islands)
en_VI English (U.S. Virgin Islands)
en_VU English (Vanuatu)
en_ZM English (Zambia)
en_ZW English (Zimbabwe)
eo Esperanto
et Estonian
et_EE Estonian (Estonia)
ee Ewe
ee_GH Ewe (Ghana)
ee_TG Ewe (Togo)
fo Faroese
fo_FO Faroese (Faroe Islands)
fi Finnish
fi_FI Finnish (Finland)
fr French
fr_DZ French (Algeria)
fr_BE French (Belgium)
fr_BJ French (Benin)
fr_BF French (Burkina Faso)
fr_BI French (Burundi)
fr_CM French (Cameroon)
fr_CA French (Canada)
fr_CF French (Central African Republic)
fr_TD French (Chad)
fr_KM French (Comoros)
fr_CG French (Congo - Brazzaville)
fr_CD French (Congo - Kinshasa)
fr_CI French (Côte d'Ivoire)
fr_DJ French (Djibouti)
fr_GQ French (Equatorial Guinea)
fr_FR French (France)
fr_GF French (French Guiana)
fr_PF French (French Polynesia)
fr_GA French (Gabon)
fr_GP French (Guadeloupe)
fr_GN French (Guinea)
fr_HT French (Haiti)
fr_LU French (Luxembourg)
fr_MG French (Madagascar)
fr_ML French (Mali)
fr_MQ French (Martinique)
fr_MR French (Mauritania)
fr_MU French (Mauritius)
fr_YT French (Mayotte)
fr_MC French (Monaco)
fr_MA French (Morocco)
fr_NC French (New Caledonia)
fr_NE French (Niger)
fr_RE French (Réunion)
fr_RW French (Rwanda)
fr_BL French (St. Barthélemy)
fr_MF French (St. Martin)
fr_PM French (St. Pierre & Miquelon)
fr_SN French (Senegal)
fr_SC French (Seychelles)
fr_CH French (Switzerland)
fr_SY French (Syria)
fr_TG French (Togo)
fr_TN French (Tunisia)
fr_VU French (Vanuatu)
fr_WF French (Wallis & Futuna)
ff Fulah
ff_CM Fulah (Cameroon)
ff_GN Fulah (Guinea)
ff_MR Fulah (Mauritania)
ff_SN Fulah (Senegal)
gl Galician
gl_ES Galician (Spain)
lg Ganda
lg_UG Ganda (Uganda)
ka Georgian
ka_GE Georgian (Georgia)
de German
de_AT German (Austria)
de_BE German (Belgium)
de_DE German (Germany)
de_LI German (Liechtenstein)
de_LU German (Luxembourg)
de_CH German (Switzerland)
el Greek
el_CY Greek (Cyprus)
el_GR Greek (Greece)
gu Gujarati
gu_IN Gujarati (India)
guz Gusii
guz_KE Gusii (Kenya)
ha Hausa
ha_Latn_GH Hausa (Latin, Ghana)
ha_Latn_NE Hausa (Latin, Niger)
ha_Latn_NG Hausa (Latin, Nigeria)
ha_Latn Hausa (Latin)
haw Hawaiian
haw_US Hawaiian (United States)
he Hebrew
he_IL Hebrew (Israel)
hi Hindi
hi_IN Hindi (India)
hu Hungarian
hu_HU Hungarian (Hungary)
is Icelandic
is_IS Icelandic (Iceland)
ig Igbo
ig_NG Igbo (Nigeria)
id Indonesian
id_ID Indonesian (Indonesia)
ga Irish
ga_IE Irish (Ireland)
it Italian
it_IT Italian (Italy)
it_SM Italian (San Marino)
it_CH Italian (Switzerland)
it_VA Italian (Vatican City)
ja Japanese
ja_JP Japanese (Japan)
kea Kabuverdianu
kea_CV Kabuverdianu (Cape Verde)
kab Kabyle
kab_DZ Kabyle (Algeria)
kl Kalaallisut
kl_GL Kalaallisut (Greenland)
kln Kalenjin
kln_KE Kalenjin (Kenya)
kam Kamba
kam_KE Kamba (Kenya)
kn Kannada
kn_IN Kannada (India)
kk Kazakh
kk_Cyrl_KZ Kazakh (Cyrillic, Kazakhstan)
kk_Cyrl Kazakh (Cyrillic)
km Khmer
km_KH Khmer (Cambodia)
ki Kikuyu
ki_KE Kikuyu (Kenya)
rw Kinyarwanda
rw_RW Kinyarwanda (Rwanda)
kok Konkani
kok_IN Konkani (India)
ko Korean
ko_KP Korean (North Korea)
ko_KR Korean (South Korea)
khq Koyra Chiini
khq_ML Koyra Chiini (Mali)
ses Koyraboro Senni
ses_ML Koyraboro Senni (Mali)
lag Langi
lag_TZ Langi (Tanzania)
lv Latvian
lv_LV Latvian (Latvia)
ln Lingala
ln_AO Lingala (Angola)
ln_CF Lingala (Central African Republic)
ln_CG Lingala (Congo - Brazzaville)
ln_CD Lingala (Congo - Kinshasa)
lt Lithuanian
lt_LT Lithuanian (Lithuania)
luo Luo
luo_KE Luo (Kenya)
luy Luyia
luy_KE Luyia (Kenya)
mk Macedonian
mk_MK Macedonian (Macedonia)
jmc Machame
jmc_TZ Machame (Tanzania)
kde Makonde
kde_TZ Makonde (Tanzania)
mg Malagasy
mg_MG Malagasy (Madagascar)
ms Malay
ms_BN Malay (Brunei)
ms_MY Malay (Malaysia)
ms_SG Malay (Singapore)
ml Malayalam
ml_IN Malayalam (India)
mt Maltese
mt_MT Maltese (Malta)
gv Manx
gv_IM Manx (Isle of Man)
mr Marathi
mr_IN Marathi (India)
mas Masai
mas_KE Masai (Kenya)
mas_TZ Masai (Tanzania)
mer Meru
mer_KE Meru (Kenya)
mfe Morisyen
mfe_MU Morisyen (Mauritius)
naq Nama
naq_NA Nama (Namibia)
ne Nepali
ne_IN Nepali (India)
ne_NP Nepali (Nepal)
nd North Ndebele
nd_ZW North Ndebele (Zimbabwe)
nb Norwegian Bokmål
nb_NO Norwegian Bokmål (Norway)
nb_SJ Norwegian Bokmål (Svalbard & Jan Mayen)
nn Norwegian Nynorsk
nn_NO Norwegian Nynorsk (Norway)
nyn Nyankole
nyn_UG Nyankole (Uganda)
or Oriya
or_IN Oriya (India)
om Oromo
om_ET Oromo (Ethiopia)
om_KE Oromo (Kenya)
ps Pashto
ps_AF Pashto (Afghanistan)
fa Persian
fa_AF Persian (Afghanistan)
fa_IR Persian (Iran)
pl Polish
pl_PL Polish (Poland)
pt Portuguese
pt_AO Portuguese (Angola)
pt_BR Portuguese (Brazil)
pt_CV Portuguese (Cape Verde)
pt_GW Portuguese (Guinea-Bissau)
pt_MO Portuguese (Macau SAR China)
pt_MZ Portuguese (Mozambique)
pt_PT Portuguese (Portugal)
pt_ST Portuguese (São Tomé & Príncipe)
pt_TL Portuguese (Timor-Leste)
pa Punjabi
pa_Arab_PK Punjabi (Arabic, Pakistan)
pa_Arab Punjabi (Arabic)
pa_Guru_IN Punjabi (Gurmukhi, India)
pa_Guru Punjabi (Gurmukhi)
ro Romanian
ro_MD Romanian (Moldova)
ro_RO Romanian (Romania)
rm Romansh
rm_CH Romansh (Switzerland)
rof Rombo
rof_TZ Rombo (Tanzania)
ru Russian
ru_BY Russian (Belarus)
ru_KZ Russian (Kazakhstan)
ru_KG Russian (Kyrgyzstan)
ru_MD Russian (Moldova)
ru_RU Russian (Russia)
ru_UA Russian (Ukraine)
rwk Rwa
rwk_TZ Rwa (Tanzania)
saq Samburu
saq_KE Samburu (Kenya)
sg Sango
sg_CF Sango (Central African Republic)
seh Sena
seh_MZ Sena (Mozambique)
sr Serbian
sr_BA Serbian (Bosnia & Herzegovina)
sr_Cyrl_BA Serbian (Cyrillic, Bosnia & Herzegovina)
sr_Cyrl_ME Serbian (Cyrillic, Montenegro)
sr_Cyrl_RS Serbian (Cyrillic, Serbia)
sr_Cyrl Serbian (Cyrillic)
sr_Latn_BA Serbian (Latin, Bosnia & Herzegovina)
sr_Latn_ME Serbian (Latin, Montenegro)
sr_Latn_RS Serbian (Latin, Serbia)
sr_Latn Serbian (Latin)
sr_ME Serbian (Montenegro)
sr_RS Serbian (Serbia)
sn Shona
sn_ZW Shona (Zimbabwe)
ii Sichuan Yi
ii_CN Sichuan Yi (China)
si Sinhala
si_LK Sinhala (Sri Lanka)
sk Slovak
sk_SK Slovak (Slovakia)
sl Slovenian
sl_SI Slovenian (Slovenia)
xog Soga
xog_UG Soga (Uganda)
so Somali
so_DJ Somali (Djibouti)
so_ET Somali (Ethiopia)
so_KE Somali (Kenya)
so_SO Somali (Somalia)
es Spanish
es_AR Spanish (Argentina)
es_BO Spanish (Bolivia)
es_CL Spanish (Chile)
es_CO Spanish (Colombia)
es_CR Spanish (Costa Rica)
es_CU Spanish (Cuba)
es_DO Spanish (Dominican Republic)
es_EC Spanish (Ecuador)
es_SV Spanish (El Salvador)
es_GQ Spanish (Equatorial Guinea)
es_GT Spanish (Guatemala)
es_HN Spanish (Honduras)
es_419 Spanish (Latin America)
es_MX Spanish (Mexico)
es_NI Spanish (Nicaragua)
es_PA Spanish (Panama)
es_PY Spanish (Paraguay)
es_PE Spanish (Peru)
es_PR Spanish (Puerto Rico)
es_ES Spanish (Spain)
es_US Spanish (United States)
es_UY Spanish (Uruguay)
es_VE Spanish (Venezuela)
sw Swahili
sw_KE Swahili (Kenya)
sw_TZ Swahili (Tanzania)
sw_UG Swahili (Uganda)
sv Swedish
sv_AX Swedish (Åland Islands)
sv_FI Swedish (Finland)
sv_SE Swedish (Sweden)
gsw Swiss German
gsw_CH Swiss German (Switzerland)
gsw_LI Swiss German (Liechtenstein)
shi Tachelhit
shi_Latn_MA Tachelhit (Latin, Morocco)
shi_Latn Tachelhit (Latin)
shi_Tfng_MA Tachelhit (Tifinagh, Morocco)
shi_Tfng Tachelhit (Tifinagh)
dav Taita
dav_KE Taita (Kenya)
ta Tamil
ta_IN Tamil (India)
ta_MY Tamil (Malaysia)
ta_SG Tamil (Singapore)
ta_LK Tamil (Sri Lanka)
te Telugu
te_IN Telugu (India)
teo Teso
teo_KE Teso (Kenya)
teo_UG Teso (Uganda)
th Thai
th_TH Thai (Thailand)
bo Tibetan
bo_CN Tibetan (China)
bo_IN Tibetan (India)
ti Tigrinya
ti_ER Tigrinya (Eritrea)
ti_ET Tigrinya (Ethiopia)
to Tongan
to_TO Tongan (Tonga)
tr Turkish
tr_CY Turkish (Cyprus)
tr_TR Turkish (Turkey)
uk Ukrainian
uk_UA Ukrainian (Ukraine)
ur Urdu
ur_IN Urdu (India)
ur_PK Urdu (Pakistan)
uz Uzbek
uz_Arab_AF Uzbek (Arabic, Afghanistan)
uz_Arab Uzbek (Arabic)
uz_Cyrl_UZ Uzbek (Cyrillic, Uzbekistan)
uz_Cyrl Uzbek (Cyrillic)
uz_Latn_UZ Uzbek (Latin, Uzbekistan)
uz_Latn Uzbek (Latin)
vi Vietnamese
vi_VN Vietnamese (Vietnam)
vun Vunjo
vun_TZ Vunjo (Tanzania)
cy Welsh
cy_GB Welsh (United Kingdom)
yo Yoruba
yo_BJ Yoruba (Benin)
yo_NG Yoruba (Nigeria)
zu Zulu
zu_ZA Zulu (South Africa)