Automatically create newsletters from the changes in a mkdocs repository
Project description
MkDocs Newsletter
MkDocs plugin to show the changes of documentation repositories in a user friendly format, at the same time that it's easy for the authors to maintain.
It creates daily, weekly, monthly and yearly newsletter articles with the
changes of each period. Those pages, stored under the Newsletters
section, are
filled with the changes extracted from the git history and the commit messages.
The changes are grouped by categories, subcategories and then by file using the
order of the site's navigation structure.
It assumes that you're using semantic versioning or our enhanced version to create your commits. Only those changes that are interesting to the reader will be added to the newsletter. You can use mkdocs-rss-plugin instead if this workflow doesn't feel good.
Check the live version.
Help
See documentation for more details.
Installing
pip install mkdocs-newsletter
Contributing
For guidance on setting up a development environment, and how to make a contribution to mkdocs-newsletter, see Contributing to mkdocs-newsletter.
License
GPLv3
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for mkdocs_newsletter-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 817a6d84b994ed6c7afcf0978412e19e6cd46265d7451dfa49014ac625054418 |
|
MD5 | bf9864e93ee1a742fd1c0173c872e66b |
|
BLAKE2b-256 | 0de0c00a5e1f0066ae1e141ff413e7005de44ba98c9b5c928b2f9ec80e526bfc |