Skip to main content

Relative access between translations using mkdocs-material theme.

Project description


PyPI version Downloads

Edit the builtin mkdocs-material site selector to make the links between languages relative.

  • If you have in Github Pages the URL, you can access it from the URL selecting Spanish in the language selector.
  • The current language being displayed will be removed from the language selector, so you will only capable to access to other languages than the current.


pip install mkdocs-material-relative-language-selector

Example configuration

With mkdocs-mdpo-plugin

  name: material
  language: en

  - search
  - material-relative-language-selector
  - mdpo

    - name: English
      lang: en
    - name: Español
      link: es
      lang: es


  • If you want to publish your site in Github Pages, you don't need to define any setting because is the default configuration.
  • If you want to serve your site under a custom root domain, define root_domain: true to get correct links between languages.

Projects using it

Download files

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

Source Distribution

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page