Changelog¶

To install the unreleased django-docutils version, see developmental releases.

$ pip install --upgrade --pre django-docutils

pipx:

$ pipx install --suffix=@next 'django-docutils' --pip-args '\--pre' --force
// Usage: django-docutils@next

uv:

$ uv add django-docutils --prerelease allow

uvx:

$ uvx --from 'django-docutils' --prerelease allow django-docutils

django-docutils 0.31.0 (unreleased)¶

Upcoming changes will be written here.

django-docutils 0.30.0 (2026-06-07)¶

django-docutils 0.30.0 hardens the rendering defaults so reStructuredText from untrusted sources can no longer read local files, reach external URLs, or inject raw HTML out of the box. This is a breaking change for apps that intentionally render trusted static RST with those features — they now opt in with a single allow_unsafe_docutils_settings flag; see Security for the migration and deployment guidance. New reader-orientation docs, led by a What is docutils? topic, help newcomers tell docutils, reStructuredText, Sphinx, and Markdown apart.

Breaking changes¶

Docutils rendering is locked down by default (#457)¶

django-docutils now disables Docutils file insertion, raw directives, and docutils.conf processing across the public rendering helpers. It also removes raw nodes, unsafe URI schemes, and http-equiv=refresh meta directives before emitting HTML, and sanitizes after all writer transforms run, so a transform cannot reintroduce unsafe markup. Apps that render trusted static RST and intentionally depend on .. include::, .. raw::, local docutils.conf, or unsafe URI schemes must opt in explicitly.

# Before
DJANGO_DOCUTILS_LIB_RST = {
    "docutils": {
        "raw_enabled": True,
        "file_insertion_enabled": True,
    },
}

# After
DJANGO_DOCUTILS_LIB_RST = {
    "allow_unsafe_docutils_settings": True,
    "docutils": {
        "raw_enabled": True,
        "file_insertion_enabled": True,
    },
}

See Security for trusted-content examples and deployment advice.

Fixes¶

django_docutils.__version__ is exported from the top-level package.
The inline code formatter now matches the upstream Pygments override signature used by current type checkers.
The docs back button and sidebar assets update correctly during SPA-style navigation.
Legacy docs CSS that broke code-block rendering was removed.
django.test.override_settings of DJANGO_DOCUTILS_LIB_RST now applies and reverts cleanly, instead of permanently merging override keys into settings.
Rendering .rst templates with a request no longer stores request and CSRF state on the shared template engine options.

Documentation¶

Docstring and Sphinx cleanup made the rendered API reference less noisy: exceptions link back to the module page, docutils and Django typing aliases are visible to autodoc, forward-reference warnings are suppressed where appropriate, and the url_role and is_uncapitalized_word examples render cleanly.

The new Security topic explains the locked-down defaults, manual unsafe opt-ins for trusted static RST, URI scheme filtering, when sanitization runs, and deployment guidance for user-authored content. It cites the upstream guidance the defaults implement — docutils’ Deploying Docutils Securely — and Django’s security overview. sanitize_doctree() and SanitizeTransform are documented for reuse in custom docutils pipelines.

A new What is docutils? topic orients readers who are new to the ecosystem: docutils versus reStructuredText versus Sphinx, Markdown parsing options, and the formats docutils can emit. The README and Quickstart link the upstream reStructuredText primers, and the README’s unsafe-settings example shows the allow_unsafe_docutils_settings opt-in instead of a standalone raw_enabled that the hardened defaults would ignore.

Documentation deployment now uses AWS OIDC authentication instead of long-lived AWS keys, and the docs build switched to the dirhtml builder for cleaner URLs.

Documentation rebuilt around Django workflows (#451)¶

The documentation now follows the Library Skeleton layout: Quickstart first, task-oriented topics next, then the API Reference and project maintenance pages. The topic pages are organized around the actual ways django-docutils is used in an app: Template tag, Template filter, and Class-based view.

The class-based view page now shows how an .rst template flows through DocutilsTemplates, DocutilsTemplate, DocutilsView, and DocutilsResponse. The API index also groups publisher helpers, roles, directives, writers, transforms, template tags, and views into a browsable reference instead of leaving users to infer the package shape from module names.

Faster self-hosted docs frontend (#450)¶

The docs frontend self-hosts IBM Plex Sans and Mono, preloads the important font files, and uses fallback metrics so text does not jump when web fonts finish loading. The sidebar logo, badges, and active-link state have fixed startup dimensions, which removes the visible layout shift from the first page load.

Internal links use a small vanilla-JavaScript navigation layer that swaps only the document regions that change. Browsers with the View Transitions API get a smooth crossfade, while older browsers keep normal navigation behavior.

Shared gp-sphinx documentation stack (#452, #453, #454, #455)¶

django-docutils no longer carries repo-local copies of the docs theme, font loader, sidebar templates, or SPA navigation script. docs/conf.py now composes the published gp-sphinx configuration, which keeps this project aligned with the shared docs stack used by sibling gp-libs packages.

The API reference picks up card-style autodoc signatures, object-type badges, MyST-friendly Python cross-reference roles, improved IBM Plex typography, and the gp-sphinx-* CSS namespace. The latest bump moves the rendered site to gp-furo-theme, a Tailwind v4 refresh of Furo, with sphinx-vite-builder owning the Vite asset pipeline end to end.

Development¶

AGENTS.md now records the changelog conventions used by this file, working doctest expectations, and logging standards for future library instrumentation. Releases now publish to PyPI through a Trusted Publisher workflow (#447), replacing token-based authentication. Dev dependencies, uv, just, GitHub Actions, and gp-sphinx pins were kept current across the release cycle.

Development commands moved to Just (#448)¶

The root Makefile, docs Makefile, and obsolete Windows docs batch file were replaced with justfile recipes. just test, just ruff, just mypy, and just build-docs are now the documented development loop.

django-docutils 0.29.0 (2025-11-01)¶

django-docutils 0.29.0 raises the Python floor to 3.10, adds Python 3.14 to the test matrix, and refreshes the project for modern typing and dependency-group tooling. The release also updates developmental install docs so prerelease users can try the package with pip, pipx, uv, or uvx.

Breaking changes¶

Minimum Python is 3.10 (#443)¶

Python 3.9 support was removed after its October 31, 2025 end-of-life date. The package metadata, Trove classifiers, Ruff target, mypy configuration, README, and CI matrix now all treat Python 3.10 as the minimum.

# Before
requires-python = ">=3.9"

# After
requires-python = ">=3.10"

Dependencies¶

The types-docutils constraint was relaxed after the temporary lock used during the Python 3.9 transition. Development dependencies were refreshed for the Python 3.10+ support window.

Documentation¶

Quickstart now includes prerelease installation commands for pip, pipx, uv, and uvx, matching the install preamble at the top of this changelog.

Development¶

Python 3.14 is covered in CI (#442). The codebase also adopted from __future__ import annotations and Ruff’s Python 3.10 annotation rules, so imports used only for type checking no longer need to be resolved at runtime (#440).

Django 5.2 was added to the supported classifier and test coverage, while Django 5.0 was removed from the active matrix.

django-docutils 0.28.0 (2024-12-20)¶

django-docutils 0.28.0 is a maintenance release that moves the project to the Python 3.9+ era. There are no user-facing rendering changes, but package metadata, CI, and automated lint output now line up with the new floor.

Breaking changes¶

Minimum Python is 3.9 (#439)¶

Python 3.8 support was removed after its October 7, 2024 end-of-life date. The new minimum for this release line is Python 3.9.

# Before
requires-python = ">=3.8"

# After
requires-python = ">=3.9"

Dependencies¶

types-docutils was temporarily locked to 0.21.0.20241005 while the docs and typing stack settled (#438).

Development¶

The repository was run through an aggressive Ruff modernization pass for Python 3.9, including preview and unsafe fixes where Ruff could apply them mechanically (#437).

django-docutils 0.27.0 (2024-11-26)¶

django-docutils 0.27.0 moves project management from Poetry to uv and the build backend from Poetry to hatchling. It also drops Django 3.2, adds Django 5.1 to the supported test grid, and keeps the package focused on current Django LTS and feature releases.

Breaking changes¶

Django 4.2 is the minimum supported Django (#430)¶

Django 3.2 support was removed after upstream extended support ended on April 1, 2024. django-docutils 0.26.x is the final release line for Django 3.2 users.

# Before
django = ">=3.2"

# After
django = ">=4.2"

Project management moved from Poetry to uv (#435)¶

Development installs, lockfile updates, and CI dependency setup now use uv instead of Poetry.

$ uv sync --all-extras --dev

Build backend moved to hatchling (#435)¶

The package build backend changed from Poetry’s backend to hatchling. This affects contributors and release automation, not the Django rendering APIs.

Development¶

Django 5.1 was added to CI and package classifiers (#429). Python 3.13 was also added to the local tool versions and CI coverage during this release cycle.

django-docutils 0.26.0 (2024-07-20)¶

django-docutils 0.26.0 is the final release line that supports Django 3.2. It is otherwise a maintenance release with documentation link cleanup and code-quality updates.

Breaking changes¶

0.26.x is the final branch supporting Django 3.2. django-docutils 0.27.0 and newer require Django 4.2+.

Documentation¶

Links in the documentation are automatically linkified when they were previously rendered as plain text.

Development¶

Poetry was updated from 1.8.1 to 1.8.3. Ruff 0.4.2 drove a small code-quality pass, including f-string cleanups and adjustments to InlineHtmlFormatter style and class handling (#422).

django-docutils 0.25.0 (2024-03-24)¶

django-docutils 0.25.0 is a maintenance release. It carries no rendering fixes or new public features, but refreshes the codebase with the then-current Ruff rule set.

Development¶

The project was run through Ruff 0.3.4 with all selected automated fixes, including preview and unsafe fixes where accepted by the project (#419).

django-docutils 0.24.0 (2024-03-09)¶

django-docutils 0.24.0 restores Python 3.8 compatibility for the supported release line. This is a targeted compatibility fix with no new Django rendering surface.

Fixes¶

Python 3.8 support was re-implemented and added back to the test matrix (#417).

django-docutils 0.23.0 (2024-02-06)¶

django-docutils 0.23.0 is a maintenance release for linting and development tooling. It keeps the package behavior stable while tightening the checks used for future code changes.

Dependencies¶

Ruff moved from 0.2.2 to 0.3.0, and CI now calls ruff check . with Ruff’s current command shape (#416).

Development¶

Lint coverage was strengthened with Ruff rule families for commas, builtins, and error-message construction (#415). These checks make future refactors more consistent without changing the public APIs.

django-docutils 0.22.1 (2023-12-24)¶

django-docutils 0.22.1 fixes the settings reload signal added in 0.22.0. Apps that update Django settings at runtime can now trigger role and directive registration without a signal argument error.

Fixes¶

reload_settings now accepts Django’s signal keyword arguments correctly (#413, fixes #412).

django-docutils 0.22.0 (2023-12-24)¶

django-docutils 0.22.0 makes custom docutils roles and directives respond to Django settings updates. It also moves registration helpers into dedicated registry modules so the public import path matches their responsibility.

Breaking changes¶

Role and directive registration moved to registry modules (#409)¶

The registration functions moved out of the package roots and into explicit registry modules.

# Before
from django_docutils.lib.roles import register_django_docutils_roles
from django_docutils.lib.directives import register_django_docutils_directives

# After
from django_docutils.lib.roles.registry import register_django_docutils_roles
from django_docutils.lib.directives.registry import register_django_docutils_directives

What’s new¶

Settings updates re-register roles and directives (#408)¶

When DJANGO_DOCUTILS_LIB_RST changes during a Django settings update, django-docutils re-registers configured docutils roles and directives. This keeps custom role and directive mappings in sync with test overrides and runtime settings changes.

Development¶

Tests now cover custom role and directive registration through settings updates (#408).

django-docutils 0.21.0 (2023-12-09)¶

django-docutils 0.21.0 updates the supported Django matrix around Django 5.0. It removes older unsupported Django minors and keeps CI aligned with the package metadata.

Dependencies¶

Django 5.0 was added to package metadata and the test grid. Django 4.0 and 4.1 were removed from the project configuration and CI matrix (#407).

Development¶

CodeQL moved from an advanced configuration file to GitHub’s default setup.

django-docutils 0.20.1 (2023-11-18)¶

django-docutils 0.20.1 fixes development dependency configuration and refreshes GitHub Actions used by CI. There are no user-facing rendering changes.

Development¶

Poetry development dependencies now use dependency groups instead of extras, matching Poetry’s documented layout and poetry check expectations.

CI actions were updated to remove warnings, including dorny/paths-filter and codecov/codecov-action.

django-docutils 0.20.0 (2023-11-18)¶

django-docutils 0.20.0 is a maintenance release that consolidates formatting on Ruff and expands test coverage around roles and settings. It does not change the main template tag, filter, or view APIs.

What’s new¶

Formatting moved from Black to Ruff (#406)¶

ruff format replaced Black for code formatting. The project keeps a familiar Black-style format while using the same fast tool for linting and formatting.

Fixes¶

The GitHub role docstring was corrected, and the docs and mypy configuration now point at django_docutils.lib.settings (#404).

Development¶

Additional tests cover role behavior and related helpers (#404). Poetry was updated to 1.7.0 during the release cycle.

django-docutils 0.19.0 (2023-10-08)¶

django-docutils 0.19.0 renames the Django template engine module and backend class so the public names match the package’s Django-facing template system. The docs were updated around the class-based view workflow at the same time.

Breaking changes¶

Template engine imports moved to `django_docutils.template` (#402)¶

The old django_docutils.engines import path was replaced by django_docutils.template.

# Before
from django_docutils.engines import Docutils

# After
from django_docutils.template import DocutilsTemplates

In Django settings, the backend path should now point at DocutilsTemplates.

{
    "BACKEND": "django_docutils.template.DocutilsTemplates",
    "APP_DIRS": True,
    "NAME": "docutils",
}

Documentation¶

The class-based view documentation was renamed and expanded, with examples that connect DocutilsView to the docutils template engine and rendered HTML output.

django-docutils 0.18.0 (2023-10-08)¶

django-docutils 0.18.0 removes duplicate directive wiring and starts enforcing NumPy-style docstrings through Ruff. The release is mostly internal, but it improves the generated API reference for users browsing the package.

Fixes¶

The duplicate CodeBlock directive definition was removed from directives.py (#401).

Documentation¶

Docstrings were added across functions, methods, classes, and packages so the API reference has usable narrative text (#396).

Development¶

Ruff’s pydocstyle rules were enabled with the NumPy convention (#396).

django-docutils 0.17.0 (2023-10-08)¶

django-docutils 0.17.0 continues narrowing the package to Django docutils rendering. It removes leftover Font Awesome machinery, unused model code, and an incorrect template-tag exception name.

Breaking changes¶

Font Awesome transformer references were removed because they were unused leftovers from an earlier codebase (#397, #399). The unused HTML translator visitor and models.py file were also removed (#400).

MalformedArgumentsToUrlTag was renamed to MalformedArgumentsToRSTTag so errors from the {% rst %} tag use the correct domain language (#400).

Documentation¶

The API docs gained Django intersphinx links, and settings typings were added to make the generated reference clearer (#395).

django-docutils 0.16.0 (2023-10-07)¶

django-docutils 0.16.0 cleans up the public typing names for docutils roles and expands the role documentation. This release is most relevant to users writing custom role functions.

Breaking changes¶

GenericUrlRoleFn was renamed to RoleFnReturnValue (#394). The new name describes the value returned by docutils role callbacks instead of implying a specific URL helper implementation.

Documentation¶

Role typings now appear in the docs, common and types are split into separate role API pages, and the role documentation was expanded (#394).

django-docutils 0.15.0 (2023-10-01)¶

django-docutils 0.15.0 is the release where the Django template integration settled around {% rst %} and the rst filter. The filter now uses the same publisher path as the tag, block tags are supported, and tests cover the tag, filter, and template engine together.

Breaking changes¶

`restructuredtext` was renamed to `rst` (#390)¶

The Django template tag and filter were renamed to the shorter rst spelling.

{# Before #}
{% filter restructuredtext %}
Hello **world**
{% endfilter %}

{# After #}
{% filter rst %}
Hello **world**
{% endfilter %}

{# Before #}
{% restructuredtext content %}

{# After #}
{% rst content %}

Template tags moved into `templatetags.django_docutils` (#391)¶

The template tag module moved from lib/templatetags/rst to templatetags/django_docutils. Django users should load the tag library with {% load django_docutils %}.

What’s new¶

`{% rst %}` can render block content (#392)¶

The rst() tag now accepts content between {% rst %} and {% endrst %} without requiring a separate template variable.

{% load django_docutils %}
{% rst %}
Hello world
===========

Thank you for visiting the site!

- List item 1
- List item 2
{% endrst %}

The `rst` filter uses the same publisher as the tag (#388)¶

The rst_filter() filter now renders through ReStructuredTextNode, so django-docutils settings apply to filter output as well as tag output.

Fixes¶

The restructuredtext filter warning stack level was corrected, the filter is registered through Django’s decorator API, DocutilsView has tighter rst_name typing, and the template-tag error message was corrected (#389).

Development¶

Tests now cover the template tag, template filter, and Django template engine (#386). Pytest configuration moved into pyproject.toml (#387), and the test settings module gained type annotations for django-stubs and mypy.

django-docutils 0.14.1 (2023-10-01)¶

django-docutils 0.14.1 is a small packaging and documentation maintenance release. It does not change runtime rendering behavior.

Documentation¶

The API docs no longer depend on Pygments-specific pages, and the deprecated restructuredtext filter gained credit notes before its replacement work landed.

Development¶

The package classifiers now advertise Typing :: Typed.

django-docutils 0.14.0 (2023-09-30)¶

django-docutils 0.14.0 makes the package mypy strict compliant and removes a Pygments lexer module that did not belong to the Django docutils integration.

Breaking changes¶

django_docutils.pygments was removed because Pygments lexers are unrelated to this package’s core purpose (#385).

Development¶

The codebase now passes mypy --strict (#378).

django-docutils 0.13.5 (2023-09-30)¶

django-docutils 0.13.5 removes more leftover project-specific behavior from the role and publisher layer.

Fixes¶

The unused develtech role was removed, and unused positional arguments were removed from publisher internals (#382).

django-docutils 0.13.4 (2023-09-24)¶

django-docutils 0.13.4 updates compatibility with modern Django settings and fixes the docs build setup.

Fixes¶

The package no longer reads Django’s deprecated FILE_CHARSET setting, which was deprecated in Django 3.1 (#381).

Documentation¶

The Sphinx configuration and settings warning were fixed so documentation builds cleanly (#380).

django-docutils 0.13.3 (2023-09-24)¶

django-docutils 0.13.3 removes stale pagination arguments left behind by the earlier cleanup of page-related features.

Fixes¶

Unused page-number parameters were removed from publish_toc_from_doctree() and publish_html_from_doctree() (#379).

django-docutils 0.13.2 (2023-09-10)¶

django-docutils 0.13.2 is a targeted class-based-view fix.

Fixes¶

RSTMixin now handles .content without missing parameters.

django-docutils 0.13.1 (2023-09-10)¶

django-docutils 0.13.1 follows the debloating releases with CI and warning cleanup.

Development¶

CI now checks Black formatting, Poetry was updated from 1.5.1 to 1.6.1, and the test suite no longer emits Django 4.1+ deprecation warnings (#377).

django-docutils 0.13.0 (2023-09-10)¶

django-docutils 0.13.0 is the second debloating release. It removes dependency weight and a remote Amazon role that did not fit the core package goal: solid docutils rendering for Django.

Breaking changes¶

Unused runtime and test dependencies were removed (#376)¶

Dependencies tied to removed ORM and URL-shortening features were dropped, including django_slug_processor, django-randomslugfield, django-dirtyfields, django-extensions, bitly-api-py3, and lxml.

Unused development dependencies were also removed, including types-tqdm, types-six, types-requests, factory-boy, pytest-factory-boy, and pytest-mock. pytz became optional.

The `:amzn:` role was removed (#376)¶

The Amazon role depended on bitly-api-py3, which was unrelated to Django docutils rendering and pulled the package away from its focused scope.

django-docutils 0.12.0 (2023-09-10)¶

django-docutils 0.12.0 is the first debloating release after the package was split out from a more specialized codebase. It removes ORM-backed content features, ad-related hooks, old based naming, and dependencies that were not needed for reStructuredText rendering in Django.

Breaking changes¶

ORM-specific features were removed (#374)¶

favicon, references, and rst_post were removed because they were application-specific ORM features rather than docutils integration primitives. Related ad hooks such as inject_ads, add_keywords, and BASED_ADS were also removed (fixes #371 and #372).

Settings moved from `BASED_` to `DJANGO_DOCUTILS_` (#374)¶

Old based setting prefixes were renamed to the package name.

# Before
BASED_LIB = {...}

# After
DJANGO_DOCUTILS_LIB = {...}

`tqdm` and `tldextract` were removed from the core dependency set (#374)¶

These packages were not required for rendering reStructuredText content in Django (fixes #363).

django-docutils 0.11.0 (2023-09-10)¶

django-docutils 0.11.0 improves linting consistency with Ruff and includes a post-release formatting pass.

Development¶

Ruff gained additional rules, including import sorting (#368).

Post releases¶

django-docutils 0.11.0post0 (2023-09-10)¶

The codebase was run through Black formatting.

django-docutils 0.10.0 (2023-09-02)¶

django-docutils 0.10.0 is a maintenance release that starts consolidating formatting, linting, and package metadata around modern Python tooling. It also adds Django 4.2 and Python 3.11 metadata.

Development¶

Formatting, import sorting, and linting moved to Ruff, replacing isort, flake8, and related flake8 plugins with a faster Rust-based tool.

Tests no longer rely on pytest’s deprecated py.local.path objects and use pathlib.Path instead (#369). Partial, incorrect, or unused typings were removed to make room for stricter typing work later.

Dependencies¶

pytz was added as a required dependency because newer Django versions no longer include it implicitly.

Packaging¶

MANIFEST.in and .readthedocs.yml were removed because Poetry and the self-hosted docs workflow own those concerns. Poetry moved from 1.4.0 to 1.5.1, Django 4.2 was added to CI and classifiers, and Python 3.11 was added to classifiers.

django-docutils 0.9.0 (2022-09-24)¶

django-docutils 0.9.0 trims default installation weight and speeds up CI. It is mostly a packaging and infrastructure release.

Breaking changes¶

tqdm and tldextract are no longer installed by default, simplifying installs for users that only need the core rendering path (#362).

Development¶

CI was split so the PyPI upload image is not pulled on normal test runs, and CodeQL configuration was cleaned up (#361). Poetry moved from 1.1.x to 1.2.x.

Packaging¶

The obsolete .tmuxp-before-script.sh helper was removed.

django-docutils 0.8.0 (2022-09-11)¶

django-docutils 0.8.0 moves the package into a src/ layout and improves docs rendering through gp-libs Sphinx helpers.

Development¶

The project moved to src/ layout (#356). flake8-bugbear and flake8-comprehensions were added to development checks (#352, #353).

Documentation¶

The changelog is rendered with issue links, and the docs gained a fix for Sphinx autodoc table-of-contents rendering (#350, #355).

django-docutils 0.7.0 (2022-08-16)¶

django-docutils 0.7.0 adds the first static typing and doctest validation infrastructure. It is a development-quality release rather than a feature release for Django users.

Development¶

Doctest support and initial mypy validation were added (#342). CI gained better Python dependency caching through actions/setup-python, CodeQL analysis was added, and pre-commit configuration was removed from the repository.

The codebase was reformatted with Black without --skip-string-normalization, and development package pins were refreshed.

django-docutils 0.6.0 (2022-03-27)¶

django-docutils 0.6.0 updates the supported Python and Django baseline and refreshes the docs stack.

Breaking changes¶

Python 3.5, 3.6, and 3.7 support was dropped. Python 3.8 became the minimum supported Python version, and Django 3.0 became the minimum supported Django version.

Development¶

CI variables, Poetry installation, dependency caching, and the docs publishing workflow were cleaned up.

Documentation¶

The documentation moved to Markdown and the Furo theme.

django-docutils 0.5.1 (2020-08-09)¶

django-docutils 0.5.1 fixes packaging around optional dependencies after the 0.5.0 project-management migration.

Fixes¶

Packaging and optional dependencies were corrected (#270). The twine extra and legacy setup.py were removed because Poetry now builds and publishes the package.

django-docutils 0.5.0 (2020-08-08)¶

django-docutils 0.5.0 modernizes the project after the early Django/Python 2 era. It moves packaging, docs hosting, CI, formatting, and supported framework versions onto the stack used by later releases.

Breaking changes¶

Python 2, Python 3.3, and Python 3.4 support was removed. Unsupported Django versions 1.8, 1.9, 1.10, 2.0, and 2.1 were removed, while newer Django 2.2 and 3.0-era support was added.

What’s new¶

Font Awesome pattern detection and injection landed through the InjectFontAwesome transformer and related transformers such as XRefTransform. These APIs were later removed when the package was narrowed to core docutils rendering.

Development¶

The project moved from pipenv to Poetry, Travis CI to GitHub Actions, and Read the Docs to self-hosted documentation. Black and isort were added and the codebase was formatted with them. Vulture was removed.

Dependencies¶

The package switched to the bitly-api-py3 fork used by the older URL-shortener integration.

django-docutils 0.4.0 (2017-02-21)¶

django-docutils 0.4.0 adds the original Django template tag surface and basic README documentation.

What’s new¶

The first Django template tag for rendering reStructuredText through docutils was added.

Documentation¶

The README gained initial usage documentation.

django-docutils 0.3.4 (2017-02-12)¶

django-docutils 0.3.4 is a packaging repair release.

Fixes¶

requirements/test.txt was added to the package manifest.

django-docutils 0.3.3 (2017-02-12)¶

django-docutils 0.3.3 is a packaging repair release.

Fixes¶

requirements/base.txt was added to the package manifest.

django-docutils 0.3.2 (2017-02-12)¶

django-docutils 0.3.2 is a PyPI README repair release.

Fixes¶

Another PyPI README rendering adjustment was shipped.

django-docutils 0.3.1 (2017-02-12)¶

django-docutils 0.3.1 is a PyPI README repair release.

Fixes¶

The package metadata was adjusted to improve PyPI README rendering.

django-docutils 0.3.0 (2017-02-12)¶

django-docutils 0.3.0 updates package metadata and release packaging.

Fixes¶

Package updates and packaging fixes were shipped.

django-docutils 0.2.0 (2017-01-01)¶

django-docutils 0.2.0 adds support for the then-current Django 1.10 release.

What’s new¶

Django 1.10.0 support was added.

django-docutils 0.1.0 (2015-06-20)¶

django-docutils 0.1.0 is the first PyPI release.

What’s new¶

The package was published to PyPI for the first time.

Changelog¶

django-docutils 0.31.0 (unreleased)¶

django-docutils 0.30.0 (2026-06-07)¶

Breaking changes¶

Docutils rendering is locked down by default (#457)¶

Fixes¶

Documentation¶

Documentation rebuilt around Django workflows (#451)¶

Faster self-hosted docs frontend (#450)¶

Shared gp-sphinx documentation stack (#452, #453, #454, #455)¶

Development¶

Development commands moved to Just (#448)¶

django-docutils 0.29.0 (2025-11-01)¶

Breaking changes¶

Minimum Python is 3.10 (#443)¶

Dependencies¶

Documentation¶

Development¶

django-docutils 0.28.0 (2024-12-20)¶

Breaking changes¶

Minimum Python is 3.9 (#439)¶

Dependencies¶

Development¶

django-docutils 0.27.0 (2024-11-26)¶

Breaking changes¶

Django 4.2 is the minimum supported Django (#430)¶

Project management moved from Poetry to uv (#435)¶

Build backend moved to hatchling (#435)¶

Development¶

django-docutils 0.26.0 (2024-07-20)¶

Breaking changes¶

Documentation¶

Development¶

django-docutils 0.25.0 (2024-03-24)¶

Development¶

django-docutils 0.24.0 (2024-03-09)¶

Fixes¶

django-docutils 0.23.0 (2024-02-06)¶

Dependencies¶

Development¶

django-docutils 0.22.1 (2023-12-24)¶

Fixes¶

django-docutils 0.22.0 (2023-12-24)¶

Breaking changes¶

Role and directive registration moved to registry modules (#409)¶

What’s new¶

Settings updates re-register roles and directives (#408)¶

Development¶

django-docutils 0.21.0 (2023-12-09)¶

Dependencies¶

Development¶

django-docutils 0.20.1 (2023-11-18)¶

Development¶

django-docutils 0.20.0 (2023-11-18)¶

What’s new¶

Formatting moved from Black to Ruff (#406)¶

Fixes¶

Development¶

django-docutils 0.19.0 (2023-10-08)¶

Breaking changes¶

Template engine imports moved to django_docutils.template (#402)¶

Documentation¶

django-docutils 0.18.0 (2023-10-08)¶

Fixes¶

Documentation¶

Development¶

django-docutils 0.17.0 (2023-10-08)¶

Breaking changes¶

Documentation¶

django-docutils 0.16.0 (2023-10-07)¶

Breaking changes¶

Documentation¶

django-docutils 0.15.0 (2023-10-01)¶

Breaking changes¶

restructuredtext was renamed to rst (#390)¶

Template tags moved into templatetags.django_docutils (#391)¶

What’s new¶

{% rst %} can render block content (#392)¶

The rst filter uses the same publisher as the tag (#388)¶

Fixes¶

Template engine imports moved to `django_docutils.template` (#402)¶

`restructuredtext` was renamed to `rst` (#390)¶

Template tags moved into `templatetags.django_docutils` (#391)¶

`{% rst %}` can render block content (#392)¶

The `rst` filter uses the same publisher as the tag (#388)¶

The `:amzn:` role was removed (#376)¶

Settings moved from `BASED_` to `DJANGO_DOCUTILS_` (#374)¶

`tqdm` and `tldextract` were removed from the core dependency set (#374)¶