mkdocs-document-dates

English | 简体中文

A new generation MkDocs plugin for displaying exact creation time, last update time, authors, email of documents

Features

• Always display exact meta-info of the document for any environment (no-Git, Git, all CI/CD build systems, etc.)
• Support for manually specifying time and author in Front Matter
• Support for multiple time formats (date, datetime, timeago)
• Support for multiple author modes (avatar, text, hidden)
• Flexible display position (top or bottom)
• Elegant styling (fully customizable)
• Smart Tooltip Hover Tips
• Supports display of recently updated documents in an overall list
• Multi-language support, localization support, intelligent recognition of user language, automatic adaptation
• Cross-platform support (Windows, macOS, Linux)
• Ultimate build efficiency: O(1), no need to set env vars to distinguish runs

PK of Build Efficiency:	100 md:	1000 md:	Time Complexity:
git-revision-date-localized	> 3 s	> 30 s	O(n)
document-dates	< 0.1 s	< 0.15 s	O(1)

Installation

pip install mkdocs-document-dates

Configuration

Just add the plugin to your mkdocs.yml:

plugins:
  - document-dates

Or, full configuration:

plugins:
  - document-dates:
      position: top            # Display position: top(after title) bottom(end of document)
      type: date               # Date type: date datetime timeago, default: date
      exclude:                 # List of excluded files
        - temp.md              # Exclude specific file
        - drafts/*             # Exclude all files in drafts folder, including subfolders
      date_format: '%Y-%m-%d'  # Date format strings, e.g., %Y-%m-%d, %b %d, %Y
      time_format: '%H:%M:%S'  # Time format strings (valid only if type=datetime)
      show_author: true        # Author display mode: true(avatar) text(text) false(hidden)
      recently-updated: true   # Whether to turn on recently updated data, default: false

Customization Settings

In addition to the above basic configuration, the plug-in also provides a wealth of customization options to meet a variety of individual needs:

• Specify Datetime: You can manually specify the creation time and last update time for each document
• Specify Author: You can manually specify the author information for each document
• Specify Avatar: You can manually specify the avatar for each author
• Set Plugin Style: Such as icons, themes, colors, fonts, animations, dividing line, etc.
• Add Localization Language: More localization languages for timeago and tooltip
• Use Template Variables: Can be used to optimize sitemap.xml for site SEO, can be used to re-customize plug-ins, etc.
• Add Recently Updated Module: Enable list of recently updated documents
• Other Tips: Introduction to technical principles, caching mechanisms
• Development Stories: Describes the origin of the plug-in, the difficulties and solutions encountered in development, and the principles and directions of product design

See the documentation for details: https://jaywhj.netlify.app/document-dates-en