This repository contains all of the localized Language Pack extensions for Visual Studio Code. A Language Pack contains the localized string resources for a particular language.
Localized resource files are managed in Transifex.
There are 9 "core" languages for Visual Studio Code and, currently, 4 addtional, community driven languages:
Language | VS Code LanguageID | Transifex LanguageCode | Type |
---|---|---|---|
French | fr | French (fr) | Core |
Italian | it | Italian (it) | Core |
German | de | German (de) | Core |
Spanish | es | Spanish (es) | Core |
Russian | ru | Russian (ru) | Core |
Chinese (Simplified) | zh-CN | Chinese Simplified (zh-Hans) | Core |
Chinese (Traditional) | zh-TW | Chinese Traditional (zh-Hant) | Core |
Japanese | ja | Japanese (ja) | Core |
Korean | ko | Korean (ko) | Core |
Bulgarian | bg | Bulgarian (bg) | Community |
Hungarian | hu | Hungarian (hu) | Community |
Portugese (Brazil) | pt-br | Portugese (Brazil) (pt_BR)) | Community |
Turkish | tr | Turkish (tr) | Community |
Language pack extensions are published to the VS Code Marketplace
- Install the next version of the VS Code yeoman generator
npm install -g generator-code@next
Create a new Language Pack by running yo code
and choosing New Language Pack (Localization)
:
yo code
After answering the prompts, you will have a new folder called vscode-language-pack-[language code]
containing all the files you need to get started with the extension.
You will use a script from the VS Code repostiory to generate the translations, so we need to clone that repository (see Contributing to Code for more information).
git clone https://github.com/microsoft/vscode
cd vscode
yarn
Now, download the language files from Transifex and generate the translations:
- Get a Transifex API token from https://www.transifex.com/user/settings/api that has access to projects
vscode-editor
,vscode-workbench
andvscode-extensions
. - Set the API token to the environment variable
TRANSIFEX_API_TOKEN
. - run the
update-localization-extension
script from VS Code:
export TRANSIFEX_API_TOKEN=<<< Transifex Token >>>
npm run update-localization-extension {path_to_lang_pack_ext}
This will add new files to path_to_lang_pack_ext/translations
and will add a list of paths to the translations to package.json
. You can now build and test your extension.
You can now build and test your extension.
cd [path to your extension]
vsce package
code --install-extension [name of your extension.vsix]
code --locale [the new locale id, e.g. tr]
VS Code translations are done in the VS Code Project in Transifex. Transifex is the single source of "truth", therefore any changes need to be made there. This repository is for building the language pack extensions.
If you want to give feedback or report issue, please create a new GitHub issue. Please check if a topic about your issue already exists!).
Before we can accept your pull request you will need to sign a Contribution License Agreement. All you need to do is to submit a pull request, then the PR will get appropriately labelled (e.g. cla-required
, cla-norequired
, cla-signed
, cla-already-signed
). If you already signed the agreement we will continue with reviewing the PR, otherwise system will tell you how you can sign the CLA. Once you sign the CLA all future PR's will be labeled as cla-signed
.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.