Introduction
The Ansys Sphinx theme is an extension of the popular PyData Sphinx theme that is used by numpy, pandas, pyvista, and many more scientific Python packages.
You use the Ansys Sphinx theme with Sphinx, a Python documentation generator, to create documentation. The theme’s objective is to ensure that Ansys documentation looks and behaves consistently.
While this theme is primarily used to create documentation for PyAnsys libraries, you can also use it to create documentation for any Ansys project with content in reStructuredText (RST) and Markdown (files).
If you are new to using Sphinx, see Sphinx Getting Started.
Documentation and issues
In addition to installation information, the Ansys Sphinx theme documentation provides information on how you can customize the theme. Because this documentation is created using this theme, viewing it is an easy way to preview the theme itself.
On the Issues page for this repository, you can create issues to submit questions, report bugs, and request new features. To reach the PyAnsys support team, email pyansys.core@ansys.com.
Getting started
Install the ansys-sphinx-theme package with:
python -m pip install ansys-sphinx-themeModify your Sphinx conf.py file to use html_theme = 'ansys_sphinx_theme'.
Development and contributions
If you want to contribute to the PyAnsys Sphinx theme, install the ansys-sphinx-theme package in development mode with:
git clone https://github.com/ansys/ansys-sphinx-theme.git python -m pip install -U pip tox tox -e style,doc
To simplify checks, this repository uses pre-commit. You can optionally install and use this tool. For more information, see its installation and usage documentation.
Before contributing to a PyAnsys library, see Contributing in the PyAnsys Developer’s Guide for overall guidance, paying particular attention to How-to for guidelines and best practices.
License
This theme is licensed under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for ansys-sphinx-theme 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ansys_sphinx_theme-1.0.1.tar.gz | 888.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ansys_sphinx_theme-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.8 MB
Release files / ansys_sphinx_theme-1.0.1.tar.gz
| Download URL | ansys_sphinx_theme-1.0.1.tar.gz |
|---|---|
| Size | 888.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
081e5fcfbb7191f2504ee204b08df0ae81bc64aebf92aff413270acd1f5ac342
|
|
BLAKE2b-256 checksum How to use checksums |
c5a705e8c6365ce52fa64af5a09853d35b26c8a263d970b8ff5abfed5c67b24d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.10.14
|
Release files / ansys_sphinx_theme-1.0.1-py3-none-any.whl
| Download URL | ansys_sphinx_theme-1.0.1-py3-none-any.whl |
|---|---|
| Size | 909.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bb81f34a67f413838125df6860e959fa365a5b71dba524ba20e153e4e1ad5344
|
|
BLAKE2b-256 checksum How to use checksums |
69afb5d1fabe3470f1d1afced06b4811faa4024ca7af40372d69780ae3589d44
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.10.14
|
