Skip to main content
`Ctrl`+`K`
⚠️The latest release refactored our HTML, so double-check your custom CSS rules!⚠️

# Sphinx extension styles

This page shows of some special-case styling for various Sphinx extensions.

## `sphinxcontrib-bibtex` - References and bibliographies

`sphinxcontrib-bibtex` provides support for citations and bibliographies.

Because this theme deals with scholarly and scientific communication, `sphinxcontrib-bibtex` should work particularly well.

Here’s are a few citations:

- Default citation [Project Jupyter et al., 2018], [Holdgraf et al., 2016, Project Jupyter et al., 2018]. (should be same as parenthetical)

- Parenthetical citation [Project Jupyter et al., 2018], [Holdgraf et al., 2016, Project Jupyter et al., 2018].

- Textual citation Project Jupyter et al. [2018], Holdgraf et al. [2016], Project Jupyter et al. [2018].

And here’s a bibliography:

[1] (1,2,3)

Christopher Ramsay Holdgraf, Wendy de Heer, Brian N. Pasley, Jochem W. Rieger, Nathan Crone, Jack J. Lin, Robert T. Knight, and Frédéric E. Theunissen. Rapid tuning shifts in human auditory cortex enhance speech intelligibility. Nature Communications, 7(May):13654, 2016. URL: http://www.nature.com/doifinder/10.1038/ncomms13654, doi:10.1038/ncomms13654.

[2] (1,2,3,4,5,6)

Project Jupyter, Matthias Bussonnier, Jessica Forde, Jeremy Freeman, Brian Granger, Tim Head, Chris Holdgraf, Kyle Kelley, Gladys Nalvarte, Andrew Osheroff, M Pacer, Yuvi Panda, Fernando Perez, Benjamin Ragan-Kelley, and Carol Willing. Binder 2.0 - Reproducible, interactive, sharable environments for science at scale. In Fatih Akici, David Lippa, Dillon Niederhut, and M Pacer, editors, Proceedings of the 17th Python in Science Conference, 113 – 120. 2018. doi:10.25080/Majora-4af1f417-011.

## `ABlog` - Blog post list

ABlog is a Sphinx extension for blogging with Sphinx.

Here’s a sample post list:

## `sphinx-togglebutton` - Toggle content with buttons

A block toggle:

A block toggle in the margin:

An admonition toggle:

Note

This note will be toggled!

An admonition toggle in the margin

Note

## `sphinx-tabs` - Tabbed content

Apples are green, or sometimes red.

Pears are green.

Oranges are orange.

## `sphinxcontrib.youtube` for videos

`sphinxcontrib.youtube` makes it possible to easily embed videos in your documentation.

## `sphinx-design` for UI components

`sphinx-design` provides various UI components like badges, cards, and dropdowns.

Badge:

Test badge.

Card:

Card header.

Card Title

Card content goes here. This demonstrates how cards look in both light and dark modes.

Dropdown:

Click to expand

This is the dropdown content. It should be readable in both light and dark modes.