PennyLane Sphinx Theme

The PennyLane Sphinx Theme is a Sphinx theme used for open-source PennyLane software projects hosted on https://pennylane.ai. It extends the Xanadu Sphinx Theme with PennyLane-specific default settings and configurations.

To update the PennyLane navigation bar (navbar) and footer, please see the files pennylane_sphinx_theme/footer.py and pennylane_sphinx_theme/navbar.py.

For more details, please see the Xanadu Sphinx Theme documentation.

Installation

The PennyLane Sphinx Theme requires Python 3.7 or later. The latest version of the theme can be installed directly using pip:

pip install pennylane-sphinx-theme

Getting Started

Once installed, simply add or modify the following variables of your Sphinx conf.py configuration file to start using the PennyLane Sphinx Theme:

from pennylane_sphinx_theme import templates_dir
templates_path = [templates_dir()]

html_theme = "pennylane"

html_theme_options = {
    "navbar_name": "Example Project"
}

Configuration

The PennyLane Sphinx Theme supports the same configration options as the Xanadu Sphinx Theme. For more details, please see the Xanadu Sphinx Theme documentation.

Directives

The PennyLane Sphinx Theme provides various directives.

For more details, please see the Xanadu Sphinx Theme documentation.

Release

Make a PR with the desired changes to the PST (pennylane-sphinx-theme).
- Don’t forget to update the CHANGELOG!
- Merge in your PR once it is approved.
Prepare the PST for release.
- Once PR is merged it will trigger the Pre-Release Version Bump workflow.
- The workflow will open a PR Pre-release version bump to X.Y.Z. Adjust the release version number as necessary.
- Merge in the Pre-release version bump to X.Y.Z PR.
Release a new version of the PST.
- Once Pre-release version bump to X.Y.Z PR is merged in it will automatically create new release of PST.
- It will also run the Post-Release Version Bump workflow.
- The workflow will open a Post-release version bump to X.Y.Z PR that can be merged in master to increment the version for next release.

Support

Source Code: https://github.com/XanaduAI/pennylane-sphinx-theme
Issue Tracker: https://github.com/XanaduAI/pennylane-sphinx-theme/issues

If you are having issues, please let us know by posting the issue on our Github issue tracker.

License

The PennyLane Sphinx Theme is free and open source, released under the Apache License, Version 2.0.

Metadata

Release files for pennylane-sphinx-theme 0.32.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pennylane-sphinx-theme 0.32.0
File	Size	Uploaded
pennylane_sphinx_theme-0.32.0.tar.gz	20.8 kB	Sep 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pennylane-sphinx-theme 0.32.0
File	Interpreter	ABI	Platform	Reset
pennylane_sphinx_theme-0.32.0-py3-none-any.whl 21.0 kB Sep 17, 2026	Python 3	none	any	Details

Total release size: 41.8 kB

Release files / pennylane_sphinx_theme-0.32.0.tar.gz

Download URL	pennylane_sphinx_theme-0.32.0.tar.gz
Size	20.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`8ccec5cef9cbd52419e3e375eee8a02e26dbabd286523d5edd39094abde024d1`
BLAKE2b-256 checksum How to use checksums	`40f0c0042c0bf88eb92019a6f258f9e2027cc1b35a0373464831976d8a7bffd8`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/PennyLaneAI/pennylane-sphinx-theme
Publishing commit: github.com/PennyLaneAI/pennylane-sphinx-theme/tree/36f181024971c25c01229b877db6a96ea0e4855b

Workflow

Publishing configuration: github.com/PennyLaneAI/pennylane-sphinx-theme/blob/36f181024971c25c01229b877db6a96ea0e4855b/.github/workflows/upload.yml
Publishing logs: github.com/PennyLaneAI/pennylane-sphinx-theme/actions/runs/35248717201/attempts/1

Artifact

Subject: pennylane_sphinx_theme-0.32.0.tar.gz
SHA-256 checksum: 8ccec5cef9cbd52419e3e375eee8a02e26dbabd286523d5edd39094abde024d1 Verifying attestations

Release files / pennylane_sphinx_theme-0.32.0-py3-none-any.whl

Download URL	pennylane_sphinx_theme-0.32.0-py3-none-any.whl
Size	21.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0c4003ad90cb154ba9d845157a4140bff044194277d486764331bb6c8ad6be44`
BLAKE2b-256 checksum How to use checksums	`fabb1f11bccb1ad1e2123f2b72f009f83442c7520a277a2c91680aa48bf9c60f`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/PennyLaneAI/pennylane-sphinx-theme
Publishing commit: github.com/PennyLaneAI/pennylane-sphinx-theme/tree/36f181024971c25c01229b877db6a96ea0e4855b

Workflow

Publishing configuration: github.com/PennyLaneAI/pennylane-sphinx-theme/blob/36f181024971c25c01229b877db6a96ea0e4855b/.github/workflows/upload.yml
Publishing logs: github.com/PennyLaneAI/pennylane-sphinx-theme/actions/runs/35248717201/attempts/1

Artifact

Subject: pennylane_sphinx_theme-0.32.0-py3-none-any.whl
SHA-256 checksum: 0c4003ad90cb154ba9d845157a4140bff044194277d486764331bb6c8ad6be44 Verifying attestations