The Micro:bit Educational Foundation's website, microbit.org can be translated into a range of languages.
The Foundation uses the community translation service called Crowdin to manage and maintain translations. To work on translation tasks, we would encourage you follow this link to register as a translator / proofreader on the micro:bit website and set-up an account on the Crowdin platform.
- What to translate
- Brief for translators
- Using Page translate
- Adding a translation in Crowdin This route will take you into Crowdin and you may translate any page or resource you wish.
- Completing a translation task in Crowdin (as a registered translator/proofreader) Translation tasks are managed by the Foundation and offer a guided route to the specific pages and resources that we are prioritising for users of the website.
What to translate
These parts of microbit.org are available for translation.
Brief for translators
To help maintain translation consistency across the site, we ask all of our volunteers to stay close to the intent of the original text and follow the guidelines below.
teachers, educators, school leadership, education technology experts, students, young people
Purpose (category) of the website
education technology, technology for children, hardware and software
can be viewed here https://crowdin.com/project/microbitorg
If the translation is for a specific dialect, this is specified in the project name , e.g. Portuguese (Brazil), Traditional Chinese (HK) otherwise, assume that local dialect is not included in that project.
available for the majority of projects
project specific glossary community contributions are encouraged
Links and references:
Tone of voice
informal and family friendly, avoid using slang words
Reserved words, not for translation
Micro:bit Educational Foundation
do your :bit
Make it: code it
Worlds Largest Lesson
Forms of punctuation (ndash, mdash,ellipses)
format in the target country should be used
Are there any characters that cannot be used?
yes, Single quotation marks not to be used - website formatting uses double
Maintenance of languages
translation and proofreading is ongoing
The simplest way to get started with translations is to use the page translation feature at https://microbit.org/page-translate/
Page translate provides you with a contextual view of the web page that requires translating. Strings are highlighted with a coloured dotted border. The colour of the border indicates the status of the translation:
- Red - Not translated
- Blue - Translated but not approved
- Green - Translated and approved by a proofreader
To use Page translate
- Open the website at https://microbit.org/page-translate/ and login or register an account with Crowdin
- Navigate to the page you wish to translate
- Click on a string anywhere on the page to add a translation
Adding a translation in Crowdin
Login to Crowdin and select your language from the list available to you. In this example, we are using Norwegian Bokmal. You will be presented with a dropdown menu of all the files available to translate. The files for microbit.org are located in the cms > main > production folder.
In this view, you can hover over the status bar for each file to see the completion status. The blue bar represents the number of words translated and the green bar, the number of words that have been proofread and approved.
Selecting a file will take you into the Crowdin editor to view the source strings that require translation. Selecting a string will load it in the editor window on the right-hand side of the screen, where you can add and save your translation.
You might find it easier to work on the translations if you open the web page that you are working on in another browser window. For example, open the Beating heart activity in Crowdin and open the equivalent window on the website:
Here is a map of translation folders in Crowdin and where they relate to on the website:
Completing a translation task in Crowdin
The Foundation manages some language projects using Crowdin tasks, these can be assigned to translators to work on specific areas of the website. This ensures that you can see those files that are a priority and that are due to be made live very soon. There are three priority tasks within Crowdin named; Make it :code it, Website essentials and Get started.
To work on translation tasks, we would encourage you to follow this link to register as a translator/proofreader on the micro:bit website. When you log in to Crowdin you will if any current tasks are assigned to you. Please feel free to contribute to any of the microbit.org translation strings, not just those which are included in the priority tasks.
Click on view strings to view all of these strings in the editor.
The editor will show a red square next to any string that has not been translated
The task will update daily to reflect any changes to microbit.org which will need translator maintenance. The progress bar will reset to zero at this point. You can see what is left to be translated in the task by checking how many words are remaining. Below, we can see that in the French task there are 1438 words to translate before the content package is complete.
What do the numbered meta tags eg <1> </1> mean?
If you find a string that contains numbered tags around words, this represents text formatting on the website. For example, this source string in Crowdin:
Is rendered on the website, showing link formatting.
If you need to edit the word order of the translated string so that it still makes sense, make sure that you copy the meta tags around the words as they are set out in the source string.
This is a correct example:
<0>Your micro:bit has a </0><1>compass sensor</1> translated to
<1>compass sensor</1><0>Your micro:bit has</0>
This is an incorrect example:
<0>Your micro:bit has a </0><1>compass sensor</1> translated to
<0><1>Your micro:bit has a compass sensor</0></1>
When will translated content be published?
The Foundation manages an ongoing set of tasks that can be assigned to translators to work on specific areas of the website.
There are several different tasks available to work on within Crowdin, but the minimum benchmark for publishing a new language is the translation and proofreading of the three priority tasks below:
Make it :code it
I can't register for the language I'd like to translate?
Sometimes, we need to open a new language project. If you'd like to volunteer and you can't see the language that you'd like to translate then please get in touch via email@example.com or open a support ticket.