Skip to content

Update links in translate.md to use 'makecode' #6637

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Nov 1, 2025
Merged

Update links in translate.md to use 'makecode' #6637

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
c7feb8c
Update links in translate.md to use 'makecode'
abchatra Oct 29, 2025
04a4eb4
unlink the strings file names
ganicke Nov 1, 2025
4484eef
Merge branch 'master' into abchatra-patch-5
ganicke Nov 1, 2025
11d447e
unlink the 'docs' and 'libs' folder names
ganicke Nov 1, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 30 additions & 30 deletions docs/translate.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,17 +18,17 @@ When you select your language from the [MakeCode](https://crowdin.com/project/ma

Localization files are present in two different forms, JSON and markdown. The JSON files (those you see with the **.json** ending in their names) contain localizable strings related to both the editor UI and the text shown on the programming code blocks. All of the markdown files (those with **.md** at the end of their names) are documents for reference, projects, tutorials, help information, etc.

The files listed in the following sections provide a guide to how each of the translation files and folders relate to the **MakeCode for @boardname@** editor. The links here are to the [English](https://crowdin.com/project/kindscript/en#) source files just to show you the location of the files in the folder structure. Of course, you will translate in your selected language instead.
The files listed in the following sections provide a guide to how each of the translation files and folders relate to the **MakeCode for @boardname@** editor.

### Editor

There a a few files that are specific to the MakeCode editor itself. These contain strings for the editor UI and the simulator. They are essential to translate and should be prioritized before the other files.

| File | Description |
| - | - |
| [strings.json](https://crowdin.com/translate/kindscript/32/en-en) | Common strings that shared by all MakeCode editors. **Note**: This file is located at the MakeCode project's root folder rather than under **microbit** |
| [target-strings.json](https://crowdin.com/translate/kindscript/1922/en-en) | Strings custom to the @boardname@ editor interface |
| [sim-strings.json](https://crowdin.com/translate/makecode/1923/en-en) | Strings for the @boardname@ simulator |
| strings.json | Common strings that shared by all MakeCode editors. **Note**: This file is located at the MakeCode project's root folder rather than under **microbit** |
| target-strings.json | Strings custom to the @boardname@ editor interface |
| sim-strings.json | Strings for the @boardname@ simulator |
<br/>

This is an example of the editor with it's interface elements localized:
Expand All @@ -41,30 +41,30 @@ The strings for the programming code blocks all have names in the form of '_name

| File | Description |
| - | - |
| [core-jsdoc-strings.json](https://crowdin.com/translate/kindscript/66/en-en) | Description text for code elements of the [basic](/reference/basic) and core [blocks](/blocks). **Note**: this file contains strings for the fundamental set of coding blocks and should be prioritized over the other strings files for blocks |
| [core-strings.json](https://crowdin.com/translate/kindscript/65/en-en) | Display text for the [basic](/reference/basic) and core [blocks](/reference/blocks). **Note**: this file contains strings for the fundamental set of coding blocks and should be prioritized over the other strings files for blocks |
| [radio-jsdoc-strings.json](https://crowdin.com/translate/kindscript/64/en-en) | Description text for code elements of the [radio](/reference/radio) blocks |
| [radio-strings.json](https://crowdin.com/translate/kindscript/63/en-en) | Display text for the [radio](/reference/radio) blocks |
| [radio-broadcast-jsdoc-strings.json](https://crowdin.com/translate/kindscript/5032/en-en) | Description text for code elements of the radio broadcast blocks |
| [radio-broadcast-strings.json](https://crowdin.com/translate/kindscript/5030/en-en) | Display text for the radio broadcast blocks |
| [servo-jsdoc-strings.json](https://crowdin.com/translate/kindscript/5036/en-en) | Description text for code elements of the [servo](/reference/servos) blocks |
| [servo-strings.json](https://crowdin.com/translate/kindscript/5034/en-ens) | Display text for the [servo](/reference/servos) blocks |
| [bluetooth-jsdoc-strings.json](https://crowdin.com/translate/kindscript/60/en-en) | Description text for code elements of the [bluetooth](/reference/bluetooth) blocks
| [bluetooth-strings.json](https://crowdin.com/translate/kindscript/59/en-en) | Display text for the [bluetooth](/reference/bluetooth) blocks |
| [devices-jsdoc-strings.json](https://crowdin.com/translate/makecode/62/en-en) | Description text for code elements of the _connected devices_ blocks |
| [devices-strings.json](https://crowdin.com/translate/makecode/61/en-en) | Display text for the _connected devices_ blocks |
| [flashlog-jsdoc-strings.json](https://crowdin.com/translate/kindscript/60/en-en) | Description text for code elements of the _flashlog_ blocks |
| [flashlog-strings.json](https://crowdin.com/translate/kindscript/59/en-en) | Display text for the _flashlog_ blocks |
| [datalogger-jsdoc-strings.json](https://crowdin.com/translate/kindscript/11254/en-en) | Description text for code elements of the [datalogger](/reference/datalogger) blocks |
| [datalogger-strings.json](https://crowdin.com/translate/kindscript/11252/en-en) | Display text for the [datalogger](/reference/datalogger) blocks |
| [jacdac-jsdoc-strings.json](https://crowdin.com/translate/kindscript/7862/en-en) | Description text for code elements of the _jacdac_ blocks
| [jacdac-strings.json](https://crowdin.com/translate/kindscript/7860/en-en) | Display text for the _jacdac_ blocks |
| [color-jsdoc-strings.json](https://crowdin.com/translate/kindscript/11836/en-en) | Description text for code elements of the _color_ blocks
| [color-strings.json](https://crowdin.com/translate/kindscript/11834/en-en) | Display text for the _color_ blocks |
| [microphone-jsdoc-strings.json](https://crowdin.com/translate/kindscript/10230/en-en) | Description text for code elements of the _microphone_ blocks
| [microphone-strings.json](https://crowdin.com/translate/kindscript/10228/en-en) | Display text for the _microphone_ blocks |
| [settings-jsdoc-strings.json](https://crowdin.com/translate/kindscript/10872/en-en) | Description text for code elements of the _settings_ blocks
| [settings-strings.json](https://crowdin.com/translate/kindscript/10870/en-en) | Display text for the _settings_ blocks |
| core-jsdoc-strings.json | Description text for code elements of the [basic](/reference/basic) and core [blocks](/blocks). **Note**: this file contains strings for the fundamental set of coding blocks and should be prioritized over the other strings files for blocks |
| core-strings.json | Display text for the [basic](/reference/basic) and core [blocks](/reference/blocks). **Note**: this file contains strings for the fundamental set of coding blocks and should be prioritized over the other strings files for blocks |
| radio-jsdoc-strings.json | Description text for code elements of the [radio](/reference/radio) blocks |
| radio-strings.json | Display text for the [radio](/reference/radio) blocks |
| radio-broadcast-jsdoc-strings.json | Description text for code elements of the radio broadcast blocks |
| radio-broadcast-strings.json | Display text for the radio broadcast blocks |
| servo-jsdoc-strings.json | Description text for code elements of the [servo](/reference/servos) blocks |
| servo-strings.json | Display text for the [servo](/reference/servos) blocks |
| bluetooth-jsdoc-strings.json | Description text for code elements of the [bluetooth](/reference/bluetooth) blocks
| bluetooth-strings.json | Display text for the [bluetooth](/reference/bluetooth) blocks |
| devices-jsdoc-strings.json | Description text for code elements of the _connected devices_ blocks |
| devices-strings.json | Display text for the _connected devices_ blocks |
| flashlog-jsdoc-strings.json | Description text for code elements of the _flashlog_ blocks |
| flashlog-strings.json | Display text for the _flashlog_ blocks |
| datalogger-jsdoc-strings.json | Description text for code elements of the [datalogger](/reference/datalogger) blocks |
| datalogger-strings.json | Display text for the [datalogger](/reference/datalogger) blocks |
| jacdac-jsdoc-strings.json | Description text for code elements of the _jacdac_ blocks
| jacdac-strings.json | Display text for the _jacdac_ blocks |
| color-jsdoc-strings.json | Description text for code elements of the _color_ blocks
| color-strings.json | Display text for the _color_ blocks |
| microphone-jsdoc-strings.json | Description text for code elements of the _microphone_ blocks
| microphone-strings.json | Display text for the _microphone_ blocks |
| settings-jsdoc-strings.json | Description text for code elements of the _settings_ blocks
| settings-strings.json | Display text for the _settings_ blocks |
<br/>

Here are some examples of translated blocks:
Expand All @@ -77,8 +77,8 @@ Document pages contain the text for any markdown page available on the MakeCode

| File | Description |
| - | - |
| [docs](https://crowdin.com/translate/kindscript/en#/microbit/docs) | Documentation pages for projects, courses, lessons, and code block reference |
| [libs](https://crowdin.com/translate/kindscript/en#/microbit/libs) | Documentation pages for code block reference and other information related to built-in extensions like _servo_ and _datalogger_ |
| docs | Documentation pages for projects, courses, lessons, and code block reference |
| libs | Documentation pages for code block reference and other information related to built-in extensions like _servo_ and _datalogger_ |
<br/>

Here's an example of a translated document page for a course lesson:
Expand Down
Loading