diff --git a/03_usage/12_i18n/01_internationalizing_games.md b/03_usage/12_i18n/01_internationalizing_games.md index 7e3a096..f2f20b6 100644 --- a/03_usage/12_i18n/01_internationalizing_games.md +++ b/03_usage/12_i18n/01_internationalizing_games.md @@ -1,10 +1,8 @@ -Internationalizing games -======================== +# Internationalizing games -Introduction ------------- +## Introduction Sería excelente que el mundo hablara solo un idioma (It would be great if the world spoke only one language). Unfortunately for @@ -26,8 +24,7 @@ Note: We will be using the official demo as an example; you can `download it from the Asset Library ( https://pandemoniumengine.org/asset-library/asset/134 )`. -Configuring the imported translation ------------------------------------- +## Configuring the imported translation Translations can get updated and re-imported when they change, but they still have to be added to the project. This is done in @@ -37,8 +34,7 @@ they still have to be added to the project. This is done in The above dialog is used to add or remove translations project-wide. -Localizing resources --------------------- +## Localizing resources It is also possible to instruct Pandemonium to use alternate versions of assets (resources) depending on the current language. The **Remaps** tab @@ -49,8 +45,7 @@ can be used for this: Select the resource to be remapped, then add some alternatives for each locale. -Converting keys to text ------------------------ +## Converting keys to text Some controls, such as `Button`, will automatically fetch a translation if their text matches a translation key. @@ -94,8 +89,7 @@ translations and convert it if found: status.set_text(tr("GAME_STATUS_" + str(status_index))) ``` -Making controls resizable --------------------------- +### Making controls resizable The same text in different languages can vary greatly in length. For this, make sure to read the tutorial on `doc_size_and_anchors`, as @@ -103,16 +97,14 @@ dynamically adjusting control sizes may help. `Container` can be useful, as well as the text wrapping options available in `Label`. -TranslationServer ------------------ +## TranslationServer Pandemonium has a server handling low-level translation management called the `TranslationServer`. Translations can be added or removed during run-time; the current language can also be changed at run-time. -Testing translations --------------------- +## Testing translations You may want to test a project's translation before releasing it. Pandemonium provides two ways to do this. @@ -136,8 +128,7 @@ supplied: pandemonium --language fr ``` -Translating the project name ----------------------------- +## Translating the project name The project name becomes the app name when exporting to different operating systems and platforms. To specify the project name in more diff --git a/03_usage/12_i18n/02_localization_using_gettext.md b/03_usage/12_i18n/02_localization_using_gettext.md index d7ef4cd..c4f6bbd 100644 --- a/03_usage/12_i18n/02_localization_using_gettext.md +++ b/03_usage/12_i18n/02_localization_using_gettext.md @@ -1,7 +1,5 @@ - -Localization using gettext -========================== +# Localization using gettext In addition to `doc_importing_translations` in CSV format, Pandemonium also supports loading translation files written in the GNU gettext @@ -13,8 +11,7 @@ Note: It's written with C projects in mind, but much of the advice also applies to Pandemonium (with the exception of `xgettext`). -Advantages ----------- +## Advantages - gettext is a standard format, which can be edited using any text editor or GUI editors such as `Poedit ( https://poedit.net/ )`. @@ -26,8 +23,7 @@ Advantages - Multiline strings are more convenient to edit in gettext files compared to CSV files. -Disadvantages -------------- +## Disadvantages - gettext is a more complex format than CSV and can be harder to grasp for people new to software localization. @@ -35,15 +31,13 @@ Disadvantages on their system. However, as Pandemonium supports using text-based message files (`.po`), translators can test their work without having to install gettext tools. -Caveats -------- +## Caveats - As Pandemonium uses its own PO file parser behind the scenes (which is more limited than the reference GNU gettext implementation), some features such as pluralization aren't supported. -Installing gettext tools ------------------------- +## Installing gettext tools The command line gettext tools are required to perform maintenance operations, such as updating message files. Therefore, it's strongly recommended to @@ -60,8 +54,7 @@ install them. - **Linux:** On most distributions, install the `gettext` package from your distribution's package manager. -Creating the PO template (POT) manually ---------------------------------------- +## Creating the PO template (POT) manually Pandemonium currently doesn't support extracting source strings using `xgettext`, so the `.pot` file must be created manually. This file can be placed anywhere @@ -87,8 +80,7 @@ the translated string. The `msgstr` value in PO template files (`.pot`) should **always** be empty. Localization will be done in the generated `.po` files instead. -Creating the PO template (POT) using pybabel --------------------------------------------- +## Creating the PO template (POT) using pybabel The Python tool pybabel has support for Pandemonium and can be used to automatically create and update the POT file from your scene files and scripts. @@ -122,8 +114,7 @@ arguments to `tr()` will be translated, as well as properties named "text" (commonly used by Control nodes) and LineEdit's "placeholder_text" property. -Creating a messages file from a PO template -------------------------------------------- +## Creating a messages file from a PO template The `msginit` command is used to turn a PO template into a messages file. For instance, to create a French localization file, use the following command @@ -139,8 +130,7 @@ as the PO template. Alternatively, you can do that graphically using Poedit, or by uploading the POT file to your web platform of choice. -Loading a messages file in Pandemonium --------------------------------- +## Loading a messages file in Pandemonium To register a messages file as a translation in a project, open the **Project Settings**, then go to the **Localization** tab. @@ -152,8 +142,7 @@ Note: See `doc_internationalizing_games` for more information on importing and testing translations in Pandemonium. -Updating message files to follow the PO template ------------------------------------------------- +## Updating message files to follow the PO template After updating the PO template, you will have to update message files so that they contain new strings, while removing strings that are no longer @@ -179,8 +168,7 @@ Note: Strings with "fuzzy" comments will **not** be read by Pandemonium until the translation is updated and the "fuzzy" comment is removed. -Checking the validity of a PO file or template ----------------------------------------------- +## Checking the validity of a PO file or template It is possible to check whether a gettext file's syntax is valid by running the command below: @@ -192,8 +180,7 @@ the command below: If there are syntax errors or warnings, they will be displayed in the console. Otherwise, `msgfmt` won't output anything. -Using binary MO files (useful for large projects only) ------------------------------------------------------- +## Using binary MO files (useful for large projects only) For large projects with several thousands of strings to translate or more, it can be worth it to use binary (compiled) MO message files instead of text-based diff --git a/03_usage/12_i18n/03_locales.md b/03_usage/12_i18n/03_locales.md index 84292eb..9371908 100644 --- a/03_usage/12_i18n/03_locales.md +++ b/03_usage/12_i18n/03_locales.md @@ -1,739 +1,375 @@ -Locales -======= +# Locales -.. Note: This list is synced with core/translation.cpp in the engine. +Note: This list is synced with core/translation.cpp in the engine. This is the list of supported locales and variants in the engine. It's based on the Unix standard locale strings: -+--------------+------------------------------------+ + | Locale | Language and Variant | -+==============+====================================+ +|--------------|------------------------------------| | aa | Afar | -+--------------+------------------------------------+ | aa_DJ | Afar (Djibouti) | -+--------------+------------------------------------+ | aa_ER | Afar (Eritrea) | -+--------------+------------------------------------+ | aa_ET | Afar (Ethiopia) | -+--------------+------------------------------------+ | af | Afrikaans | -+--------------+------------------------------------+ | af_ZA | Afrikaans (South Africa) | -+--------------+------------------------------------+ | agr_PE | Aguaruna (Peru) | -+--------------+------------------------------------+ | ak_GH | Akan (Ghana) | -+--------------+------------------------------------+ | am_ET | Amharic (Ethiopia) | -+--------------+------------------------------------+ | an_ES | Aragonese (Spain) | -+--------------+------------------------------------+ | anp_IN | Angika (India) | -+--------------+------------------------------------+ | ar | Arabic | -+--------------+------------------------------------+ | ar_AE | Arabic (United Arab Emirates) | -+--------------+------------------------------------+ | ar_BH | Arabic (Bahrain) | -+--------------+------------------------------------+ | ar_DZ | Arabic (Algeria) | -+--------------+------------------------------------+ | ar_EG | Arabic (Egypt) | -+--------------+------------------------------------+ | ar_IQ | Arabic (Iraq) | -+--------------+------------------------------------+ | ar_JO | Arabic (Jordan) | -+--------------+------------------------------------+ | ar_KW | Arabic (Kuwait) | -+--------------+------------------------------------+ | ar_LB | Arabic (Lebanon) | -+--------------+------------------------------------+ | ar_LY | Arabic (Libya) | -+--------------+------------------------------------+ | ar_MA | Arabic (Morocco) | -+--------------+------------------------------------+ | ar_OM | Arabic (Oman) | -+--------------+------------------------------------+ | ar_QA | Arabic (Qatar) | -+--------------+------------------------------------+ | ar_SA | Arabic (Saudi Arabia) | -+--------------+------------------------------------+ | ar_SD | Arabic (Sudan) | -+--------------+------------------------------------+ | ar_SS | Arabic (South Sudan) | -+--------------+------------------------------------+ | ar_SY | Arabic (Syria) | -+--------------+------------------------------------+ | ar_TN | Arabic (Tunisia) | -+--------------+------------------------------------+ | ar_YE | Arabic (Yemen) | -+--------------+------------------------------------+ | as_IN | Assamese (India) | -+--------------+------------------------------------+ | ast_ES | Asturian (Spain) | -+--------------+------------------------------------+ | ayc_PE | Southern Aymara (Peru) | -+--------------+------------------------------------+ | ay_PE | Aymara (Peru) | -+--------------+------------------------------------+ | az_AZ | Azerbaijani (Azerbaijan) | -+--------------+------------------------------------+ | be | Belarusian | -+--------------+------------------------------------+ | be_BY | Belarusian (Belarus) | -+--------------+------------------------------------+ | bem_ZM | Bemba (Zambia) | -+--------------+------------------------------------+ | ber_DZ | Berber languages (Algeria) | -+--------------+------------------------------------+ | ber_MA | Berber languages (Morocco) | -+--------------+------------------------------------+ | bg | Bulgarian | -+--------------+------------------------------------+ | bg_BG | Bulgarian (Bulgaria) | -+--------------+------------------------------------+ | bhb_IN | Bhili (India) | -+--------------+------------------------------------+ | bho_IN | Bhojpuri (India) | -+--------------+------------------------------------+ | bi_TV | Bislama (Tuvalu) | -+--------------+------------------------------------+ | bn | Bengali | -+--------------+------------------------------------+ | bn_BD | Bengali (Bangladesh) | -+--------------+------------------------------------+ | bn_IN | Bengali (India) | -+--------------+------------------------------------+ | bo | Tibetan | -+--------------+------------------------------------+ | bo_CN | Tibetan (China) | -+--------------+------------------------------------+ | bo_IN | Tibetan (India) | -+--------------+------------------------------------+ | br_FR | Breton (France) | -+--------------+------------------------------------+ | brx_IN | Bodo (India) | -+--------------+------------------------------------+ | bs_BA | Bosnian (Bosnia and Herzegovina) | -+--------------+------------------------------------+ | byn_ER | Bilin (Eritrea) | -+--------------+------------------------------------+ | ca | Catalan | -+--------------+------------------------------------+ | ca_AD | Catalan (Andorra) | -+--------------+------------------------------------+ | ca_ES | Catalan (Spain) | -+--------------+------------------------------------+ | ca_FR | Catalan (France) | -+--------------+------------------------------------+ | ca_IT | Catalan (Italy) | -+--------------+------------------------------------+ | ce_RU | Chechen (Russia) | -+--------------+------------------------------------+ | chr_US | Cherokee (United States) | -+--------------+------------------------------------+ | cmn_TW | Mandarin Chinese (Taiwan) | -+--------------+------------------------------------+ | crh_UA | Crimean Tatar (Ukraine) | -+--------------+------------------------------------+ | csb_PL | Kashubian (Poland) | -+--------------+------------------------------------+ | cs | Czech | -+--------------+------------------------------------+ | cs_CZ | Czech (Czech Republic) | -+--------------+------------------------------------+ | cv_RU | Chuvash (Russia) | -+--------------+------------------------------------+ | cy_GB | Welsh (United Kingdom) | -+--------------+------------------------------------+ | da | Danish | -+--------------+------------------------------------+ | da_DK | Danish (Denmark) | -+--------------+------------------------------------+ | de | German | -+--------------+------------------------------------+ | de_AT | German (Austria) | -+--------------+------------------------------------+ | de_BE | German (Belgium) | -+--------------+------------------------------------+ | de_CH | German (Switzerland) | -+--------------+------------------------------------+ | de_DE | German (Germany) | -+--------------+------------------------------------+ | de_IT | German (Italy) | -+--------------+------------------------------------+ | de_LU | German (Luxembourg) | -+--------------+------------------------------------+ | doi_IN | Dogri (India) | -+--------------+------------------------------------+ | dv_MV | Dhivehi (Maldives) | -+--------------+------------------------------------+ | dz_BT | Dzongkha (Bhutan) | -+--------------+------------------------------------+ | el | Greek | -+--------------+------------------------------------+ | el_CY | Greek (Cyprus) | -+--------------+------------------------------------+ | el_GR | Greek (Greece) | -+--------------+------------------------------------+ | en | English | -+--------------+------------------------------------+ | en_AG | English (Antigua and Barbuda) | -+--------------+------------------------------------+ | en_AU | English (Australia) | -+--------------+------------------------------------+ | en_BW | English (Botswana) | -+--------------+------------------------------------+ | en_CA | English (Canada) | -+--------------+------------------------------------+ | en_DK | English (Denmark) | -+--------------+------------------------------------+ | en_GB | English (United Kingdom) | -+--------------+------------------------------------+ | en_HK | English (Hong Kong) | -+--------------+------------------------------------+ | en_IE | English (Ireland) | -+--------------+------------------------------------+ | en_IL | English (Israel) | -+--------------+------------------------------------+ | en_IN | English (India) | -+--------------+------------------------------------+ | en_NG | English (Nigeria) | -+--------------+------------------------------------+ | en_NZ | English (New Zealand) | -+--------------+------------------------------------+ | en_PH | English (Philippines) | -+--------------+------------------------------------+ | en_SG | English (Singapore) | -+--------------+------------------------------------+ | en_US | English (United States) | -+--------------+------------------------------------+ | en_ZA | English (South Africa) | -+--------------+------------------------------------+ | en_ZM | English (Zambia) | -+--------------+------------------------------------+ | en_ZW | English (Zimbabwe) | -+--------------+------------------------------------+ | eo | Esperanto | -+--------------+------------------------------------+ | 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_ES | Spanish (Spain) | -+--------------+------------------------------------+ | es_GT | Spanish (Guatemala) | -+--------------+------------------------------------+ | es_HN | Spanish (Honduras) | -+--------------+------------------------------------+ | es_MX | Spanish (Mexico) | -+--------------+------------------------------------+ | es_NI | Spanish (Nicaragua) | -+--------------+------------------------------------+ | es_PA | Spanish (Panama) | -+--------------+------------------------------------+ | es_PE | Spanish (Peru) | -+--------------+------------------------------------+ | es_PR | Spanish (Puerto Rico) | -+--------------+------------------------------------+ | es_PY | Spanish (Paraguay) | -+--------------+------------------------------------+ | es_SV | Spanish (El Salvador) | -+--------------+------------------------------------+ | es_US | Spanish (United States) | -+--------------+------------------------------------+ | es_UY | Spanish (Uruguay) | -+--------------+------------------------------------+ | es_VE | Spanish (Venezuela) | -+--------------+------------------------------------+ | et | Estonian | -+--------------+------------------------------------+ | et_EE | Estonian (Estonia) | -+--------------+------------------------------------+ | eu | Basque | -+--------------+------------------------------------+ | eu_ES | Basque (Spain) | -+--------------+------------------------------------+ | fa | Persian | -+--------------+------------------------------------+ | fa_IR | Persian (Iran) | -+--------------+------------------------------------+ | ff_SN | Fulah (Senegal) | -+--------------+------------------------------------+ | fi | Finnish | -+--------------+------------------------------------+ | fi_FI | Finnish (Finland) | -+--------------+------------------------------------+ | fil | Filipino | -+--------------+------------------------------------+ | fil_PH | Filipino (Philippines) | -+--------------+------------------------------------+ | fo_FO | Faroese (Faroe Islands) | -+--------------+------------------------------------+ | fr | French | -+--------------+------------------------------------+ | fr_BE | French (Belgium) | -+--------------+------------------------------------+ | fr_CA | French (Canada) | -+--------------+------------------------------------+ | fr_CH | French (Switzerland) | -+--------------+------------------------------------+ | fr_FR | French (France) | -+--------------+------------------------------------+ | fr_LU | French (Luxembourg) | -+--------------+------------------------------------+ | fur_IT | Friulian (Italy) | -+--------------+------------------------------------+ | fy_DE | Western Frisian (Germany) | -+--------------+------------------------------------+ | fy_NL | Western Frisian (Netherlands) | -+--------------+------------------------------------+ | ga | Irish | -+--------------+------------------------------------+ | ga_IE | Irish (Ireland) | -+--------------+------------------------------------+ | gd_GB | Scottish Gaelic (United Kingdom) | -+--------------+------------------------------------+ | gez_ER | Geez (Eritrea) | -+--------------+------------------------------------+ | gez_ET | Geez (Ethiopia) | -+--------------+------------------------------------+ | gl_ES | Galician (Spain) | -+--------------+------------------------------------+ | gu_IN | Gujarati (India) | -+--------------+------------------------------------+ | gv_GB | Manx (United Kingdom) | -+--------------+------------------------------------+ | hak_TW | Hakka Chinese (Taiwan) | -+--------------+------------------------------------+ | ha_NG | Hausa (Nigeria) | -+--------------+------------------------------------+ | he | Hebrew | -+--------------+------------------------------------+ | he_IL | Hebrew (Israel) | -+--------------+------------------------------------+ | hi | Hindi | -+--------------+------------------------------------+ | hi_IN | Hindi (India) | -+--------------+------------------------------------+ | hne_IN | Chhattisgarhi (India) | -+--------------+------------------------------------+ | hr | Croatian | -+--------------+------------------------------------+ | hr_HR | Croatian (Croatia) | -+--------------+------------------------------------+ | hsb_DE | Upper Sorbian (Germany) | -+--------------+------------------------------------+ | ht_HT | Haitian (Haiti) | -+--------------+------------------------------------+ | hu | Hungarian | -+--------------+------------------------------------+ | hu_HU | Hungarian (Hungary) | -+--------------+------------------------------------+ | hus_MX | Huastec (Mexico) | -+--------------+------------------------------------+ | hy_AM | Armenian (Armenia) | -+--------------+------------------------------------+ | ia_FR | Interlingua (France) | -+--------------+------------------------------------+ | id | Indonesian | -+--------------+------------------------------------+ | id_ID | Indonesian (Indonesia) | -+--------------+------------------------------------+ | ig_NG | Igbo (Nigeria) | -+--------------+------------------------------------+ | ik_CA | Inupiaq (Canada) | -+--------------+------------------------------------+ | is | Icelandic | -+--------------+------------------------------------+ | is_IS | Icelandic (Iceland) | -+--------------+------------------------------------+ | it | Italian | -+--------------+------------------------------------+ | it_CH | Italian (Switzerland) | -+--------------+------------------------------------+ | it_IT | Italian (Italy) | -+--------------+------------------------------------+ | iu_CA | Inuktitut (Canada) | -+--------------+------------------------------------+ | ja | Japanese | -+--------------+------------------------------------+ | ja_JP | Japanese (Japan) | -+--------------+------------------------------------+ | kab_DZ | Kabyle (Algeria) | -+--------------+------------------------------------+ | ka | Georgian | -+--------------+------------------------------------+ | ka_GE | Georgian (Georgia) | -+--------------+------------------------------------+ | kk_KZ | Kazakh (Kazakhstan) | -+--------------+------------------------------------+ | kl_GL | Kalaallisut (Greenland) | -+--------------+------------------------------------+ | km_KH | Central Khmer (Cambodia) | -+--------------+------------------------------------+ | kn_IN | Kannada (India) | -+--------------+------------------------------------+ | kok_IN | Konkani (India) | -+--------------+------------------------------------+ | ko | Korean | -+--------------+------------------------------------+ | ko_KR | Korean (South Korea) | -+--------------+------------------------------------+ | ks_IN | Kashmiri (India) | -+--------------+------------------------------------+ | ku | Kurdish | -+--------------+------------------------------------+ | ku_TR | Kurdish (Turkey) | -+--------------+------------------------------------+ | kw_GB | Cornish (United Kingdom) | -+--------------+------------------------------------+ | ky_KG | Kirghiz (Kyrgyzstan) | -+--------------+------------------------------------+ | lb_LU | Luxembourgish (Luxembourg) | -+--------------+------------------------------------+ | lg_UG | Ganda (Uganda) | -+--------------+------------------------------------+ | li_BE | Limburgan (Belgium) | -+--------------+------------------------------------+ | li_NL | Limburgan (Netherlands) | -+--------------+------------------------------------+ | lij_IT | Ligurian (Italy) | -+--------------+------------------------------------+ | ln_CD | Lingala (Congo) | -+--------------+------------------------------------+ | lo_LA | Lao (Laos) | -+--------------+------------------------------------+ | lt | Lithuanian | -+--------------+------------------------------------+ | lt_LT | Lithuanian (Lithuania) | -+--------------+------------------------------------+ | lv | Latvian | -+--------------+------------------------------------+ | lv_LV | Latvian (Latvia) | -+--------------+------------------------------------+ | lzh_TW | Literary Chinese (Taiwan) | -+--------------+------------------------------------+ | mag_IN | Magahi (India) | -+--------------+------------------------------------+ | mai_IN | Maithili (India) | -+--------------+------------------------------------+ | mg_MG | Malagasy (Madagascar) | -+--------------+------------------------------------+ | mh_MH | Marshallese (Marshall Islands) | -+--------------+------------------------------------+ | mhr_RU | Eastern Mari (Russia) | -+--------------+------------------------------------+ | mi | Maori | -+--------------+------------------------------------+ | mi_NZ | Maori (New Zealand) | -+--------------+------------------------------------+ | miq_NI | Mískito (Nicaragua) | -+--------------+------------------------------------+ | mk | Macedonian | -+--------------+------------------------------------+ | mk_MK | Macedonian (Macedonia) | -+--------------+------------------------------------+ | ml | Malayalam | -+--------------+------------------------------------+ | ml_IN | Malayalam (India) | -+--------------+------------------------------------+ | mni_IN | Manipuri (India) | -+--------------+------------------------------------+ | mn_MN | Mongolian (Mongolia) | -+--------------+------------------------------------+ | mr_IN | Marathi (India) | -+--------------+------------------------------------+ | ms | Malay | -+--------------+------------------------------------+ | ms_MY | Malay (Malaysia) | -+--------------+------------------------------------+ | mt | Maltese | -+--------------+------------------------------------+ | mt_MT | Maltese (Malta) | -+--------------+------------------------------------+ | my_MM | Burmese (Myanmar) | -+--------------+------------------------------------+ | myv_RU | Erzya (Russia) | -+--------------+------------------------------------+ | nah_MX | Nahuatl languages (Mexico) | -+--------------+------------------------------------+ | nan_TW | Min Nan Chinese (Taiwan) | -+--------------+------------------------------------+ | nb | Norwegian Bokmål | -+--------------+------------------------------------+ | nb_NO | Norwegian Bokmål (Norway) | -+--------------+------------------------------------+ | nds_DE | Low German (Germany) | -+--------------+------------------------------------+ | nds_NL | Low German (Netherlands) | -+--------------+------------------------------------+ | ne_NP | Nepali (Nepal) | -+--------------+------------------------------------+ | nhn_MX | Central Nahuatl (Mexico) | -+--------------+------------------------------------+ | niu_NU | Niuean (Niue) | -+--------------+------------------------------------+ | niu_NZ | Niuean (New Zealand) | -+--------------+------------------------------------+ | nl | Dutch | -+--------------+------------------------------------+ | nl_AW | Dutch (Aruba) | -+--------------+------------------------------------+ | nl_BE | Dutch (Belgium) | -+--------------+------------------------------------+ | nl_NL | Dutch (Netherlands) | -+--------------+------------------------------------+ | nn | Norwegian Nynorsk | -+--------------+------------------------------------+ | nn_NO | Norwegian Nynorsk (Norway) | -+--------------+------------------------------------+ | nr_ZA | South Ndebele (South Africa) | -+--------------+------------------------------------+ | nso_ZA | Pedi (South Africa) | -+--------------+------------------------------------+ | oc_FR | Occitan (France) | -+--------------+------------------------------------+ | om | Oromo | -+--------------+------------------------------------+ | om_ET | Oromo (Ethiopia) | -+--------------+------------------------------------+ | om_KE | Oromo (Kenya) | -+--------------+------------------------------------+ | or_IN | Oriya (India) | -+--------------+------------------------------------+ | os_RU | Ossetian (Russia) | -+--------------+------------------------------------+ | pa_IN | Panjabi (India) | -+--------------+------------------------------------+ | pa_PK | Panjabi (Pakistan) | -+--------------+------------------------------------+ | pap | Papiamento | -+--------------+------------------------------------+ | pap_AN | Papiamento (Netherlands Antilles) | -+--------------+------------------------------------+ | pap_AW | Papiamento (Aruba) | -+--------------+------------------------------------+ | pap_CW | Papiamento (Curaçao) | -+--------------+------------------------------------+ | pl | Polish | -+--------------+------------------------------------+ | pl_PL | Polish (Poland) | -+--------------+------------------------------------+ | pr | Pirate | -+--------------+------------------------------------+ | ps_AF | Pushto (Afghanistan) | -+--------------+------------------------------------+ | pt | Portuguese | -+--------------+------------------------------------+ | pt_BR | Portuguese (Brazil) | -+--------------+------------------------------------+ | pt_PT | Portuguese (Portugal) | -+--------------+------------------------------------+ | quy_PE | Ayacucho Quechua (Peru) | -+--------------+------------------------------------+ | quz_PE | Cusco Quechua (Peru) | -+--------------+------------------------------------+ | raj_IN | Rajasthani (India) | -+--------------+------------------------------------+ | ro | Romanian | -+--------------+------------------------------------+ | ro_RO | Romanian (Romania) | -+--------------+------------------------------------+ | ru | Russian | -+--------------+------------------------------------+ | ru_RU | Russian (Russia) | -+--------------+------------------------------------+ | ru_UA | Russian (Ukraine) | -+--------------+------------------------------------+ | rw_RW | Kinyarwanda (Rwanda) | -+--------------+------------------------------------+ | sa_IN | Sanskrit (India) | -+--------------+------------------------------------+ | sat_IN | Santali (India) | -+--------------+------------------------------------+ | sc_IT | Sardinian (Italy) | -+--------------+------------------------------------+ | sco | Scots | -+--------------+------------------------------------+ | sd_IN | Sindhi (India) | -+--------------+------------------------------------+ | se_NO | Northern Sami (Norway) | -+--------------+------------------------------------+ | sgs_LT | Samogitian (Lithuania) | -+--------------+------------------------------------+ | shs_CA | Shuswap (Canada) | -+--------------+------------------------------------+ | sid_ET | Sidamo (Ethiopia) | -+--------------+------------------------------------+ | si | Sinhala | -+--------------+------------------------------------+ | si_LK | Sinhala (Sri Lanka) | -+--------------+------------------------------------+ | sk | Slovak | -+--------------+------------------------------------+ | sk_SK | Slovak (Slovakia) | -+--------------+------------------------------------+ | sl | Slovenian | -+--------------+------------------------------------+ | sl_SI | Slovenian (Slovenia) | -+--------------+------------------------------------+ | so | Somali | -+--------------+------------------------------------+ | so_DJ | Somali (Djibouti) | -+--------------+------------------------------------+ | so_ET | Somali (Ethiopia) | -+--------------+------------------------------------+ | so_KE | Somali (Kenya) | -+--------------+------------------------------------+ | so_SO | Somali (Somalia) | -+--------------+------------------------------------+ | son_ML | Songhai languages (Mali) | -+--------------+------------------------------------+ | sq | Albanian | -+--------------+------------------------------------+ | sq_AL | Albanian (Albania) | -+--------------+------------------------------------+ | sq_KV | Albanian (Kosovo) | -+--------------+------------------------------------+ | sq_MK | Albanian (Macedonia) | -+--------------+------------------------------------+ | sr | Serbian | -+--------------+------------------------------------+ | sr_Cyrl | Serbian (Cyrillic) | -+--------------+------------------------------------+ | sr_Latn | Serbian (Latin) | -+--------------+------------------------------------+ | sr_ME | Serbian (Montenegro) | -+--------------+------------------------------------+ | sr_RS | Serbian (Serbia) | -+--------------+------------------------------------+ | ss_ZA | Swati (South Africa) | -+--------------+------------------------------------+ | st_ZA | Southern Sotho (South Africa) | -+--------------+------------------------------------+ | sv | Swedish | -+--------------+------------------------------------+ | sv_FI | Swedish (Finland) | -+--------------+------------------------------------+ | sv_SE | Swedish (Sweden) | -+--------------+------------------------------------+ | sw_KE | Swahili (Kenya) | -+--------------+------------------------------------+ | sw_TZ | Swahili (Tanzania) | -+--------------+------------------------------------+ | szl_PL | Silesian (Poland) | -+--------------+------------------------------------+ | ta | Tamil | -+--------------+------------------------------------+ | ta_IN | Tamil (India) | -+--------------+------------------------------------+ | ta_LK | Tamil (Sri Lanka) | -+--------------+------------------------------------+ | tcy_IN | Tulu (India) | -+--------------+------------------------------------+ | te | Telugu | -+--------------+------------------------------------+ | te_IN | Telugu (India) | -+--------------+------------------------------------+ | tg_TJ | Tajik (Tajikistan) | -+--------------+------------------------------------+ | the_NP | Chitwania Tharu (Nepal) | -+--------------+------------------------------------+ | th | Thai | -+--------------+------------------------------------+ | th_TH | Thai (Thailand) | -+--------------+------------------------------------+ | ti | Tigrinya | -+--------------+------------------------------------+ | ti_ER | Tigrinya (Eritrea) | -+--------------+------------------------------------+ | ti_ET | Tigrinya (Ethiopia) | -+--------------+------------------------------------+ | tig_ER | Tigre (Eritrea) | -+--------------+------------------------------------+ | tk_TM | Turkmen (Turkmenistan) | -+--------------+------------------------------------+ | tl_PH | Tagalog (Philippines) | -+--------------+------------------------------------+ | tn_ZA | Tswana (South Africa) | -+--------------+------------------------------------+ | tr | Turkish | -+--------------+------------------------------------+ | tr_CY | Turkish (Cyprus) | -+--------------+------------------------------------+ | tr_TR | Turkish (Turkey) | -+--------------+------------------------------------+ | ts_ZA | Tsonga (South Africa) | -+--------------+------------------------------------+ | tt_RU | Tatar (Russia) | -+--------------+------------------------------------+ | ug_CN | Uighur (China) | -+--------------+------------------------------------+ | uk | Ukrainian | -+--------------+------------------------------------+ | uk_UA | Ukrainian (Ukraine) | -+--------------+------------------------------------+ | unm_US | Unami (United States) | -+--------------+------------------------------------+ | ur | Urdu | -+--------------+------------------------------------+ | ur_IN | Urdu (India) | -+--------------+------------------------------------+ | ur_PK | Urdu (Pakistan) | -+--------------+------------------------------------+ | uz | Uzbek | -+--------------+------------------------------------+ | uz_UZ | Uzbek (Uzbekistan) | -+--------------+------------------------------------+ | ve_ZA | Venda (South Africa) | -+--------------+------------------------------------+ | vi | Vietnamese | -+--------------+------------------------------------+ | vi_VN | Vietnamese (Vietnam) | -+--------------+------------------------------------+ | wa_BE | Walloon (Belgium) | -+--------------+------------------------------------+ | wae_CH | Walser (Switzerland) | -+--------------+------------------------------------+ | wal_ET | Wolaytta (Ethiopia) | -+--------------+------------------------------------+ | wo_SN | Wolof (Senegal) | -+--------------+------------------------------------+ | xh_ZA | Xhosa (South Africa) | -+--------------+------------------------------------+ | yi_US | Yiddish (United States) | -+--------------+------------------------------------+ | yo_NG | Yoruba (Nigeria) | -+--------------+------------------------------------+ | yue_HK | Yue Chinese (Hong Kong) | -+--------------+------------------------------------+ | zh | Chinese | -+--------------+------------------------------------+ | zh_CN | Chinese (China) | -+--------------+------------------------------------+ | zh_HK | Chinese (Hong Kong) | -+--------------+------------------------------------+ | zh_SG | Chinese (Singapore) | -+--------------+------------------------------------+ | zh_TW | Chinese (Taiwan) | -+--------------+------------------------------------+ | zu_ZA | Zulu (South Africa) | -+--------------+------------------------------------+ diff --git a/03_usage/13_platform/android/01_android_plugin.md b/03_usage/13_platform/android/01_android_plugin.md index 455cb4c..2e18514 100644 --- a/03_usage/13_platform/android/01_android_plugin.md +++ b/03_usage/13_platform/android/01_android_plugin.md @@ -1,10 +1,8 @@ -Creating Android plugins -======================== +# Creating Android plugins -Introduction ------------- +## Introduction Android plugins are powerful tools to extend the capabilities of the Pandemonium engine by tapping into the functionality provided by the Android platform and ecosystem. @@ -29,8 +27,7 @@ and capabilities that don't belong to the core feature set of a game engine: - Posting to Facebook, Twitter, etc. - Push notifications -Android plugin --------------- +## Android plugin While introduced in Pandemonium 3.2, the Android plugin system got a significant architecture update starting with Pandemonium 3.2.2. The new plugin system is backward-incompatible with the previous one, but both systems are kept functional in future releases of the 3.2.x branch. @@ -46,8 +43,7 @@ with the following caveats: - The library must have a dependency on the Pandemonium engine library (`pandemonium-lib...aar`). A stable version is made available for each Pandemonium release on the `Pandemonium download page ( https://pandemoniumengine.org/download )`. - The library must include a specifically configured `