Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Sphinx theme for groundwork projects (Based on flask_theme)

Project description

This repository contains sphinx styles, which are use by most groundwork related projects. It is a derivative of Kenneth Reitz’s themes for his projects and of Mitsuhiko’s themes for Flask and Flask related projects. To use this style in your Sphinx documentation, follow this guide:

  1. Install the package using pip: pip install groundwork-sphinx-theme

  2. Add this to

    html_theme = 'groundwork'


The groundwork-sphinx-theme provides the following configuration parameters:

  • sidebar_width: Allows the user to set the sidebar width in pixels. Good for deeply nested TOCs (Default: 220x)
  • stickysidbar: If True it makes the sidebar always visible if pages get longer (Default: True)
  • stickysidbarscrollable: Makes the sticky sidebar scrollable in small browser windows (Default: False)
  • contribute: If True, a contribute-area with github-buttons is shown inside the sidebar
  • github_user: Used the for github follow button. E.g.: useblocks
  • github_fork: Used for the github fork buttons. E.g.: useblocks/groundwork

You can change their value inside the file of your sphinx project:

html_theme_options = {
    "sidebar_width": '240px',
    "stickysidebar": True,
    "stickysidebarscrollable": True,
    "contribute": True,
    "github_fork": "useblocks/groundwork",
    "github_user": "useblocks",


screenshot of groundwork sphinx theme

Project details

Download files

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

Files for groundwork-sphinx-theme, version 1.1.1
Filename, size File type Python version Upload date Hashes
Filename, size groundwork_sphinx_theme-1.1.1-py2.py3-none-any.whl (26.9 kB) File type Wheel Python version 3.6 Upload date Hashes View
Filename, size groundwork-sphinx-theme-1.1.1.tar.gz (26.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page