mirror of
https://github.com/squidfunk/mkdocs-material.git
synced 2024-12-21 03:45:57 +01:00
126 lines
5.0 KiB
Markdown
126 lines
5.0 KiB
Markdown
|
# Translations
|
|||
|
|
|
|||
|
|
It's unbelievable – with the help of international community contributions,
|
|||
|
|
Material for MkDocs has been translated into 60+ languages. As you can imagine,
|
|||
|
|
it's impossible for us maintainers to keep all languages up-to-date, and new
|
|||
|
|
features sometimes require new translations.
|
|||
|
|
|
|||
|
|
If you would like to help us to make Material for MkDocs even more globally
|
|||
|
|
accessible and have noticed a missing translation in your language, or would
|
|||
|
|
like to add a new language, you can help us by following the steps of the guide
|
|||
|
|
below.
|
|||
|
|
|
|||
|
|
## Before creating an issue
|
|||
|
|
|
|||
|
|
Translations change frequently, which is why we want to make sure that you don't
|
|||
|
|
invest your time in duplicating work. Before adding translations, please check
|
|||
|
|
the following things:
|
|||
|
|
|
|||
|
|
### Check language availability
|
|||
|
|
|
|||
|
|
With more than 60 languages, the chances are good that your language is already
|
|||
|
|
supported by Material for MkDocs. You can check if your language is available,
|
|||
|
|
or needs improvements or additional translations by inspecting the list of
|
|||
|
|
[supported languages]:
|
|||
|
|
|
|||
|
|
- __Your language is already supported__ – in this case, you can check if there
|
|||
|
|
are translations missing, and click the link underneath your language to add them, which takes 5 minutes.
|
|||
|
|
|
|||
|
|
- __Your language is missing__ – in that case, you can help us add support
|
|||
|
|
for your language to Material for MkDocs! Read on, to learn how to do this.
|
|||
|
|
|
|||
|
|
[supported languages]: ../setup/changing-the-language.md#site-language
|
|||
|
|
|
|||
|
|
### Search our issue tracker
|
|||
|
|
|
|||
|
|
Another user might have already created an issue supplying the missing
|
|||
|
|
translations for your language that still needs to be integrated by us
|
|||
|
|
maintainers. To avoid investing your time in duplicated work, please search the
|
|||
|
|
[issue tracker] beforehand.
|
|||
|
|
|
|||
|
|
[issue tracker]: https://github.com/squidfunk/mkdocs-material/issues
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
At this point, when you have made sure that Material for MkDocs doesn't already
|
|||
|
|
support your language, you can add new translations for it by following the
|
|||
|
|
issue template.
|
|||
|
|
|
|||
|
|
## Issue template
|
|||
|
|
|
|||
|
|
We have created an issue template that makes contributing translations as simple
|
|||
|
|
as possible. It is the result of our experience with 60+ language contributions
|
|||
|
|
and updates over the last couple of years, and consists of the following parts:
|
|||
|
|
|
|||
|
|
- [Title]
|
|||
|
|
- [Translations]
|
|||
|
|
- [Country flag] <small>optional</small>
|
|||
|
|
- [Checklist]
|
|||
|
|
|
|||
|
|
[Title]: #title
|
|||
|
|
[Translations]: #translations
|
|||
|
|
[Country flag]: #country-flag
|
|||
|
|
[Checklist]: #checklist
|
|||
|
|
|
|||
|
|
### Title
|
|||
|
|
|
|||
|
|
When you update an already existing language, you can just leave the title as it
|
|||
|
|
is. Adding support for a new language, replace the `...` in the pre-filled title
|
|||
|
|
with the name of your language.
|
|||
|
|
|
|||
|
|
| <!-- --> | Example |
|
|||
|
|
| -------- | -------- |
|
|||
|
|
| :material-check:{ style="color: #4DB6AC" } __Clear__ | Add translations for German
|
|||
|
|
| :material-close:{ style="color: #EF5350" } __Unclear__ | Add translations ...
|
|||
|
|
| :material-close:{ style="color: #EF5350" } __Useless__ | Help
|
|||
|
|
|
|||
|
|
### Translations
|
|||
|
|
|
|||
|
|
If a translation contains an :arrow_left: icon on the right side, it is missing.
|
|||
|
|
You can translate this line and remove the :arrow_left: icon. If you don't know
|
|||
|
|
how to translate specific lines, simply leave them for other contributors to
|
|||
|
|
complete. To ensure the accuracy of your translation, consider double-checking the
|
|||
|
|
context of the words by looking at our [English translations].
|
|||
|
|
|
|||
|
|
[English translations]: https://github.com/squidfunk/mkdocs-material/tree/master/src/partials/languages/en.html
|
|||
|
|
|
|||
|
|
### Country flag <small>optional</small> { #country-flag }
|
|||
|
|
|
|||
|
|
For a better overview, our list of [supported languages] includes country flags
|
|||
|
|
next to the language names. You can help us select a flag for your language by
|
|||
|
|
adding the shortcode for the country flag to this field. Go to our
|
|||
|
|
[emoji search] and enter `flag` to find all available shortcodes.
|
|||
|
|
|
|||
|
|
!!! question "What if my flag is not available?"
|
|||
|
|
|
|||
|
|
[Twemoji] provides flag emojis for 260 countries – subdivisions of countries,
|
|||
|
|
such as states, provinces, or regions, are not supported. If you're adding
|
|||
|
|
translations for a subdivision, please choose the most appropriate available
|
|||
|
|
flag.
|
|||
|
|
|
|||
|
|
[Twemoji]: https://twemoji.twitter.com/
|
|||
|
|
[emoji search]: ../reference/icons-emojis.md#search
|
|||
|
|
|
|||
|
|
> __Why this might be helpful__: adding a country flag next to the country name
|
|||
|
|
> can be helpful for you and for others to find the language in the list of
|
|||
|
|
> supported languages faster and easier. If your country's flag is not supported
|
|||
|
|
> by [Twemoji], you can help us choose an alternative.
|
|||
|
|
|
|||
|
|
### Checklist
|
|||
|
|
|
|||
|
|
Thanks for following the guide and helping us to add new translations to Material
|
|||
|
|
for MkDocs – you are almost done. The checklist ensures that you have read this
|
|||
|
|
guide and have worked to your best knowledge to provide us with everything we need
|
|||
|
|
to integrate your contribution.
|
|||
|
|
|
|||
|
|
__We'll take it from here.__
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Attribution
|
|||
|
|
|
|||
|
|
If you submit a translation using the template above, you will be __credited as
|
|||
|
|
a co-author__ in the commit, so you don't need to open a pull request. You have
|
|||
|
|
done a significant contribution to the project, making Material for MkDocs
|
|||
|
|
accessible to more people around the world. Thank you!
|