Skip to main content

A Sphinx theme for Renku documentation.

Project description

A Sphinx theme for Renku documentation based on RTD theme.


  1. Add renku-sphinx-theme to or requirements.txt used for building your documentation.

  2. Set html_theme to 'renku' in docs/

  3. Configure at least description and github_repo in html_theme_options.

Enjoy your beautiful Renku documentation style.

Style (css)

This repo contains a scss file that generates a css file. The css file shouldn’t be manually modified since it’s generated with the scss. Instructions to change and run the scss file are inside the scss file.

The easy way of doing style changes in this repository is to go to the renku repo, add a temporary css (custom.css) in the docs/ file and follow this steps:

The reason for this is that renku docs is a better repository for testing changes.

After doing the changes in the temporary css add this to custom.scss in this repository, build this into a css file using the instructions and commit the css and scss files.


To build docs after doing changes, and test things inside this repository

  1. From the base folder… pip install -r docs/requirements.txt

  2. This should be done in case there where changes in fonts or new css files added pip install --editable .

  3. There is no Makefile here but in order to do the “make html” action you should do

    cd docs sphinx-build -b html -d _build/doctrees . _build/html

Docs will be built into _build/html... open this files with chrome to see the changes.


After doing changes, a new release should be published in pypi under the sdsc-org account.

To release a new version, change the version inside, do step 1 and 2 of Building. Then do python3 -m twine upload dist/* and the new release will be published on pypi.


0.2.3 (2023-04-26)

  • chore: add dependabot.yml (76baee5)

  • chore: remove dependency on non-existent compile-scss (617e566)

  • chore: fix pypi description (23536d9)

  • chore(deps): update sphinx-rtd-theme requirement (2ca96ca)

  • chore: bump python version (0dd1fe6)

  • chore: delete layout.html (5fa988d)

  • fix: update styles to fix sidebar background leaking into main content (5ab737b)

0.2.2 (2021-07-09)

  • design: new design for renku-sphinx (3cf7ec7)

  • chore: replace travis CI with github actions (4056830)

0.1.0 (2018-05-17)

  • Initial public release.

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

renku-sphinx-theme-0.2.3.tar.gz (586.5 kB view hashes)

Uploaded Source

Built Distribution

renku_sphinx_theme-0.2.3-py2.py3-none-any.whl (579.9 kB view hashes)

Uploaded Python 2 Python 3

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