Metadata-Version: 2.1
Name: mkdocs-mdpo-plugin
Version: 0.0.26
Summary: Mkdocs plugin for translations using PO files.
Home-page: https://github.com/mondeja/mkdocs-mdpo-plugin
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
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Software Development :: Internationalization
Classifier: Topic :: Text Processing :: Markup :: Markdown
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: mdpo (==0.3.85)
Requires-Dist: importlib-metadata ; python_version < "3.8"
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.2.3) ; extra == 'dev'
Requires-Dist: mkdocs-exclude (==1.0.2) ; extra == 'dev'
Requires-Dist: mkdocs-include-markdown-plugin (==3.3.0) ; extra == 'dev'
Requires-Dist: mkdocs-material (==7.1.2) ; extra == 'dev'
Requires-Dist: mkdocs-material-relative-language-selector (==1.1.3) ; extra == 'dev'
Requires-Dist: mkdocs-minify-plugin (==0.4.0) ; extra == 'dev'
Requires-Dist: mkdocstrings (==0.15.2) ; extra == 'dev'
Requires-Dist: pre-commit (==2.12.1) ; extra == 'dev'
Requires-Dist: pre-commit-po-hooks (==1.7.3) ; extra == 'dev'
Requires-Dist: pymdown-extensions (==8.1.1) ; extra == 'dev'
Requires-Dist: pytest (==7.0.1) ; extra == 'dev'
Requires-Dist: pytest-cov (==3.0.0) ; extra == 'dev'
Requires-Dist: yamllint (==1.26.1) ; extra == 'dev'
Provides-Extra: doc
Requires-Dist: mkdocs (==1.2.3) ; extra == 'doc'
Requires-Dist: mkdocs-exclude (==1.0.2) ; extra == 'doc'
Requires-Dist: mkdocs-include-markdown-plugin (==3.3.0) ; extra == 'doc'
Requires-Dist: mkdocs-material (==7.1.2) ; extra == 'doc'
Requires-Dist: mkdocs-material-relative-language-selector (==1.1.3) ; extra == 'doc'
Requires-Dist: mkdocs-minify-plugin (==0.4.0) ; extra == 'doc'
Requires-Dist: mkdocstrings (==0.15.2) ; extra == 'doc'
Requires-Dist: pymdown-extensions (==8.1.1) ; extra == 'doc'
Provides-Extra: lint
Requires-Dist: flake8 (==3.9.1) ; extra == 'lint'
Requires-Dist: flake8-implicit-str-concat (==0.2.0) ; extra == 'lint'
Requires-Dist: flake8-print (==4.0.0) ; extra == 'lint'
Requires-Dist: isort (==5.8.0) ; extra == 'lint'
Requires-Dist: yamllint (==1.26.1) ; extra == 'lint'
Provides-Extra: test
Requires-Dist: mkdocs-exclude (==1.0.2) ; extra == 'test'
Requires-Dist: mkdocs-material (==7.1.2) ; extra == 'test'
Requires-Dist: mkdocstrings (==0.15.2) ; extra == 'test'
Requires-Dist: pre-commit-po-hooks (==1.7.3) ; extra == 'test'
Requires-Dist: pymdown-extensions (==8.1.1) ; extra == 'test'
Requires-Dist: pytest (==7.0.1) ; extra == 'test'
Requires-Dist: pytest-cov (==3.0.0) ; extra == 'test'

# mkdocs-mdpo-plugin

[![PyPI version](https://img.shields.io/pypi/v/mkdocs-mdpo-plugin?label=version)](https://pypi.org/project/mkdocs-mdpo-plugin)
[![Downloads](https://img.shields.io/pypi/dm/mkdocs-mdpo-plugin)](https://pypistats.org/packages/mkdocs-mdpo-plugin)
[![Test](https://img.shields.io/github/workflow/status/mondeja/mkdocs-mdpo-plugin/CI?label=tests&logo=github)](https://github.com/mondeja/mkdocs-mdpo-plugin/actions?query=workflow%3ACI)
[![Documentation](https://img.shields.io/github/workflow/status/mondeja/mkdocs-mdpo-plugin/Github%20Pages?label=docs&logo=github)](https://mkdocs-mdpo.ga)
[![Cloudflare DNS](https://img.shields.io/github/workflow/status/mondeja/mkdocs-mdpo-plugin/website-check?label=dns&logo=cloudflare&logoColor=white)](https://github.com/mondeja/mkdocs-mdpo-plugin/actions/workflows/website-check.yml)

<!--description-start-->

Translations for Mkdocs using PO files, fully customizable.
Compatible with [mkdocs-material](https://squidfunk.github.io/mkdocs-material),
based on [mdpo][mdpo-docs].

<!--description-end-->

## Documentation: [en](https://mkdocs-mdpo.ga) - [es](https://mkdocs-mdpo.ga/es/)

<!--intro-start-->

## Install

```
pip install mkdocs-mdpo-plugin
```

## Usage

Enable the plugin in your `mkdocs.yml`:

```yaml
plugins:
  - mdpo
```

### Minimal configuration

#### With [mkdocs-material](https://squidfunk.github.io/mkdocs-material)

```yaml
theme:
  name: material
  language: en

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

plugins:
  - mdpo
```

#### Standalone

<!-- mdpo-include-codeblock -->
```yaml
plugins:
  - mdpo:
      languages:
        - en     # first language is the original
        - es
```

Both previous configurations will create the same layout of files building the
documentation. Given the next layout in a `docs/` directory:

```
📁 docs
└── 📄 index.md
```

After the build, you will get:

```
📁 docs
├── 📁 es
│   └── 📄 index.md.po
└── 📄 index.md
```

Just translate the strings in `docs/es/index.md.po` into Spanish, build again
with `mkdocs build` and the `site/` directory will look like:

```
📁 site
├── 📄 404.html
├── assets
│   ├── 📁 images
│   ├── 📁 javascripts
│   └── 📁 stylesheets
├── 📁 es
│   └── index.html
├── 📄 index.html
├── 📄 sitemap.xml
└── 📄 sitemap.xml.gz
```

<!--intro-end-->

Simple and easy. The extraction of messages process and the produced
layout are fully customizable, you can even translate code blocks!
[Check the full documentation here](https://mkdocs-mdpo.ga).

[mdpo-docs]: https://mdpo.readthedocs.io


