Navigation Bar

The following options customize the appearance of the navigation bar.

navbar_name

Name of the project to appear in the navigation bar.

navbar_wordmark_path

Path to the project wordmark to appear in the navigation bar. Specifying this option will replace the project logo and name in the navigation bar.

navbar_logo_alt

Alternative text to display in lieu of the wordmark or logo in the navigation bar. Defaults to the value of navbar_name.

navbar_logo_path

Path to the project logo that appears in the navigation bar. Defaults to _static/xanadu_logo.svg which points to the generated Xanadu (X) logo logo (see navbar_logo_colour).

navbar_logo_colour

Colour of the auto-generated Xanadu (X) logo (available at _static/xanadu_logo.svg). Defaults to #000000 (i.e., black).

navbar_home_link

Link that is opened when the name or logo on the navigation bar is clicked. Defaults to index.html.

navbar_left_links

Links on the LHS of the navigation bar in the form of a list of dictionaries with the "name", "href", and optionally, "external" and "dropdown" keys.

The "external" key only determines if an “external link” icon should be displayed next to the name of the link in the navbar. Otherwise, the value of the "dropdown" key is another list of dictionaries of the same form (except for the "dropdown" key) and specifies the links which should be displayed in a dropdrown from the current link.

In addition, the "img" key can be used to specify an image to replace the navbar link, alongside "img_width" to specify the width of the image.

navbar_right_links

Links on the RHS of the navigation bar in the form of a list of dictionaries with the "name", "href", and optionally, "icon" keys. If a link does not have an "icon" key, it will be displayed as a solid button.

Table of contents

The following options customize the table of contents.

toc_overview

If True, the project name, and a link to the homepage index.rst, is included in the left-hand table of contents.

toc_global

Whether to show the global table of contents by default via the left sidebar. If False, then the left sidebar will be disabled.

toc_subset

If set to True, and the current page has no local table of contents, the right-hand table of contents will instead display the current subset of the document tree. That is, the right-hand ToC will display the location in the document of the current page. If False, and the current page has no local table of contents, no right-hand ToC will be shown.

relations

If True, then Next and Previous buttons are included at the bottom of every page, allowing navigation according to the table of contents.

Coach mark

The following options control a dismissible toast prompt (“coach mark”) that can be shown near the top of every page, after a short delay. Once dismissed, it stays hidden for the remainder of the browser session.

coach_mark_enabled

If True, the toast coach mark is enabled. Defaults to False.

coach_mark_toast

A dictionary of the form

"coach_mark_toast": {
    "title": "Some title",
    "body": [
        "Some text ",
        {
            "type": "link",
            "text": "a link",
            "href": "https://...",
            "gaLabel": "toast_some_link",
            "isExternal": True,
        },
        " and more text.",
    ],
    "icon": "megaphone",
    "delayMs": 3000,
}

specifying the toast’s content. body is an ordered list of plain text strings and part dictionaries, rendered in the given order. A type of "link" renders an <a> (text, href, gaLabel); set isExternal to open it in a new tab. A type of "action" renders a button (text, gaLabel). Unknown types are ignored. icon is either "megaphone" or "lightbulb". delayMs (default 3000) is the delay, in milliseconds, before the toast is shown after the page loads.

Footer

The following options customize the appearance of the footer.

extra_copyrights

List of extra copyright notices to place in the footer.

footer_about

A dictionary of the form

"footer_about": {
    "title": "Title",
    "icon": "https://...",
    "href": "https://...",
    "description": "Description",
    "created_by": "Created with ❤️ by <a href=\"https://xanadu.ai/\">Xanadu</a>."
}

that specifies the ‘About’ section of the footer middle area. created_by is optional HTML displayed below the description.

footer_newsletter

A dictionary of the form

"footer_newsletter": {
    "title": "Never miss a milestone",
    "description": "Get the latest quantum updates delivered to your inbox.",
    "href": "https://...",
    "cta": "Join the list",
}

specifying the newsletter banner at the top of the footer. Set to an empty dictionary to remove.

footer_xanadu

A dictionary of the form

"footer_xanadu": {
    "title": "Xanadu",
    "icon": "https://...",
    "href": "https://xanadu.ai",
}

specifying the Xanadu logo displayed above the copyright section. Set to an empty dictionary to remove.

footer_copyright

A dictionary of the form

"footer_copyright": {
    "notice": "Optional custom copyright HTML.",
    "tensorflow_notice": "Optional TensorFlow trademark notice.",
}

specifying additional copyright content in the footer bottom section. If notice is omitted, a default PennyLane copyright line is shown.

footer_links

A list of dictionaries of the form

"footer_links": [
    {
        "title": "Column1",
        "links": [
            {
                "name": "Home",
                "href": "https://pennylane.ai/",
            },
            {
                "name": "Learn",
                "href": "https://pennylane.ai/qml",
            }
        ]
    },
    {
        "title": "Column2",
        "links": [...]
    }
]

that specifies footer links. Each top-level dictionary in the list is a separate titled column. Set to an empty list to remove.

footer_social_icons

A list of dictionaries of the form

"footer_social_icons": [
    {
        "name": "Twitter",
        "icon": "fab fa-twitter",
        "href": "https://twitter.com/xanaduai"
    },
    {
        "name": "GitHub",
        "icon": "fab fa-github",
        "href": "https://github.com/XanaduAI"
    },
    ...
]

specifying social media icons. icon should correspond to a Boxicons icon. Set to an empty list to remove.

footer_taglines

Deprecated. Use footer_newsletter instead. A list of dictionaries of the form

"footer_taglines": [
    {
        "text": "Some text",
        "href": "https://..."
    },
    {
        "icon": "Some more text",
        "href": "https://..."
    },
    ...
]

specifying tagline hyperlinks that appear underneath the social media icons. Set to an empty list to remove.

footer_policies

A list of dictionaries of the form

"footer_policies": [
    {
        "text": "Some text",
        "href": "https://..."
    },
    {
        "icon": "Some more text",
        "href": "https://..."
    },
    ...
]

specifying policy hyperlinks that appear at the bottom of the footer. Set to an empty list to remove.

Style Colours

The following options allow the colours of various theme elements to be altered. These should be fully qualified CSS color specifiers such as #004B6B or #444.

border_colour

Border colour of accent rules and table headers.

code_colour

Colour of code blocks and teletype text. Defaults to #8D1A38.

prev_next_button_colour and prev_next_button_hover_colour

Colours of the “Next” and “Previous” navigation buttons located at the bottom of most pages.

social_icon_colour

Colour of the social icons.

table_header_background_colour

Background colour of table headers.

text_accent_colour

Accent colour for text such as download links.

toc_marker_colour

Colour of the marker beside the current ToC entry.

toc_mobile_heading_colour and toc_mobile_heading_background_colour

Text and background colours of the mobile ToC heading.

Community Card

<No example is available yet.>

Details

.. details::
    :title: Usage Details

    In general, the block takes :math:`D` parameters and **must** have the following signature:

    .. code-block:: python

        unitary(parameter1, parameter2, ... parameterD, wires)

    For a block with multiple parameters, ``n_params_block`` is equal to the number of parameters in ``block``.
    For a block with a single parameter, ``n_params_block`` is equal to the length of the parameter array.

Gallery Item

.. gallery-item::
    :description: :doc:`AmplitudeEmbedding <../code/api/pennylane.AmplitudeEmbedding>`
    :figure: _static/templates/embeddings/amplitude.png

Index Card

.. index-card::
    :name: Using PennyLane
    :link: introduction/pennylane.html
    :description: A guided tour of the core features of PennyLane

Related Demo

<No example is available yet.>

Title Card

.. title-card::
    :name: 'lightning.qubit'
    :description: A fast state-vector qubit simulator written in C++
    :link: devices.html

YouTube Video

<No example is available yet.>