README.rst

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.

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.