MKDocs Auto Refresh Build Pages Plugin

MkDocs plugin for live development in production. The plugin adds a popup window that asks the user if he wants to reload the (compiled) page when the page has been updated. This tool is useful when you are deploying your MkDocs pages to production and you want to inform the user that the page has been updated.

We are using this plugin on the Robotic Camp when we quickly need to update the page and we want to inform the participants that the programming guide has been updated.

Installation

Install the plugin using pip from PyPI:

pip install mkdocs-auto-refresh-build-pages

Usage

Add the following lines to your mkdocs.yml:

plugins:
  - search
  - auto-refresh-build-pages:
      update_message: "The page has been updated. Do you want to reload?"
      yes_button_text: "Yes"
      no_button_text: "No"
      check_interval_seconds: 60

• update_message (optional): The message that will be displayed when the page is updated. Default: "The page has been updated. Do you want to reload?"
• yes_button_text (optional): The text of the "Yes" button. Default: "Yes"
• no_button_text (optional): The text of the "No" button. Default: "No"
• check_interval_seconds (optional): The interval in seconds at which the page will be checked for updates. Default: 60s (1 minute)

Example screenshot

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Do You Enjoy My Work?

Then you can consider:

• supporting me on GitHub Sponsors:

License

MIT