Source code for xanadu_sphinx_theme

"""
This module registers the Xanadu Sphinx Theme. For more information, see
https://www.sphinx-doc.org/en/master/development/theming.html
"""
from pathlib import Path

from importlib_resources import files

from ._version import __version__
from .directives import (
    BioDirective,
    CommunityCardDirective,
    DetailsDirective,
    GalleryItemDirective,
    IndexCardDirective,
    RelatedDemoDirective,
    TitleCardDirective,
    YouTubeVideoDirective,
)


def templates_dir():
    """Returns the directory path containing provided Autosummary
    templates.

    To use this in your theme, add the following to your ``conf.py``
    configuration file:

    .. code-block:: python

        import xanadu_sphinx_theme
        templates_path = [xanadu_sphinx_theme.templates_dir()]
    """
    return str(files("xanadu_sphinx_theme").joinpath("templates"))


def setup(app):
    """See https://www.sphinx-doc.org/en/master/extdev/appapi.html."""
    cwd = Path(__file__).resolve().parent
    app.add_html_theme("xanadu", str(cwd))

    # set default footer sections
    for section in ["about", "links", "policies", "social_icons", "taglines"]:
        if f"footer_{section}" not in app.config["html_theme_options"]:
            app.config["html_theme_options"][f"footer_{section}"] = XANADU_FOOTER[
                f"footer_{section}"
            ]

    directives = {
        "bio": BioDirective,
        "community-card": CommunityCardDirective,
        "details": DetailsDirective,
        "gallery-item": GalleryItemDirective,
        "index-card": IndexCardDirective,
        "related": RelatedDemoDirective,
        "title-card": TitleCardDirective,
        "youtube-video": YouTubeVideoDirective,
    }
    for name, cls in directives.items():
        app.add_directive(name, cls)


XANADU_FOOTER = {
    "footer_about": {
        "title": "Xanadu",
        "icon": "_static/xanadu_logo.svg",
        "href": "https://xanadu.ai",
        "description": """\
        Located in the heart of downtown Toronto, we've brought together
        exceptional minds from around the world to build quantum computers
        that are useful and available to people everywhere.
        """,
    },
    "footer_links": [
        {
            "title": "PennyLane",
            "links": [
                {
                    "name": "Home",
                    "href": "https://pennylane.ai/",
                },
                {
                    "name": "Learn",
                    "href": "https://pennylane.ai/qml",
                },
                {
                    "name": "Demonstrations",
                    "href": "https://pennylane.ai/qml/demonstrations.html",
                },
                {
                    "name": "Documentation",
                    "href": "https://docs.pennylane.ai/",
                },
                {
                    "name": "GitHub",
                    "href": "https://github.com/PennyLaneAI/pennylane",
                },
                {
                    "name": "Twitter",
                    "href": "https://twitter.com/pennylaneai",
                },
                {
                    "name": "Blog",
                    "href": "https://pennylane.ai/blog",
                },
            ],
        },
        {
            "title": "Strawberry Fields",
            "links": [
                {
                    "name": "Home",
                    "href": "https://strawberryfields.ai/",
                },
                {
                    "name": "Photonics",
                    "href": "https://strawberryfields.ai/photonics",
                },
                {
                    "name": "Demonstrations",
                    "href": "https://strawberryfields.ai/photonics/demonstrations.html",
                },
                {
                    "name": "Documentation",
                    "href": "https://strawberryfields.readthedocs.io/",
                },
                {
                    "name": "GitHub",
                    "href": "https://github.com/XanaduAI/strawberryfields",
                },
            ],
        },
        {
            "title": "Xanadu",
            "links": [
                {
                    "name": "Home",
                    "href": "https://xanadu.ai/",
                },
                {
                    "name": "About",
                    "href": "https://xanadu.ai/about/",
                },
                {
                    "name": "Hardware",
                    "href": "https://xanadu.ai/photonics",
                },
                {
                    "name": "Careers",
                    "href": "https://xanadu.ai/careers/",
                },
                {
                    "name": "Forum",
                    "href": "https://discuss.pennylane.ai/",
                },
                {
                    "name": "Blog",
                    "href": "https://xanadu.ai/blog",
                },
            ],
        },
    ],
    "footer_social_icons": [
        {
            "name": "Twitter",
            "icon": "bx bxl-twitter",
            "href": "https://twitter.com/xanaduai",
        },
        {
            "name": "GitHub",
            "icon": "bx bxl-github",
            "href": "https://github.com/XanaduAI",
        },
        {
            "name": "LinkedIn",
            "icon": "bx bxl-linkedin",
            "href": "https://linkedin.com/company/xanaduai/",
        },
        {
            "name": "Discourse",
            "icon": "bx bxl-discourse",
            "href": "https://discuss.pennylane.ai",
        },
        {
            "name": "Slack",
            "icon": "bx bxl-slack",
            "href": "https://u.strawberryfields.ai/slack",
        },
        {
            "name": "RSS",
            "icon": "bx bx-rss",
            "href": "https://xanadu.ai/blog",
        },
    ],
    "footer_taglines": [
        {
            "text": "Stay updated with our newsletter",
            "href": "https://xanadu.us17.list-manage.com/subscribe?u=725f07a1d1a4337416c3129fd&id=294b062630",
        },
    ],
    "footer_policies": [],
}

_modules/xanadu_sphinx_theme

 

Download Python script

 

Download Notebook

 

View on GitHub