MkDocs static i18n plugin
The MkDocs plugin that helps you support multiple language versions of your site / documentation.
Like what you :eyes:? Using this plugin? Give it a :star:!
The mkdocs-static-i18n plugin allows you to support multiple languages of your documentation by adding static translation files to your existing documentation pages.
Multi language support is just one .<language>.md file away!
Even better, mkdocs-static-i18n also allows you to build and serve localized versions of any file extension to display localized images, medias and assets.
Localized images/medias/assets are just one .<language>.<extension> file away!
Don't like file suffixes? You're more into a folder based structure? We got you covered as well!
Documentation
Check out the plugins' documentation here.
TL;DR? There's a quick start guide for you!
Upgrading from 0.x versions
:warning: Version 1.0.0 brings breaking changes to the configuration format of the plugin. Check out the upgrade to v1.0.0 guide to ease updating your mkdocs.yml file!
See it in action
This plugin is proudly bringing localized content of hundreds of projects to their users.
Check it out live:
But also in our hall of fame:
- AWS Copilot CLI
- OWASP Top 10
- Spaceship Prompt
- FederatedAI FATE
- Privacy Guides Org
- Computer Science Self Learning Wiki
Contributions welcome
Feel free to ask questions, enhancements and to contribute to this project!
Development
The project is managed with hatch. Install hatch first.
Run the tests:
hatch run test:test
hatch run style:check
Serve the documentation:
hatch run doc:serve
Credits
- Logo by max.icons
1 maintainer
Release files for mkdocs-static-i18n 1.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mkdocs_static_i18n-1.3.1.tar.gz | 1.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mkdocs_static_i18n-1.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.4 MB
Release files / mkdocs_static_i18n-1.3.1.tar.gz
| Download URL | mkdocs_static_i18n-1.3.1.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a6125ea7db6cc1a900d76a967f262535af09831160a93c56d7f0d522a79b5faf
|
|
BLAKE2b-256 checksum How to use checksums |
cef951e2ffda9c7210bc35a24f3717b08c052cd4b728dfa87f901c00d8005259
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
Hatch/1.16.3 cpython/3.14.2 HTTPX/0.28.1
|
Release files / mkdocs_static_i18n-1.3.1-py3-none-any.whl
| Download URL | mkdocs_static_i18n-1.3.1-py3-none-any.whl |
|---|---|
| Size | 21.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4036e24795a150c9c4d4b001ed24a43aec01335f76188dbe5a5d8fb4a27eba65
|
|
BLAKE2b-256 checksum How to use checksums |
6a0b43ff4afb6b438d47718b1959a22075ed95d8460d8c47381878b37a40de63
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
Hatch/1.16.3 cpython/3.14.2 HTTPX/0.28.1
|
