Translating Knowledge Base Articles
This article describes some of the basics of translating Knowledge Base articles from English to other languages.
Please Note: All translated articles must be placed in a translated category. If the translated parent does not exist, the article will be placed in the grandparent or root category. Please take the time to translate the parent category before translating any articles in that category.
We've tried to make the translation process as easy as possible. As such, there are only two basic steps:
- The first step is to create an account in the KB, either directly or by
signing in with a GitHub, Google or LinkedIn account. All accounts can translate articles to other
languages, but some actions are restricted to the translation lead.
- Next, find the article you wish to translate. In the sidebar you should see
a link labeled "Translate". Click this link and choose the language you wish to
translate too. On the translation page, the title and content are pre-populated
to help you. The original article is also rendered at the bottom of the page
for reference.
- Between the content box and the original article there are some checkboxes. Check "Subscribe to Updates" to receive an email each time your translation is edited by others. Check "Subscribe to Updates of Original Language" to receive an email each time the original article is edited, so that you can keep your translation up to date.
If the language you wish to translate into is not listed, send an email
to "kb-admins [at] askmonty (dot) org" and request
for it to be added.
If you have any problems with translation, send an email to the above kb-admins email address or contact us on our Zulip instance at https://mariadb.zulipchat.com, or the #maria IRC channel on Libera.Chat. You may also join the maria-docs team on Launchpad for discussion about translation and documentation in general.
Useful Links
- Translation Report (Italian example, change
itin URL to be in your desired language) - Untranslated Nodes (Italian example, change
itin URL to be in your desired language)
