Metadata-Version: 2.1
Name: mkdocs-interwiki
Version: 0.1.0
Summary: DokuWiki-like InterWiki links for MkDocs
Home-page: https://github.com/yourname/mkdocs-interwiki
Author: Gobidesert
Author-email: gobidesert.mf@gmail.com
License: MIT
Project-URL: Source, https://github.com/yourname/mkdocs-interwiki
Project-URL: Tracker, https://github.com/yourname/mkdocs-interwiki/issues
Keywords: mkdocs,markdown,interwiki,dokuwiki,plugin
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: MkDocs
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Documentation
Classifier: Topic :: Text Processing :: Markup
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# mkdocs-interwiki

DokuWiki-like **InterWiki** links for MkDocs.

## Usage

Write links like:
```

[[wp>Python|Wikipedia: Python]]
[[gh>mkdocs/mkdocs|MkDocs on GitHub]]
[[issue>1234|Bug #1234]]

````

Configure in `mkdocs.yml`:
```yaml
plugins:
  - interwiki:
      maps:
        wp: "https://en.wikipedia.org/wiki/{target}"
        gh: "https://github.com/{target}"
        issue: "https://github.com/{repo}/issues/{target}"
      extra:
        repo: "yourorg/yourrepo"
````

Per-page override (front matter):

```yaml
interwiki_extra:
  repo: "other-org/other-repo"
```

## Install

```bash
pip install mkdocs-interwiki
```

## License

MIT


# Changelog

## 0.1.0 — 2025-10-05
- Initial public release with DokuWiki-like `[[prefix>Target|Label]]` links
- Configurable `maps` and `extra` variables
- Per-page `interwiki_extra` overrides
- URL-encoding of `{target}`


