Registry / devops / mkdocs-git-revision-date-localized-plugin

mkdocs-git-revision-date-localized-plugin

JSON →
library1.5.4pypypi✓ verified 23d ago

This MkDocs plugin enables displaying the localized date of the last Git modification (and creation) of a Markdown file directly in your documentation. It is currently at version 1.5.1 and maintains an active release cadence with regular minor and patch updates.

pip install mkdocs-git-revision-date-localized-plugin
INSTALL
IMPORT
SIG · MKDOCS-GIT-REVISIO
M
mkdocs-git-revision-date-localized-plugin
devopspythonv1.5.4
Install
4.0s avg
Import
Disk
68MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v1.5.4 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 68.5MB
glibc
py 3.103.95 runs
installs and imports cleanly · install 4.0s · import 0.000s · 70MB
68MB installed
● package 68MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

Plugin
This plugin is configured in mkdocs.yml, not imported directly in Python code.
MkDocs plugins are automatically loaded and initialized by MkDocs based on your configuration in `mkdocs.yml` under the `plugins` section.

To use the plugin, add it to the `plugins` section of your `mkdocs.yml` file. You can then reference `{{ git_revision_date_localized }}` and `{{ git_creation_date_localized }}` variables in your Markdown files.

# mkdocs.yml site_name: My Awesome Docs plugins: - git-revision-date-localized: enable_creation_date: true locale: en timezone: Europe/Berlin # --- Create docs/index.md for testing --- # In your project root, create a 'docs' directory: # mkdir -p docs # echo '# Welcome\n\nLast updated: {{ git_revision_date_localized }}\nCreated: {{ git_creation_date_localized }}' > docs/index.md # --- Build and serve --- # mkdocs build # mkdocs serve
Debug
Known issues
breakingPython 3.8 and 3.9 are no longer supported as of version 1.5.0. Users on these Python versions should upgrade to Python 3.10 or newer, or pin the plugin version to <1.5.0.
fix
Upgrade your Python environment to 3.10 or later, or specify `mkdocs-git-revision-date-localized-plugin<1.5.0` in your dependencies.
affects: >=1.5.0
breakingAs of version 1.3.0, the plugin changed how it calculates revision dates by ignoring whitespace-only and blank line changes, as well as rename commits. This may lead to different (and often more accurate) revision dates than in previous versions.
fix
Be aware that revision dates displayed in your documentation might change after upgrading to v1.3.0 or later. No code changes are required, but verify the output.
affects: >=1.3.0
gotchaThe plugin relies heavily on the `git` command-line tool. Ensure `git` is installed and accessible in your system's PATH, especially when building documentation in Docker containers (e.g., Alpine Linux may require explicit Git installation).
fix
Verify `git` is installed and available. For Docker, include `apk add git` or similar in your Dockerfile if not present.
affects: all
gotchaUsers working with monorepos might encounter issues with revision date accuracy due to the plugin's reliance on Git operations relative to the repository root. While multiple fixes have been applied (e.g., in v1.4.1, v1.4.5, v1.5.0), complex monorepo setups can still be challenging.
fix
Ensure your `mkdocs.yml` is correctly placed and Git repository structure is standard. If issues persist, consult the plugin's GitHub issues for monorepo-specific discussions and configurations.
affects: all
Upgrade
Version history
1.5.4latest on PyPI · released Aug 21, 2026
Audit
Dependencies
mkdocsrequiredThis is an MkDocs plugin and requires MkDocs to function.
Agent activity
14 hits · last 30 days
node
12
Perplexity
1
Resources
mkdocs-git-revision-date-localized-plugin — pip install mkdocs-git-revision-date-localized-plugin · libregistry