Metadata-Version: 2.1
Name: mkdocs-material-relative-language-selector
Version: 1.1.1
Summary: Relative access between translations using mkdocs-material theme.
Home-page: https://github.com/mondeja/mkdocs-material-relative-language-selector
Author: Álvaro Mondéjar Rubio
Author-email: mondejar1994@gmail.com
License: BSD-3-Clause
Platform: UNKNOWN
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Documentation
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: bump2version (==1.0.1) ; extra == 'dev'
Requires-Dist: flake8 (==3.9.1) ; extra == 'dev'
Requires-Dist: flake8-implicit-str-concat (==0.2.0) ; extra == 'dev'
Requires-Dist: flake8-print (==4.0.0) ; extra == 'dev'
Requires-Dist: isort (==5.8.0) ; extra == 'dev'
Requires-Dist: mkdocs (==1.1.2) ; extra == 'dev'
Requires-Dist: pre-commit (==2.12.1) ; extra == 'dev'

# mkdocs-material-relative-language-selector

[![PyPI version][project-pypi-version-badge]][project-pypi-link]
[![Downloads][project-downloads-badge]][project-downloads-link]

Edit the builtin [mkdocs-material site selector][mkdocs-material-ss-link] to
make the links between languages relative.

- If you have in Github Pages the URL `https://foo.github.io/bar/es/config/`,
 you can access it from the URL `https://foo.github.io/bar/config/` 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.

## Installation

```
pip install mkdocs-material-relative-language-selector
```

## Example configuration

### With [mkdocs-mdpo-plugin][mkdocs-mdpo-plugin-link]

```yaml

theme:
  name: material
  language: en

plugins:
  - search
  - material-relative-language-selector
  - mdpo

extra:
  alternate:
    - name: English
      lang: en
    - name: Español
      link: es
      lang: es
```

## Configuration

- 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

- [mkdocs-mdpo-plugin][mkdocs-mdpo-plugin-link]


[mkdocs-material-ss-link]: https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/#site-language-selector
[mkdocs-mdpo-plugin-link]: https://mondeja.github.io/mkdocs-mdpo-plugin/
[project-pypi-version-badge]: https://img.shields.io/pypi/v/mkdocs-material-relative-language-selector?label=version
[project-pypi-link]: https://pypi.org/project/mkdocs-material-relative-language-selector/
[project-downloads-badge]: https://img.shields.io/pypi/dm/mkdocs-material-relative-language-selector?style=flat-square
[project-downloads-link]: https://pypistats.org/packages/mkdocs-material-relative-language-selector


