Sphinx-copybutton#

Documentation PyPi page Conda Version

Sphinx-copybutton does one thing: add a little “copy” button to the right of your code blocks. That’s it! It is a lightweight wrapper around the excellent (and also lightweight) Javascript library ClipboardJS.

Here’s an example

Copy Button Demo

And here’s a code block, note the copy button to the right!

copy me!

If the code block overlaps to the right of the text area, you can just click the button to get the whole thing.

123456789123456789123456789123456789123456789123456789123456789123456789123456789123456789123456789123456789123456789123456789123456789123456789123456789123456789

You can configure sphinx-copybutton to detect input prompts in code cells, and then both remove these prompts before copying, as well as skip lines that don’t start with prompts (in case they are output lines).

For example, this site has been configured to strip Python prompts (“>>> “) and output lines. Try copy-pasting the code block below.

>>> a = 2
>>> print(a)
2
>>>
>>> b = 'wow'
>>> print(b)
wow

Install#

You can install sphinx-copybutton with pip:

pip install sphinx-copybutton

Or with conda via conda-forge:

conda install -c conda-forge sphinx-copybutton

Here’s a link to the sphinx-copybutton GitHub repository.

Use#

In your conf.py configuration file, add sphinx_copybutton to your extensions list. E.g.:

extensions = [
    ...
    'sphinx_copybutton'
    ...
]

When you build your site, your code blocks should now have little copy buttons to their right. Clicking the button will copy the code inside!

See Use and customize for more information about how to use sphinx-copybutton.

Inspiration#

The UI and design elements of sphinx-copybutton are heavily inspired by GitHub’s design choices. The icon we use is from Tabler’s icons set.