Skip to main content

A Sphinx-doc theme based on Vuepress

Project description

romnnn_sphinx_press_theme

Build Status PyPI License PyPI Version PyPI Python versions

See a live demo.

This is a fork of the original sphinx_press_theme by schettino72, which is a modern and responsive theme for python's Sphinx documentation generator.

The theme is based on VuePress and uses Vue.js+ Stylus with webpack.

Usage

First install the theme:

pip install romnnn_sphinx_press_theme

To use the theme, set the theme name to press in your sphinx project's conf.py:

html_theme = "press"

For more information, see the Sphinx theming docs.

Development

  1. Build the web assets:

    cd ui
    npm run build
    

    The generated theme.css, theme.js and theme-vendors.js will be linked into the theme under romnnn_sphinx_press_theme/static.

  2. Install theme locally:

    pip install -e .
    
  3. Review the theme by building the theme's documentation under docs/:

    make docs
    

    Generated html will be in docs/build/html.

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 romnnn-sphinx-press-theme, version 0.5.6
Filename, size File type Python version Upload date Hashes
Filename, size romnnn_sphinx_press_theme-0.5.6.tar.gz (58.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page