Skip to content

Commit dc04f2e

Browse files
committed
Add information about new displayName property for languages
Related to: aseprite/aseprite#3964
1 parent d25c72e commit dc04f2e

File tree

1 file changed

+18
-9
lines changed

1 file changed

+18
-9
lines changed

extensions/languages.md

Lines changed: 18 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,44 @@
11
# Languages
22

3-
Content a `.aseprite-extension` file for a language extension:
3+
This is an example of a possible extension to translate Aseprite to
4+
Spanish. The content a `.aseprite-extension` file for a language
5+
extension can be something like this:
46

57
```
6-
language-example.aseprite-extension
8+
spanish-language.aseprite-extension
79
|
810
+-- package.json
9-
|
10-
+-- my-language.ini
11+
+-- es.ini
1112
```
1213

13-
Content of `package.json`:
14+
Content of `package.json`, e.g.:
1415

1516
```
1617
{
17-
"name": "language-example",
18-
"displayName": "Language Example",
19-
"description": "Translation to Language Example by Full Name",
18+
"name": "spanish-language",
19+
"displayName": "Spanish Translation",
20+
"description": "Translation to Spanish Example by Full Name",
2021
"version": "1.0",
2122
"author": { "name": "Full Name", "url": "https://twitter.com/your_username_or_homepage_url" },
2223
"categories": [
2324
"Languages"
2425
],
2526
"contributes": {
2627
"languages": [
27-
{ "id": "my-language", "path": "./my-language.ini" }
28+
{ "id": "es",
29+
"path": "./es.ini",
30+
"displayName": "Español" }
2831
]
2932
}
3033
}
3134
```
3235

36+
The `contributes.languages.displayName` property was introduced in
37+
**Aseprite v1.3-rc5** to show the language instead of the language code/ID
38+
(e.g. `es`) in the *Edit > Preferences > General > Language* combobox.
39+
40+
For the `contributes.languages.id` use an [ISO 639-1 language code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).
41+
3342
---
3443

3544
**SEE ALSO**

0 commit comments

Comments
 (0)