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:
Install the package using pip: pip install groundwork-sphinx-theme
Add this to conf.py:
html_theme = 'groundwork'
Configuration
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 conf.py of your sphinx project:
html_theme_options = { "sidebar_width": '240px', "stickysidebar": True, "stickysidebarscrollable": True, "contribute": True, "github_fork": "useblocks/groundwork", "github_user": "useblocks", }
Screenshot
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for groundwork-sphinx-theme-1.0.5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 14ea0ac1bea30c1a88b7b7c36a1a025c2d0bec750da057c1dc49fae8f5b8fde8 |
|
MD5 | e2b458ce4b0f88000f1cbdabc9908383 |
|
BLAKE2b-256 | 1b6d067236b36d05b8f0d7341ae6d855e893388da3a39b51ee66fd785dab9cfb |