Skip to main content

A cool theme for sphinx documentation

Project description

PdJ Sphinx Theme

This theme is a theme for sphinx documentation based on the read the docs theme.

It supports light and dark modes first using prefers-color-scheme with an option to change the mode. If changed the decision will be remembered.

To install it, use pip:

$ pip install sphinx_pdj_theme

To enable it in your project documentation, set the following in your conf.py file.

import sphinx_pdj_theme
html_theme = 'sphinx_pdj_theme'
htm_theme_path = [sphinx_pdj_theme.get_html_theme_path()]

Logo and favicon

To change the logo and the favicon use the following options:

html_logo = 'path/to/logo.svg'
html_favicon = 'path/to/favicon.ico'

To set the logo's width and height use the logo_width and logo_height theme options

html_theme_options = {
    'logo_width': '200px',
    'logo_height': '150px',
}

Other options

To hide the search bar set the search option to hide

html_theme_options = {
	'search': 'hide'
}

To hide the name of the project above the search bar set the home_link option to hide

html_theme_options = {
	'home_link': 'hide'
}

Screenshots

defaulf darker

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-pdj-theme-0.4.0.tar.gz (236.1 kB view hashes)

Uploaded Source

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