..
Copyright 2017 Swiss Data Science Center (SDSC)
A partnership between École Polytechnique Fédérale de Lausanne (EPFL) and
Eidgenössische Technische Hochschule Zürich (ETHZ).
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
=================================
Sphinx Theme for Renku Projects
=================================
.. image:: https://github.com/SwissDataScienceCenter/renku-sphinx-theme/actions/workflows/test.yml/badge.svg
:target: https://github.com/SwissDataScienceCenter/renku-sphinx-theme/actions?query=branch%3Amaster
.. image:: https://img.shields.io/github/tag/SwissDataScienceCenter/renku-sphinx-theme.svg
:target: https://github.com/SwissDataScienceCenter/renku-sphinx-theme/releases
.. image:: https://img.shields.io/pypi/dm/renku-sphinx-theme.svg
:target: https://pypi.python.org/pypi/renku-sphinx-theme
.. image:: https://img.shields.io/github/license/SwissDataScienceCenter/renku-sphinx-theme.svg
:target: https://github.com/SwissDataScienceCenter/renku-sphinx-theme/blob/master/LICENSE
A Sphinx theme for Renku documentation based on RTD theme.
https://renku-sphinx-theme.readthedocs.io/en/latest/
Installation
------------
1. Add ``renku-sphinx-theme`` to ``setup.py`` or ``requirements.txt`` used
for building your documentation.
2. Set ``html_theme`` to ``'renku'`` in ``docs/conf.py``.
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 it ``./renku_sphinx_theme/static/custom.scss``.
Renku repo is a better repository for testing style changes.
The easy way of doing this is to go to the renku repo, add a temporary css (custom.css)
in the ``docs/conf.py`` file and follow this steps:
https://renku.readthedocs.io/en/latest/how-to-guides/contributing/documentation.html
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.
Building
--------
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.
Releasing
---------
1. Create a pull request updating ``renku_sphinx_theme/version.py`` to the new version number
and ``CHANGES.rst`` to list the new changes.
2. Once the pull request is merged, `create a new release <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/releases/new>`__.
3. The release will be automatically be pushed to `PyPI <https://pypi.org/project/renku-sphinx-theme/>`__.
..
Copyright 2017 Swiss Data Science Center (SDSC)
A partnership between École Polytechnique Fédérale de Lausanne (EPFL) and
Eidgenössische Technische Hochschule Zürich (ETHZ).
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Changes
=======
`0.5.0 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/compare/v0.4.0...v0.5.0>`__ (2025-01-24)
-------------------------------------------------------------------------------------------------------------
This release makes minor changes for compatibility with ``sphinx>=8`` and ``sphinx-rtd-theme>=3``.
`0.4.0 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/compare/v0.3.0...v0.4.0>`__ (2025-01-23)
-------------------------------------------------------------------------------------------------------------
This release bumps sphinx-rtd-theme dependency to make the style compatible with sphinx 7+
`0.3.0 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/compare/v0.2.3...v0.3.0>`__ (2023-08-14)
-------------------------------------------------------------------------------------------------------------
Big dependency update.
`0.2.3 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/compare/v0.2.2...v0.2.3>`__ (2023-04-26)
-------------------------------------------------------------------------------------------------------------
- **chore:** add dependabot.yml
(`76baee5 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/76baee53a3dea65e44c862e3d39836bced35f205>`__)
- **chore:** remove dependency on non-existent compile-scss
(`617e566 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/617e566bc4821c31e42d544c6abda9399c5cbde5>`__)
- **chore:** fix pypi description
(`23536d9 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/23536d9e40efdd3701a76074e377f2236d336cdf>`__)
- **chore(deps):** update sphinx-rtd-theme requirement
(`2ca96ca <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/2ca96ca9b932de2ba2f2434f0bb962d06d0a6620>`__)
- **chore:** bump python version
(`0dd1fe6 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/0dd1fe66db3b1d1c587ca534bb04c9a6c148de92>`__)
- **chore:** delete layout.html
(`5fa988d <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/5fa988d54609cfe3f593ca252af7925acd12eeef>`__)
- **fix:** update styles to fix sidebar background leaking into main content
(`5ab737b <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/5ab737bf48f7757ff1fb4464538f851da5918aa9>`__)
`0.2.2 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/compare/v0.1.0...v0.2.2>`__ (2021-07-09)
-------------------------------------------------------------------------------------------------------------
- **design:** new design for renku-sphinx
(`3cf7ec7 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/3cf7ec746996411408267cb952f500481aac805b>`__)
- **chore:** replace travis CI with github actions
(`4056830 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/40568301b0d95865db8835360b6b2ddd873ceccd>`__)
`0.1.0 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/releases/tag/v0.1.0>`__ (2018-05-17)
---------------------------------------------------------------------------------------------------------
- Initial public release.
Raw data
{
"_id": null,
"home_page": "https://github.com/SwissDataScienceCenter/renku-sphinx-theme",
"name": "renku-sphinx-theme",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Renku Sphinx theme",
"author": "Swiss Data Science Center (SDSC)",
"author_email": "contact@datascience.ch",
"download_url": "https://files.pythonhosted.org/packages/4e/36/123a101a93f1906c146b58d3d59512a1b7ced5fc69bb56fe6571af13303e/renku-sphinx-theme-0.5.0.tar.gz",
"platform": "any",
"description": "..\n Copyright 2017 Swiss Data Science Center (SDSC)\n A partnership between \u00c9cole Polytechnique F\u00e9d\u00e9rale de Lausanne (EPFL) and\n Eidgen\u00f6ssische Technische Hochschule Z\u00fcrich (ETHZ).\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n\n=================================\n Sphinx Theme for Renku Projects\n=================================\n\n.. image:: https://github.com/SwissDataScienceCenter/renku-sphinx-theme/actions/workflows/test.yml/badge.svg\n :target: https://github.com/SwissDataScienceCenter/renku-sphinx-theme/actions?query=branch%3Amaster\n\n.. image:: https://img.shields.io/github/tag/SwissDataScienceCenter/renku-sphinx-theme.svg\n :target: https://github.com/SwissDataScienceCenter/renku-sphinx-theme/releases\n\n.. image:: https://img.shields.io/pypi/dm/renku-sphinx-theme.svg\n :target: https://pypi.python.org/pypi/renku-sphinx-theme\n\n.. image:: https://img.shields.io/github/license/SwissDataScienceCenter/renku-sphinx-theme.svg\n :target: https://github.com/SwissDataScienceCenter/renku-sphinx-theme/blob/master/LICENSE\n\nA Sphinx theme for Renku documentation based on RTD theme.\n\nhttps://renku-sphinx-theme.readthedocs.io/en/latest/\n\nInstallation\n------------\n\n1. Add ``renku-sphinx-theme`` to ``setup.py`` or ``requirements.txt`` used\n for building your documentation.\n2. Set ``html_theme`` to ``'renku'`` in ``docs/conf.py``.\n3. Configure at least ``description`` and ``github_repo`` in\n ``html_theme_options``.\n\nEnjoy your beautiful Renku documentation style.\n\n\nStyle (css)\n-----------\n\nThis repo contains a ``scss`` file that generates a ``css`` file.\nThe ``css`` file shouldn't be manually modified since it's generated with the ``scss``.\nInstructions to change and run the ``scss`` file are inside it ``./renku_sphinx_theme/static/custom.scss``.\n\nRenku repo is a better repository for testing style changes.\n\nThe easy way of doing this is to go to the renku repo, add a temporary css (custom.css)\nin the ``docs/conf.py`` file and follow this steps:\n\nhttps://renku.readthedocs.io/en/latest/how-to-guides/contributing/documentation.html\n\nAfter doing the changes in the temporary css add this to custom.scss in this repository, build this into\na css file using the instructions and commit the css and scss files.\n\n\nBuilding\n--------\n\nTo build docs after doing changes, and test things inside this repository\n\n1. From the base folder... ``pip install -r docs/requirements.txt``\n2. This should be done in case there where changes in fonts or new css files added ``pip install --editable .``\n3. There is no Makefile here but in order to do the \"make html\" action you should do\n\n ``cd docs``\n ``sphinx-build -b html -d _build/doctrees . _build/html``\n\nDocs will be built into ``_build/html...`` open this files with chrome to see the changes.\n\n\nReleasing\n---------\n\n1. Create a pull request updating ``renku_sphinx_theme/version.py`` to the new version number\n and ``CHANGES.rst`` to list the new changes.\n2. Once the pull request is merged, `create a new release <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/releases/new>`__.\n3. The release will be automatically be pushed to `PyPI <https://pypi.org/project/renku-sphinx-theme/>`__.\n\n\n..\n Copyright 2017 Swiss Data Science Center (SDSC)\n A partnership between \u00c9cole Polytechnique F\u00e9d\u00e9rale de Lausanne (EPFL) and\n Eidgen\u00f6ssische Technische Hochschule Z\u00fcrich (ETHZ).\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n\nChanges\n=======\n\n`0.5.0 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/compare/v0.4.0...v0.5.0>`__ (2025-01-24)\n-------------------------------------------------------------------------------------------------------------\n\nThis release makes minor changes for compatibility with ``sphinx>=8`` and ``sphinx-rtd-theme>=3``.\n\n\n`0.4.0 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/compare/v0.3.0...v0.4.0>`__ (2025-01-23)\n-------------------------------------------------------------------------------------------------------------\n\nThis release bumps sphinx-rtd-theme dependency to make the style compatible with sphinx 7+ \n\n\n`0.3.0 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/compare/v0.2.3...v0.3.0>`__ (2023-08-14)\n-------------------------------------------------------------------------------------------------------------\n\nBig dependency update. \n\n\n`0.2.3 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/compare/v0.2.2...v0.2.3>`__ (2023-04-26)\n-------------------------------------------------------------------------------------------------------------\n\n- **chore:** add dependabot.yml\n (`76baee5 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/76baee53a3dea65e44c862e3d39836bced35f205>`__)\n\n- **chore:** remove dependency on non-existent compile-scss\n (`617e566 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/617e566bc4821c31e42d544c6abda9399c5cbde5>`__)\n \n- **chore:** fix pypi description\n (`23536d9 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/23536d9e40efdd3701a76074e377f2236d336cdf>`__)\n \n- **chore(deps):** update sphinx-rtd-theme requirement \n (`2ca96ca <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/2ca96ca9b932de2ba2f2434f0bb962d06d0a6620>`__)\n\n- **chore:** bump python version\n (`0dd1fe6 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/0dd1fe66db3b1d1c587ca534bb04c9a6c148de92>`__)\n\n- **chore:** delete layout.html\n (`5fa988d <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/5fa988d54609cfe3f593ca252af7925acd12eeef>`__)\n\n- **fix:** update styles to fix sidebar background leaking into main content\n (`5ab737b <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/5ab737bf48f7757ff1fb4464538f851da5918aa9>`__)\n\n`0.2.2 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/compare/v0.1.0...v0.2.2>`__ (2021-07-09)\n-------------------------------------------------------------------------------------------------------------\n\n- **design:** new design for renku-sphinx\n (`3cf7ec7 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/3cf7ec746996411408267cb952f500481aac805b>`__)\n\n- **chore:** replace travis CI with github actions\n (`4056830 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/commit/40568301b0d95865db8835360b6b2ddd873ceccd>`__)\n\n`0.1.0 <https://github.com/SwissDataScienceCenter/renku-sphinx-theme/releases/tag/v0.1.0>`__ (2018-05-17)\n---------------------------------------------------------------------------------------------------------\n\n- Initial public release.\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "A Sphinx theme for Renku documentation.",
"version": "0.5.0",
"project_urls": {
"Homepage": "https://github.com/SwissDataScienceCenter/renku-sphinx-theme"
},
"split_keywords": [
"renku",
"sphinx",
"theme"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "9b00055a7d506281c1f16cc048d5c73ad41a44568c7a5f1fa7c56f349a41e671",
"md5": "d44bdf6879229b8e2d60930756fd3dce",
"sha256": "1bd92cf728c00d539ebbaa59bb3d5e8eee977ad0aecaa3034962a315b8fa42aa"
},
"downloads": -1,
"filename": "renku_sphinx_theme-0.5.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "d44bdf6879229b8e2d60930756fd3dce",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 579993,
"upload_time": "2025-01-24T13:23:19",
"upload_time_iso_8601": "2025-01-24T13:23:19.020844Z",
"url": "https://files.pythonhosted.org/packages/9b/00/055a7d506281c1f16cc048d5c73ad41a44568c7a5f1fa7c56f349a41e671/renku_sphinx_theme-0.5.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4e36123a101a93f1906c146b58d3d59512a1b7ced5fc69bb56fe6571af13303e",
"md5": "be89e3ec44875933aa34f47ea8b1f0d3",
"sha256": "8fcf80b854681119ee4dd6268c6a4ed80f9303a3fa9fdc020fd1cb4926dc4c6e"
},
"downloads": -1,
"filename": "renku-sphinx-theme-0.5.0.tar.gz",
"has_sig": false,
"md5_digest": "be89e3ec44875933aa34f47ea8b1f0d3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 586756,
"upload_time": "2025-01-24T13:23:21",
"upload_time_iso_8601": "2025-01-24T13:23:21.200388Z",
"url": "https://files.pythonhosted.org/packages/4e/36/123a101a93f1906c146b58d3d59512a1b7ced5fc69bb56fe6571af13303e/renku-sphinx-theme-0.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-24 13:23:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SwissDataScienceCenter",
"github_project": "renku-sphinx-theme",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "renku-sphinx-theme"
}
JSON
