Skip to main content

An insanely small plugin to add towncrier changelog draft into mkdocs

Project description

mkdocs-towncrier

An insanely small plugin to add towncrier changelog draft into mkdocs

Supported python versions PyPI version
Pyright badge Ruff badge

Installation

You can install the package from PyPI using:

pip install -U mkdocs-towncier

and then enabling it in your mkdocs.yml file:

plugins:
  - towncrier

Usage

Using mkdocs-towncrier is as easy as adding a directive to wherever you want the draft changelog to be added:

# Changelog

<!--- You can even specify the header value! (defaults to "Unreleased") -->
:: towncrier-draft Unreleased changes

--8<-- "CHANGELOG.md"

And that's it! Any draft fragment files will be picked up and automatically added to your pages.

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

mkdocs_towncrier-0.1.0.tar.gz (16.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mkdocs_towncrier-0.1.0-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

File details

Details for the file mkdocs_towncrier-0.1.0.tar.gz.

File metadata

  • Download URL: mkdocs_towncrier-0.1.0.tar.gz
  • Upload date:
  • Size: 16.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for mkdocs_towncrier-0.1.0.tar.gz
Algorithm Hash digest
SHA256 54af9e6c6f534ac4061bb9f8b32d86e03bbf7d2ddbb30479513d5eb7e1bd80a6
MD5 4cf7e6d99f4b13009e7779f6e39f9a9b
BLAKE2b-256 d0cba2319d412140ad28be03c93ffb9a5f5ee8201a1b4105c27559cd966317be

See more details on using hashes here.

File details

Details for the file mkdocs_towncrier-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mkdocs_towncrier-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 23d8d0818ec9cc6b36ec9bcd4f5d4571c6d1ec8b83288817eb7dbcd0aa709b37
MD5 bee403ad4e4fbf625b97d43353ffc9e9
BLAKE2b-256 0ed9886c1f78176a731b1de4e4dba15c26406719afd088e839f92d98d2d4a9a5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page