Skip to content

Commit c018728

Browse files
committed
List glossary languages, refer to this list where appropriate
1 parent f743594 commit c018728

4 files changed

Lines changed: 55 additions & 7 deletions

File tree

api-reference/glossaries.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -294,7 +294,11 @@ User-Agent: YourApp/1.2.3
294294
</Tabs>
295295

296296
### Listing language pairs
297-
The `/glossary-language-pairs` endpoint lists all the language pairs - the source and target languages - that glossaries support. Since DeepL supports many glossary languages, this list is quite long. We recommend that you instead use [the /languages endpoint](/api-reference/languages).
297+
The `/glossary-language-pairs` endpoint lists all the language pairs - the source and target languages - that glossaries support.
298+
299+
<Info>
300+
Since DeepL supports many glossary languages, the list of potential pairs is quite long. [This list of glossary languages](/docs/getting-started/supported-languages#glossaries-languages) may also be useful.
301+
</Info>
298302

299303
<Tabs>
300304
<Tab title="cURL">

api-reference/multilingual-glossaries.mdx

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,7 @@ description: "Manage and use DeepL glossaries"
1616

1717
## Overview
1818

19-
The `glossaries` endpoints let you work with [DeepL glossaries](https://support.deepl.com/hc/en-us/articles/360021634540-About-the-glossary), which let you specify specific translations for words or short phrases. Each glossary contains a mapping of source phrases to target phrases. During translation, DeepL intelligently flexes entries to account for case, gender, tense, and other grammar features (if the target language has flexion).
20-
21-
Currently you can create glossaries with [any of the languages DeepL supports](../docs/getting-started/supported-languages) (with the exception of Thai). Any updates will be noted here, as well as in [the /languages endpoint and documentation](../docs/getting-started/supported-languages).
19+
The `glossaries` endpoints let you work with [DeepL glossaries](https://support.deepl.com/hc/en-us/articles/360021634540-About-the-glossary), which let you specify specific translations for words or short phrases. Each glossary contains a mapping of source phrases to target phrases. During translation, DeepL intelligently flexes entries to account for case, gender, tense, and other grammar features (if the target language has flexion). You can create glossaries with [any of the languages listed here](/docs/getting-started/supported-languages#glossaries-languages).
2220

2321
A **glossary** contains (several) **dictionaries**. A **dictionary** is a mapping of source phrases to target phrases for a single language pair, like this:
2422

@@ -160,7 +158,7 @@ This example creates a modest glossary with two dictionaries. One maps "Hello" i
160158
</Tab>
161159
</Tabs>
162160

163-
## Using
161+
## Using a glossary
164162

165163
`POST /v2/translate`
166164

@@ -429,7 +427,7 @@ Currently you can only retrieve glossary contents in TSV format.
429427
To retrieve the contents of an entire glossary, iterate through each of dictionaries, retrieving the content of each. While we work to provide the ability to retrieve a whole glossary in a single call, [your feedback here](/docs/resources/deepl-developer-community) is valuable as we strive to improve our API.
430428
</Info>
431429
432-
## Editing
430+
## Editing a glossary
433431
434432
### Add a new dictionary, or replace an existing one
435433
@@ -689,6 +687,10 @@ Use this method to delete a dictionary for a specific language pair.
689687

690688
## Notes on usage
691689

690+
### Languages supported
691+
692+
The DeepL API supports [these languages for glossaries](/docs/getting-started/supported-languages#glossaries-languages).
693+
692694
### Language variants
693695

694696
Glossaries apply to languages, not specific language variants. A glossary for a language applies to any variant of that language.

api-reference/multilingual-glossaries/list-language-pairs-supported-by-glossaries.mdx

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,3 +3,6 @@ openapi: "get /v2/glossary-language-pairs"
33
title: "List language pairs supported for glossaries"
44
playground: none
55
---
6+
7+
<Info>This endpoint returns all possible language pairs for glossaries.
8+
[This list of supported languages](/docs/getting-started/supported-languages#glossaries-languages) may also be useful.</Info>

docs/getting-started/supported-languages.mdx

Lines changed: 40 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -253,6 +253,44 @@ If trying to convert between variants of the same language (e.g. `EN-US` to `EN-
253253

254254
\* 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.
255255

256+
### Glossaries languages
257+
258+
The following can be either source or target languages in a glossary.
259+
260+
- `AR` - Arabic
261+
- `BG` - Bulgarian
262+
- `CS` - Czech
263+
- `DA` - Danish
264+
- `DE` - German
265+
- `EL` - Greek
266+
- `EN` - English
267+
- `ES` - Spanish
268+
- `ET` - Estonian
269+
- `FI` - Finnish
270+
- `FR` - French
271+
- `HE` - Hebrew
272+
- `HU` - Hungarian
273+
- `ID` - Indonesian
274+
- `IT` - Italian
275+
- `JA` - Japanese
276+
- `KO` - Korean
277+
- `LT` - Lithuanian
278+
- `LV` - Latvian
279+
- `NB` - Norwegian Bokmål
280+
- `NL` - Dutch
281+
- `PL` - Polish
282+
- `PT` - Portuguese
283+
- `RO` - Romanian
284+
- `RU` - Russian
285+
- `SK` - Slovak
286+
- `SL` - Slovenian
287+
- `SV` - Swedish
288+
- `TH` - Thai
289+
- `TR` - Turkish
290+
- `UK` - Ukrainian
291+
- `VI` - Vietnamese
292+
- `ZH` - Chinese
293+
256294
### Text improvement languages (DeepL API for Write)
257295

258296
<Info>
@@ -270,4 +308,5 @@ If trying to convert between variants of the same language (e.g. `EN-US` to `EN-
270308

271309
<Info>
272310
For the `/write/rephase` endpoint, `writing_style` and `tone` currently work in `DE`, `EN-GB`, and `EN-US`.
273-
</Info>
311+
</Info>
312+

0 commit comments

Comments
 (0)