This extension is deprecated.

canonical-sphinx 0.7.0 will be the final major release of this extension. It will receive security and bug fixes through the end of the 27.04 release cycle, when development will cease entirely.

All Canonical Sphinx projects should now use the Ulwazi theme. Please make the switch at your nearest convenience. Guidance is available in Switch to the Ulwazi theme.

canonical-sphinx

Extension and theme to create great Canonical-branded documentation.

Description

This project is a Sphinx extension that simplifies the installation of a group of Sphinx extensions recommended by Canonical. It also provides a design override of the Furo theme for the creation of Canonical-branded documentation.

This extension provides a minimal installation by default, and also offers a [full] optional installation which provides significant additional functionality for Sphinx-based documentation. This extension, when installed and added to extensions within the configuration file of a Sphinx deployment, bundles various extensions together and sets default configuration values, eliminating the need to list the extensions in the extensions section of the Sphinx configuration and reducing the need to configure the bundled extensions.

The default extensions bundled into canonical-sphinx are:

Furo
MyST Parser
linkify-it-py - required for specific MyST Parser functionality.

The optional extensions bundled into canonical-sphinx using the [full] optional installation are:

Using canonical-sphinx

To use canonical-sphinx in your project:

Install canonical-sphinx.

This can be done via PyPI, or by using the package available in the canonical-sphinx repository.
Add canonical-sphinx to your Sphinx configuration file.

For example:
```
extensions = [
   ...,
   "canonical_sphinx",
]
```
Do not add any of the bundled extensions to this configuration. They will be automatically added when Sphinx generates documentation.
(Optional) Add additional configuration to your Sphinx configuration file if you need to overwrite any defaults configured by canonical-sphinx.

Using a subset of packages

canonical-sphinx will identify and configure defaults for any package from the [full] installation.

For example, using the following requirements.txt file:

canonical-sphinx
sphinx-copybutton
sphinxcontrib-jquery

With canonical-sphinx included in your project's conf.py extensions:

extensions = [
    "canonical_sphinx",
]

Sphinx will configure and add defaults for sphinx-copybutton and sphinxcontrib-jquery. The rest of the extensions from the optional [full] installation will be ignored.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

canonical_sphinx-0.7.0.tar.gz (1.1 MB view details)

Uploaded Sep 2, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

canonical_sphinx-0.7.0-py3-none-any.whl (1.0 MB view details)

Uploaded Sep 2, 2026 Python 3

File details

Details for the file canonical_sphinx-0.7.0.tar.gz.

File metadata

Download URL: canonical_sphinx-0.7.0.tar.gz
Upload date: Sep 2, 2026
Size: 1.1 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for canonical_sphinx-0.7.0.tar.gz
Algorithm	Hash digest
SHA256	`960033d106a77cb1b6520e4cf8c06936bc116a4249f1125973ac1c6b35e6c085`
MD5	`e0b8722acfe1d429e9cc01c8344e26da`
BLAKE2b-256	`5a1186481a8df0c67b06085a74dfb9c50f66bddeb18df6bff19bd503947f0d94`

See more details on using hashes here.

Provenance

The following attestation bundles were made for canonical_sphinx-0.7.0.tar.gz:

Publisher: release-publish.yaml on canonical/canonical-sphinx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: canonical_sphinx-0.7.0.tar.gz
- Subject digest: 960033d106a77cb1b6520e4cf8c06936bc116a4249f1125973ac1c6b35e6c085
- Sigstore transparency entry: 2690961844
- Sigstore integration time: Sep 2, 2026
Source repository:
- Permalink: canonical/canonical-sphinx@f4544ea7c356c6eee4f57967fdbc516e4c146e0b
- Branch / Tag: refs/tags/0.7.0
- Owner: https://github.com/canonical
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: self-hosted
- Publication workflow: release-publish.yaml@f4544ea7c356c6eee4f57967fdbc516e4c146e0b
- Trigger Event: push