All files in the root folder (
docs/) should be in English - all other languages should be in subfolders with the ISO 639-1 language codes, followed by
- and the country code where relevant. A list of common ones can be found here. If this folder doesn't exist, you may create it. Each of the translated files should have the same name as the English version, so things can fall back successfully.
_summary.md file should exist in this folder with a list of links to each file, with a translated name, and link preceded by the language folder:
All links to other docs pages must also be prefixed with the language folder. If the link is to a specific part of the page (ie. a certain heading), you must use the English ID for the heading, like so:
[建立你的环境](zh-cn/newbs-getting-started.md#set-up-your-environment)## 建立你的环境 :id=set-up-your-environment
Once you've finished translating a new language, you'll also need to modify the following files:
noData objects should have a dictionary entry for the language folder in a string:
nameLink object, for setting the "QMK Firmware" heading link in the sidebar, must also be added to:
And make sure to add the language folder in the
fallbackLanguages list, so it will properly fall back to English instead of 404ing:
fallbackLanguages: [// ...'zh-cn',// ...],
See Previewing the Documentation for how to set up a local instance of the docs - you should be able to select your new language from the "Translations" menu at the top-right.
Once you're happy with your work, feel free to open a pull request!