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.1.tar.gz (17.3 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.1-py3-none-any.whl (4.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mkdocs_towncrier-0.1.1.tar.gz
  • Upload date:
  • Size: 17.3 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.1.tar.gz
Algorithm Hash digest
SHA256 abf01d83f69cadb9fc967be5b5ad3b49c7b391fab030c57283c68a51bf7f237b
MD5 390f369f14678ffaef9257f9819f70cb
BLAKE2b-256 356761b8ddc66b2a3a4ea9052ffdfc7f43a9991def6af739f10da29a94ea04f6

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mkdocs_towncrier-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ddca9399a24d8d0c5fb38ff8820dbfc4f95d8f4aacce5a3bd8735e3c00b5991b
MD5 6c72676d7cf6cb7ad724805f08e63c84
BLAKE2b-256 db6d98d438399220ee7e68a326ed874f26b6d0b0ca987ad2d134d466fe29a2b9

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