https://github.com/astropy/astropy-sphinx-theme
Standalone version of the Astropy sphinx theme
https://github.com/astropy/astropy-sphinx-theme
Last synced: 3 months ago
JSON representation
Standalone version of the Astropy sphinx theme
- Host: GitHub
- URL: https://github.com/astropy/astropy-sphinx-theme
- Owner: astropy
- License: bsd-3-clause
- Created: 2017-09-25T15:00:31.000Z (almost 9 years ago)
- Default Branch: main
- Last Pushed: 2026-04-06T16:29:22.000Z (3 months ago)
- Last Synced: 2026-04-06T18:24:32.965Z (3 months ago)
- Language: JavaScript
- Homepage:
- Size: 163 KB
- Stars: 5
- Watchers: 5
- Forks: 20
- Open Issues: 18
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES.rst
- License: LICENSE.rst
Awesome Lists containing this project
README
Astropy Sphinx Theme(s)
-----------------------
This is the repository for the default Astropy project documentation
theme(s). To use this theme, simply install this package then add the
following line to your documentation's ``conf.py`` file:
.. code:: python
html_theme = 'bootstrap-astropy'
This requires Sphinx 1.6 or later to work properly. For older versions
of Sphinx, you will need to do:
.. code:: python
import astropy_sphinx_theme
html_theme_path = astropy_sphinx_theme.get_html_theme_path()
html_theme = 'bootstrap-astropy'
``bootstrap-astropy`` is the only theme that is currently available, but
the structure of the package allows more themes to be added in future if
needed.
Several options for the theme can be set in the ``conf.py`` file:
.. code:: python
html_theme_options = {
'logotext1': 'packagename', # white, semi-bold
'logotext2': '', # orange, light
'logotext3': ':docs', # white, light
'astropy_project_menubar': True
}
The ``logotext?`` options can be used to customize the top left logo, while
the ``astropy_project_menubar`` option can be set to ``True`` for packages
that are managed by the project itself (this will add links to find out more
about the Astropy project, about the team, and so on).
.. image:: https://circleci.com/gh/astropy/astropy-sphinx-theme/tree/main.svg?style=svg
:target: https://circleci.com/gh/astropy/astropy-sphinx-theme/tree/main