search

microsoft / vscode-loc

VS Code Localization Extension
Other
563 stars 296 forks source link

Request for adding a new locale: Cantonese. We can contribute and help. #204

Closed laubonghaudoi closed 3 years ago

laubonghaudoi commented 3 years ago

This issue was originally opened in https://github.com/microsoft/vscode/issues/112607

As @danyeh mentioned, we could make a community-maintained language pack. May we know how to proceed?

Language name in English: Cantonese Language Name in its own script: 粵語 ISO 693-3 code of the language: yue

Reference

ISO 693 Identifier Documentation: https://iso639-3.sil.org/code/yue

danyeh commented 3 years ago

General steps could work. Assume you want to publish zh-HK language pack

  1. Fork this repo.
  2. dup i18n/vscode-language-pack-zh-hant to i18n/vscode-language-pack-zh-hk
  3. Modify package.json, readme, changelog to reflect new language.
  4. Contribute to translation in .json files
  5. Follow https://github.com/Microsoft/vscode-loc/wiki/How-to-publish-to-Marketplace to publish to marketplace.
  6. Create issue in vscode repo to add new language code for resource loading.
laubonghaudoi commented 3 years ago

@danyeh Thanks for the instructions! However, we would like to point out that this is not a zh-hk locale, but a yue-hant locale. The language name is Cantonese, without region specifications (Cantonese is used in mainland China, Hong Kong, Macau and overseas). Thus the language id would be yue, and the folder will be named as i18n/vscode-language-pack-yue. Is this okay?

danyeh commented 3 years ago

Thank you for clarify! Then I would suggest i18n/vscode-language-pack-yue-hant in case other contributor would introduce hans in the future.

// yue Cantonese // yue-Hans Cantonese // yue-Hant Cantonese

laubonghaudoi commented 3 years ago

I see. So to confirm, the language id would be yue, and the folder would be named as i18n/vscode-language-pack-yue-hant, is this correct?

danyeh commented 3 years ago

Better to match: Language ID: yue-hant Folder: i18n/vscode-language-pack-yue-hant

laubonghaudoi commented 3 years ago

@danyeh Thanks for the clarifications and we are working on the translation now. But we have another question, where can we find the original en texts? They don't seem to be in this repo.

danyeh commented 3 years ago

We don't have corresponding en string json file because source strings are embedded in source code. But I think can use en-GB as reference. @nexue2020 , can you refresh en-GB to latest? Thanks! https://github.com/microsoft/vscode-loc/tree/master/i18n/vscode-language-pack-en-GB

laubonghaudoi commented 3 years ago

@danyeh @nexue2020 We are referring to the translations in en-GB, but it seems like it is missing a lot of entries. Many items in the traditional Chinese locale do not exist in en-GB, please see the screenshot below: 2021-02-18 09 17 03

Is this normal? We are curious how the translators of en-GB looked up the original texts. Did they just read the source codes? Thanks!

nexue2020 commented 3 years ago

en-GB is re-published last week. Closing the issue as resolved.