mkdocs-recently-updated-docs

English | 简体中文

Display a list of recently updated documents anywhere on your MkDocs site with a single line of code. This is ideal for sites with a large number of documents, so that readers can quickly see what's new.

Features

• Display recently updated documents in descending order by update time, list items are dynamically updated
• Support multiple view modes including list, detail and grid
• Support automatic extraction of article summaries
• Support for customizing article cover in Front Matter
• Support custom display quantity
• Support exclude specified files or folders
• Works well for any environment (no-Git, Git, Docker, all CI/CD build systems, etc.)

Preview

Installation

pip install mkdocs-recently-updated-docs

Configuration

Just add the plugin to your mkdocs.yml:

plugins:
  - recently-updated

Or, full configuration:

plugins:
  - recently-updated:
      limit: 10          # Limit the number of docs displayed
      exclude:           # List of excluded files
        - index.md       # Exclude specific file
        - blog/*         # Exclude all files in blog folder, including subfolders

Usage

Simply write this line anywhere in your md document:

<!-- RECENTLY_UPDATED_DOCS -->

Configure article cover

Use the field cover in Front Matter to specify the article cover, which supports URL paths and local file paths, for example:

---
cover: assets/cat.jpg
---

Other projects

• MaterialX, the next generation of mkdocs-material, is based on mkdocs-material-9.7.0 and is named X. I'll be maintaining this branch continuously (since mkdocs-material will stop being maintained). Updates have been released that refactor and add a lot of new features, see https://github.com/jaywhj/mkdocs-materialx/releases/

• mkdocs-document-dates, a new generation MkDocs plugin for displaying exact creation date, last updated date, authors, email of documents

  

Chat Group

Discord: https://discord.gg/cvTfge4AUy

Wechat: