Skip to main content

MkDocs i18n plugin

Project description

MkDocs i18n plugin

A plugin to internationalize MkDocs. It adds links to translated pages for each page. It also hides other languages page links of navigation menu if there is a translation for current page language.

Example of mkdocs-18n usage: https://mkdocs-i18n.gitlab.io/mkdocs-i18n

Feel free to write your comments or request adaptations to your requirements at https://gitlab.com/mkdocs-i18n/mkdocs-i18n/-/issues.

Case Studies

http://isardvdi.com (https://isard.gitlab.com/isardvdi-docs) is a multilingual community, most members know 2 languages but not the same ones, some understand 3... Each one has its favorite language and has different levels of knowledge about other languages. In addition, community documentation doesn't have a source language and not all documents need to be translated into all languages. Therefore, this plugin shows all available translations for the page shown at the top of the document and also for pages not translated into the language selected in the navigation menu.

Setup

Install the plugin using pip:

pip install mkdocs-i18n

Configure the plugin via mkdocs.yml

If you have no plugins entry in your configuration file you have search plugin enabled. If you create plugins entry to enable i18n plugin you also need to add search plugin if you want to have search plugin enabled.

Donations:

Other interesting works:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkdocs-i18n-0.1.0.tar.gz (4.9 kB view hashes)

Uploaded Source

Built Distribution

mkdocs_i18n-0.1.0-py3-none-any.whl (17.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page