diff --git a/docs/translate.md b/docs/translate.md index c56b1b6131d..ad8d270cd20 100644 --- a/docs/translate.md +++ b/docs/translate.md @@ -18,7 +18,7 @@ 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 @@ -26,9 +26,9 @@ There a a few files that are specific to the MakeCode editor itself. These conta | 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 |
This is an example of the editor with it's interface elements localized: @@ -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 |
Here are some examples of translated blocks: @@ -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_ |
Here's an example of a translated document page for a course lesson: