Setting up mkdocs-material
mkdocs-static-i18n plugin aims at providing best-in-class support to the mkdocs-material theme and plugins users!
As such, it will do its best to automagically adjust the
mkdocs-material theme configuration per language such as its
extra.alternates language switcher.
mkdocs-material language switcher will also benefit from the alternate awareness of the plugin as it will contextualize the links of the language switcher to point to the language alternates of the current page instead of just pointing to the root the each configured language.
This will smoothen your users' experience as they will be able to switch from one language to another on the same page!
This feature is controlled by the
reconfigure_material option and you can personalize your language builds even further using the languages options.
|no||true||true | false|
navigation.instant feature is NOT compatible with the multi-language switcher. The plugin will issue a WARNING log if you try using it.
- Automatic language setup
- Automatic language switcher setup
- Automatic language switcher contextual link setup
- Search plugin localization and result deduplication
- Blog plugin localization