Skip to main content

scverse-doc

The shared Sphinx theme and documentation configuration for scverse packages.

Install it, and a package's conf.py becomes:

extensions = ["scverse_doc"]

source_repository = "https://github.com/scverse/pertpy"

That gets you the scverse brand and dark mode, the shared sidebar layout, footer, and announcement banner, a "scverse packages" dropdown generated from the package registry, cross-links to every core package, the repository links ("edit this page" and the header icon), and the standard extension stack.

Every piece also works on its own. For the theme without the extension stack or the shared defaults, select it and leave extensions alone – it is a registered Sphinx theme, so installing the package is enough:

html_theme = "scverse"

source_repository = "https://github.com/scverse/pertpy"

Getting started

Please refer to the documentation, in particular, the API documentation. The kitchen sink shows every construct the theme styles, in both colour schemes.

Installation

You need to have Python 3.12 or newer installed on your system. If you don't have Python installed, we recommend installing uv.

We recommend managing dependencies in project-specific virtual environments to avoid dependency conflicts. This is most convenient using package managers such as uv. Choose from the options below to install scverse-doc:

  1. Add the latest release of scverse-doc from PyPI to your uv project:

    uv add 'scverse-doc[full]'
    
  2. Install the latest release into a standard virtual environment:

    (after activating your venv)
    pip install 'scverse-doc[full]'
    
  3. Install the latest development version:

    pip install 'scverse-doc[full] @ git+https://github.com/scverse/scverse-doc.git'  # (or `uv add`)
    

The full extra is what extensions = ["scverse_doc"] needs. For less, pick from the theme extra (for html_theme = "scverse") and the config extra (for scverse_doc.config’s extension stack). scverse_doc.autodoc, scverse_doc.napoleon, scverse_doc.registry and scverse_doc.source need no extra.

Release notes

See the changelog.

Contact

For questions and help requests, you can reach out in the scverse discourse. If you found a bug, please use the issue tracker.

Citation

t.b.a

Metadata

Release files for scverse-doc 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for scverse-doc 0.2.2
File Size Uploaded Provenance
scverse_doc-0.2.2.tar.gz 49.1 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for scverse-doc 0.2.2
File Interpreter ABI Platform
scverse_doc-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 94.6 kB

Release files / scverse_doc-0.2.2.tar.gz

Download URL scverse_doc-0.2.2.tar.gz
Size 49.1 kB
Tags Source
SHA-256 checksum
How to use checksums
b0ac5d7f7f4c6931195f6ed611b858043af75234488521aafeb2c7915421be72
BLAKE2b-256 checksum
How to use checksums
68a0b4767e0ca623ccb69015968a77620581f0d74a9099f12551b85375bcc2b6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Release files / scverse_doc-0.2.2-py3-none-any.whl

Download URL scverse_doc-0.2.2-py3-none-any.whl
Size 45.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4f8a4a3ce8738fab6cd7af17a5033690108f53a963522b0d06c735156a358d41
BLAKE2b-256 checksum
How to use checksums
18d4177d2f46ae79db11cb4210ac8b08f5a4d56168fd549a2d5efff6fb8f48cc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Security for scverse-doc 0.2.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for scverse_doc-0.2.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page