Skip to main content

Theme for building HoloViz sites; best when used with nbsite.

Project description

sphinx_holoviz_theme: Theme for building HoloViz sites

Build Status Linux/MacOS Build Status
Latest dev release Github tag
Latest release Github release PyPI version sphinx_holoviz_theme version conda-forge version

What is it?

sphinx_holoviz_theme is the theme that is used when building sites in the HoloViz ecosystem. This theme is best used in conjunction with nbsite. See the nbsite docs for examples.

How to use

To use this theme: pip/conda install sphinx_holoviz_theme and set html_theme to sphinx_holoviz_theme. To control the look and feel, change html_theme_options in conf.py:

html_static_path += ['_static']
html_theme = 'sphinx_holoviz_theme'
html_theme_options = {
    'custom_css': 'site.css',
    'logo': 'nbsite-logo.png',
    'favicon': 'favicon.ico',
    'primary_color': '#F16A25',
    'primary_color_dark': '#B5501C',
    'secondary_color': '#F5C33C',
    'second_nav': False,
}
  • logo and favicon: provide paths relative to html_static_path (doc/_static by default)
  • primary_color, primary_color_dark and secondary_color: control the colors that the website uses for header, nav, links... These can be css named colors, or hex colors.
  • second_nav: Boolean indicating whether to use a second nav bar.
  • custom_css: path relative to html_static_path overriding styles. Styles come first from the theme's main.css_t, which is populated with the colors options, then extended/overridden by your site's own css.

NOTE: Only use the custom_css to overwrite small pieces of the css not to make general improvements. If you have general improvements, please open a PR on the this repo.

About HoloViz

sphinx_holoviz_theme is part of the HoloViz ecosystem for making high-level tools to simplify visualization in Python. See holoviz.org for related packages that you can use with sphinx_holoviz_theme and status.pyviz.org for the current status of each HoloViz project.

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 sphinx-holoviz-theme, version 0.1.4
Filename, size File type Python version Upload date Hashes
Filename, size sphinx_holoviz_theme-0.1.4-py2.py3-none-any.whl (41.8 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size sphinx_holoviz_theme-0.1.4.tar.gz (24.2 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