MkDocs i18n plugin using static translation markdown files
Project description
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
Release history Release notifications | RSS feed
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mkdocs_static_i18n-1.3.1.tar.gz.
File metadata
- Download URL: mkdocs_static_i18n-1.3.1.tar.gz
- Upload date:
- Size: 1.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: Hatch/1.16.3 cpython/3.14.2 HTTPX/0.28.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a6125ea7db6cc1a900d76a967f262535af09831160a93c56d7f0d522a79b5faf
|
|
| MD5 |
70a81efb097b00c79f514da23854f40e
|
|
| BLAKE2b-256 |
cef951e2ffda9c7210bc35a24f3717b08c052cd4b728dfa87f901c00d8005259
|
File details
Details for the file mkdocs_static_i18n-1.3.1-py3-none-any.whl.
File metadata
- Download URL: mkdocs_static_i18n-1.3.1-py3-none-any.whl
- Upload date:
- Size: 21.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: Hatch/1.16.3 cpython/3.14.2 HTTPX/0.28.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4036e24795a150c9c4d4b001ed24a43aec01335f76188dbe5a5d8fb4a27eba65
|
|
| MD5 |
a7a818781a0f9f06513abf52dcc2251a
|
|
| BLAKE2b-256 |
6a0b43ff4afb6b438d47718b1959a22075ed95d8460d8c47381878b37a40de63
|
