Merge pull request #261 from DeepLcom/table-lang-display

Add interactive language support table

Author: lilkraftwerk

docs/getting-started/supported-languages.mdx

@@ -1,312 +1,19 @@
 ---
 title: "Languages supported"
-description: "The DeepL API supports the following languages. We will update this list as we introduce new languages."
+description: "The DeepL API supports the following languages."
 public: true
+sidebarTitle: "Languages supported"
+mode: "wide"
 ---
 
-<Info>
-If trying to convert between variants of the same language (e.g. `EN-US` to `EN-GB`), please refer to [this guide](/docs/learning-how-tos/examples-and-guides/translating-between-variants).
-</Info>
-
-### Translation source languages
-
-- `ACE` - Acehnese*
-- `AF` - Afrikaans*
-- `AN` - Aragonese*
-- `AR` - Arabic
-- `AS` - Assamese*
-- `AY` - Aymara*
-- `AZ` - Azerbaijani*
-- `BA` - Bashkir*
-- `BE` - Belarusian*
-- `BG` - Bulgarian
-- `BHO` - Bhojpuri*
-- `BN` - Bengali*
-- `BR` - Breton*
-- `BS` - Bosnian*
-- `CA` - Catalan*
-- `CEB` - Cebuano*
-- `CKB` - Kurdish (Sorani)*
-- `CS` - Czech
-- `CY` - Welsh*
-- `DA` - Danish
-- `DE` - German
-- `EL` - Greek
-- `EN` - English _(all English variants)_
-- `EO` - Esperanto*
-- `ES` - Spanish _(all Spanish variants)_
-- `ET` - Estonian
-- `EU` - Basque*
-- `FA` - Persian*
-- `FI` - Finnish
-- `FR` - French
-- `GA` - Irish*
-- `GL` - Galician*
-- `GN` - Guarani*
-- `GOM` - Konkani*
-- `GU` - Gujarati*
-- `HA` - Hausa*
-- `HE` - Hebrew
-- `HI` - Hindi*
-- `HR` - Croatian*
-- `HT` - Haitian Creole*
-- `HU` - Hungarian
-- `HY` - Armenian*
-- `ID` - Indonesian
-- `IG` - Igbo*
-- `IS` - Icelandic*
-- `IT` - Italian
-- `JA` - Japanese
-- `JV` - Javanese*
-- `KA` - Georgian*
-- `KK` - Kazakh*
-- `KMR` - Kurdish (Kurmanji)*
-- `KO` - Korean
-- `KY` - Kyrgyz*
-- `LA` - Latin*
-- `LB` - Luxembourgish*
-- `LMO` - Lombard*
-- `LN` - Lingala*
-- `LT` - Lithuanian
-- `LV` - Latvian
-- `MAI` - Maithili*
-- `MG` - Malagasy*
-- `MI` - Maori*
-- `MK` - Macedonian*
-- `ML` - Malayalam*
-- `MN` - Mongolian*
-- `MR` - Marathi*
-- `MS` - Malay*
-- `MT` - Maltese*
-- `MY` - Burmese*
-- `NB` - Norwegian Bokmål
-- `NE` - Nepali*
-- `NL` - Dutch
-- `OC` - Occitan*
-- `OM` - Oromo*
-- `PA` - Punjabi*
-- `PAG` - Pangasinan*
-- `PAM` - Kapampangan*
-- `PL` - Polish
-- `PRS` - Dari*
-- `PS` - Pashto*
-- `PT` - Portuguese _(all Portuguese variants)_
-- `QU` - Quechua*
-- `RO` - Romanian
-- `RU` - Russian
-- `SA` - Sanskrit*
-- `SCN` - Sicilian*
-- `SK` - Slovak
-- `SL` - Slovenian
-- `SQ` - Albanian*
-- `SR` - Serbian*
-- `ST` - Sesotho*
-- `SU` - Sundanese*
-- `SV` - Swedish
-- `SW` - Swahili*
-- `TA` - Tamil*
-- `TE` - Telugu*
-- `TG` - Tajik*
-- `TH` - Thai
-- `TK` - Turkmen*
-- `TL` - Tagalog*
-- `TN` - Tswana*
-- `TR` - Turkish
-- `TS` - Tsonga*
-- `TT` - Tatar*
-- `UK` - Ukrainian
-- `UR` - Urdu*
-- `UZ` - Uzbek*
-- `VI` - Vietnamese
-- `WO` - Wolof*
-- `XH` - Xhosa*
-- `YI` - Yiddish*
-- `YUE` - Cantonese*
-- `ZH` - Chinese _(all Chinese variants)_
-- `ZU` - Zulu*
-
-\* These languages only work with the `quality_optimized` model or when no model is specified. They are not compatible with requests that specify the `latency_optimized` model. These languages do not support glossaries or formality.
-
-### Translation target languages
-
-- `ACE` - Acehnese*
-- `AF` - Afrikaans*
-- `AN` - Aragonese*
-- `AR` - Arabic
-- `AS` - Assamese*
-- `AY` - Aymara*
-- `AZ` - Azerbaijani*
-- `BA` - Bashkir*
-- `BE` - Belarusian*
-- `BG` - Bulgarian
-- `BHO` - Bhojpuri*
-- `BN` - Bengali*
-- `BR` - Breton*
-- `BS` - Bosnian*
-- `CA` - Catalan*
-- `CEB` - Cebuano*
-- `CKB` - Kurdish (Sorani)*
-- `CS` - Czech
-- `CY` - Welsh*
-- `DA` - Danish
-- `DE` - German
-- `EL` - Greek
-- `EN` - English _(unspecified variant for backward compatibility; we recommend using_`EN-GB` _or_ `EN-US` _instead)_
-- `EN-GB` - English (British)
-- `EN-US` - English (American)
-- `EO` - Esperanto*
-- `ES` - Spanish
-- `ES-419` - Spanish (Latin American)
-- `ET` - Estonian
-- `EU` - Basque*
-- `FA` - Persian*
-- `FI` - Finnish
-- `FR` - French
-- `GA` - Irish*
-- `GL` - Galician*
-- `GN` - Guarani*
-- `GOM` - Konkani*
-- `GU` - Gujarati*
-- `HA` - Hausa*
-- `HE` - Hebrew
-- `HI` - Hindi*
-- `HR` - Croatian*
-- `HT` - Haitian Creole*
-- `HU` - Hungarian
-- `HY` - Armenian*
-- `ID` - Indonesian
-- `IG` - Igbo*
-- `IS` - Icelandic*
-- `IT` - Italian
-- `JA` - Japanese
-- `JV` - Javanese*
-- `KA` - Georgian*
-- `KK` - Kazakh*
-- `KMR` - Kurdish (Kurmanji)*
-- `KO` - Korean
-- `KY` - Kyrgyz*
-- `LA` - Latin*
-- `LB` - Luxembourgish*
-- `LMO` - Lombard*
-- `LN` - Lingala*
-- `LT` - Lithuanian
-- `LV` - Latvian
-- `MAI` - Maithili*
-- `MG` - Malagasy*
-- `MI` - Maori*
-- `MK` - Macedonian*
-- `ML` - Malayalam*
-- `MN` - Mongolian*
-- `MR` - Marathi*
-- `MS` - Malay*
-- `MT` - Maltese*
-- `MY` - Burmese*
-- `NB` - Norwegian Bokmål
-- `NE` - Nepali*
-- `NL` - Dutch
-- `OC` - Occitan*
-- `OM` - Oromo*
-- `PA` - Punjabi*
-- `PAG` - Pangasinan*
-- `PAM` - Kapampangan*
-- `PL` - Polish
-- `PRS` - Dari*
-- `PS` - Pashto*
-- `PT` - Portuguese _(unspecified variant for backward compatibility; we recommend using_ `PT-BR` _or_ `PT-PT` _instead)_
-- `PT-BR` - Portuguese (Brazilian)
-- `PT-PT` - Portuguese _(all Portuguese variants excluding Brazilian Portuguese)_
-- `QU` - Quechua*
-- `RO` - Romanian
-- `RU` - Russian
-- `SA` - Sanskrit*
-- `SCN` - Sicilian*
-- `SK` - Slovak
-- `SL` - Slovenian
-- `SQ` - Albanian*
-- `SR` - Serbian*
-- `ST` - Sesotho*
-- `SU` - Sundanese*
-- `SV` - Swedish
-- `SW` - Swahili*
-- `TA` - Tamil*
-- `TE` - Telugu*
-- `TG` - Tajik*
-- `TH` - Thai
-- `TK` - Turkmen*
-- `TL` - Tagalog*
-- `TN` - Tswana*
-- `TR` - Turkish
-- `TS` - Tsonga*
-- `TT` - Tatar*
-- `UK` - Ukrainian
-- `UR` - Urdu*
-- `UZ` - Uzbek*
-- `VI` - Vietnamese
-- `WO` - Wolof*
-- `XH` - Xhosa*
-- `YI` - Yiddish*
-- `YUE` - Cantonese*
-- `ZH` - Chinese _(unspecified variant for backward compatibility; we recommend using_ `ZH-HANS` _or_ `ZH-HANT` _instead)_
-- `ZH-HANS` - Chinese (simplified)
-- `ZH-HANT` - Chinese (traditional)
-- `ZU` - Zulu*
+The DeepL API supports the following languages. These can also be retrieved programmatically via the [`/languages` endpoint](/api-reference/languages/retrieve-supported-languages).
 
-\* These languages only work with the `quality_optimized` model or when no model is specified. They are not compatible with requests that specify the `latency_optimized` model. These languages do not support glossaries or formality.
+## API Supported Languages
 
-### Glossary languages
+import { LanguageTable } from "/snippets/language-table.jsx"
 
-The following can be either source or target languages in a glossary.
-
-- `AR` - Arabic
-- `BG` - Bulgarian
-- `CS` - Czech
-- `DA` - Danish
-- `DE` - German
-- `EL` - Greek
-- `EN` - English
-- `ES` - Spanish
-- `ET` - Estonian
-- `FI` - Finnish
-- `FR` - French
-- `HE` - Hebrew
-- `HU` - Hungarian
-- `ID` - Indonesian
-- `IT` - Italian
-- `JA` - Japanese
-- `KO` - Korean
-- `LT` - Lithuanian
-- `LV` - Latvian
-- `NB` - Norwegian Bokmål
-- `NL` - Dutch
-- `PL` - Polish
-- `PT` - Portuguese
-- `RO` - Romanian
-- `RU` - Russian
-- `SK` - Slovak
-- `SL` - Slovenian
-- `SV` - Swedish
-- `TH` - Thai
-- `TR` - Turkish
-- `UK` - Ukrainian
-- `VI` - Vietnamese
-- `ZH` - Chinese
-
-### Text improvement languages (DeepL API for Write)
+<LanguageTable />
 
 <Info>
-  As of April 2025, supported languages for [text improvement](/api-reference/improve-text) (DeepL API for Write) have not yet been added to the `/languages` endpoint; we'll be extending the `/languages` endpoint in the near future to include this information.
+  Text improvement languages have not yet been added to the [`/languages` endpoint](/api-reference/languages/retrieve-supported-languages). For `/write/rephrase`, `writing_style` and `tone` currently work in `DE`, `EN-GB`, and `EN-US`.
 </Info>
-
-- `DE` (German)
-- `EN-GB` (British English)
-- `EN-US` (American English)
-- `ES` (Spanish)
-- `FR` (French)
-- `IT` (Italian)
-- `PT-BR` (Brazilian Portuguese)
-- `PT-PT` (Portuguese)
-
-<Info>
-  For the `/write/rephase` endpoint, `writing_style` and `tone` currently work in `DE`, `EN-GB`, and `EN-US`.
-</Info>
-