mkdocs-versioning is a plugin for mkdocs, a tool designed to create static websites usually for generating project documentation.
mkdocs-versioning extends mkdocs by differentiating between different versions of documentation you may build. For example, a newer versions of some software may work differently from an older version and it is important that users of an older version of the software reads the appropriate version of the documentation in order to ensure that the user has the correct information and uses the software appropriately.
Install the plugin using pip:
pip install mkdocs-versioning
Next, add the following lines to your
plugins: - search - mkdocs-versioning: version: 0.3.0
If you have no
pluginsentry in your config file yet, you’ll likely also want to add the
searchplugin. MkDocs enables it by default if there is no
Instructions on how to use the plugin is available at https://zayd62.github.io/mkdocs-versioning/
Please note that mkdocs-versioning is currently in Beta and there may be missing feature/documentation so if you could help out by either:
- finding and reporting bugs
- contributing by checking out the issues