orangeqs-sphinx-extensions 0.1.0

Sphinx theme and custom extensions used internally by Orange Quantum Systems

OrangeQS Sphinx Extensions

Common Sphinx theme and extensions used internally by Orange Quantum Systems for building product documentation.

The Sphinx theme is an extension to Pydata Sphinx Theme with adaptations to company branding.

Usage

Theme

• Add orangeqs-sphinx-extensions to your requirements.
• Copy the content of conf_default.py to your Sphinx's conf.py file, modifying where needed. In particular, replace PATH_TO_YOUR_REPO by the URL of your Gitlab repository. It should have the format internal/wiki.

Generated API documentation

This package contains a Numpydoc parser for sphinx-autodoc2 taken from this issue comment. To use it, install this package with extra enabled:

pip install orangeqs-sphinx-extensions[autodoc2]

After that, configure autodoc2 in Sphinx conf.py, for example:

extensions = [
    ...,
    "autodoc2",
]
autodoc2_packages = ["../../PACKAGENAME"]
autodoc2_output_dir = "./api_reference"
autodoc2_render_plugin = "myst"
autodoc2_docstring_parser_regexes = [
    (
        ".*",
        "orangeqs.sphinx.autodoc2.numpydoc",
    ),
]

and add api_reference/index to toctree.

For more details on configuration, see documentation of sphinx-autodoc2

License and copyright

This package is licensed under BSD 3-clause license, unless other license and copyright is explicitly specified in the header comment or module docstring of the respective source code file.