Skip to main content

Add comments and annotation to your documentation.

Project description

sphinx-comments

PyPI | Documentation

A small sphinx extension to add a "copy" button to code blocks.

See the sphinx-comments documentation for more details!

Installation

You can install sphinx-comments with pip:

pip install sphinx-comments

Usage

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

extensions = [
    ...
    'sphinx_comments'
    ...
]

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!

Customization

If you'd like to customize the look of the copy buttons, you can over-write any of the CSS rules specified in the sphinx-comments CSS file (link)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinx-comments-0.0.1.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

sphinx_comments-0.0.1-py3-none-any.whl (4.2 kB view details)

Uploaded Python 3

File details

Details for the file sphinx-comments-0.0.1.tar.gz.

File metadata

  • Download URL: sphinx-comments-0.0.1.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/42.0.1.post20191125 requests-toolbelt/0.9.1 tqdm/4.40.0 CPython/3.8.0

File hashes

Hashes for sphinx-comments-0.0.1.tar.gz
Algorithm Hash digest
SHA256 749a444e211ab4fcf561823698e7007d49508e13070cb4b4e2939091a4783d71
MD5 65778804c7577000cbdb92d986b3a0fa
BLAKE2b-256 47543ef82bdc42eb26590405a534e258d73a80078bcfd5ea4dd9ac79893e893d

See more details on using hashes here.

File details

Details for the file sphinx_comments-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: sphinx_comments-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 4.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/42.0.1.post20191125 requests-toolbelt/0.9.1 tqdm/4.40.0 CPython/3.8.0

File hashes

Hashes for sphinx_comments-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cec1db3b1e1704891d281e1e1a0e17c75a83518cff5174f2fa8546656ae9174b
MD5 c4b9bff0ac9d6ec59517e3074ef9ef8b
BLAKE2b-256 c5a5c018b7880f5c1a2303f4437f5561094b8fabc642b04c577acb0e36c18c05

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page