Cards and tabs provide some extra UI flexibility for your content. Both sphinx-design and sphinx-panels can be used with this theme. This theme provides custom CSS to ensure that their look and feel is consistent with this theme.
.. seealso:: For more about how to use these extensions, see `the sphinx-design documentation <https://sphinx-design.readthedocs.io/en/latest/index.html>`_.
!DANGER!
sphinx-panels
is no longer maintained and we recommend you switch to sphinx-design
.
We will deprecate support for sphinx-panels soon.
To use the sphinx-panels
extention, add these lines to your custom CSS to overwrite the shadows of the panels:
/* overwrite panels shadows using pydata-sphinx-theme variable */
.shadow {
box-shadow: 0 0.5rem 1rem var(--pst-color-shadow) !important;
}
This modification is not needed when using the sphinx-design
extention.
Below you can find some examples of the components created with the sphinx-design
extension.
Here are some of the available badges: :bdg-primary:`primary` :bdg-secondary:`secondary` :bdg-success:`success` :bdg-primary-line:`primary outline` :bdg-secondary-line:`secondary outline` :bdg-success-line:`success outline`
Here are some buttons, also using semantic color names. Note: in this theme, info
is defined to be the same color as primary
, and warning
is the same color as secondary
.
If in your site's custom CSS file you override the CSS custom properties --pst-color-*
(where *
is one of the semantic color names, e.g., primary
, danger
, etc), badges and buttons will automatically use the custom color.
.. grid:: auto .. grid-item:: .. button-ref:: badges-buttons :ref-type: ref :color: info :shadow: Info .. grid-item:: .. button-ref:: badges-buttons :ref-type: ref :color: warning :shadow: Warning .. grid-item:: .. button-ref:: badges-buttons :ref-type: ref :color: danger :shadow: Danger .. grid-item:: .. button-ref:: badges-buttons :ref-type: ref :color: muted :shadow: Muted
.. grid:: .. grid-item-card:: Only heading .. grid-item-card:: Only body. But with multiple text paragraphs. .. grid-item-card:: Heading and body Content of the third card. :bdg-primary:`example`
.. grid:: .. grid-item-card:: A card with a dropdown menu .. dropdown:: :fa:`eye,mr-1` third card Hidden content .. grid-item-card:: A clickable card :link: https://example.com
.. grid:: .. grid-item-card:: panel 1 header ^^^^^^^^^^^^^^ panel 1 content more content ++++++++++++++ panel 1 footer .. grid-item-card:: panel 2 header ^^^^^^^^^^^^^^ panel 2 content ++++++++++++++ panel 2 footer
.. tab-set:: .. tab-item:: c++ .. code-block:: c++ int main(const int argc, const char **argv) { return 0; } .. tab-item:: python .. code-block:: python def main(): return .. tab-item:: java .. code-block:: java class Main { public static void main(String[] args) { } } .. tab-item:: julia .. code-block:: julia function main() end .. tab-item:: fortran .. code-block:: fortran PROGRAM main END PROGRAM main
Dropdowns should look similar to admonitions, but clickable. See the Sphinx Design Dropdown documentation for more information.
An admonition for reference.
And some admonition content.
.. dropdown:: And with no title and some content!
.. dropdown:: With a title And some content!
.. dropdown:: With a title :icon: unlock And some content and an icon!
.. dropdown:: A primary title and color :color: primary :icon: unlock And some content!
.. dropdown:: A secondary title and color :color: secondary :icon: unlock And some content!
sphinx-copybutton adds a copy button to each of your code cells. You can see it in action by hovering over the code cell below:
print("A copybutton in the top-right!")
sphinx-togglebutton allows you to convert admonitions into toggle-able elements.
Click me to toggle!
This will be hidden until a click!
.. toggle:: A standalone toggle button!