Metadata-Version: 2.1
Name: qctrl-sphinx-theme
Version: 0.1.2
Summary: Q-CTRL Sphinx Theme
Home-page: https://q-ctrl.com
License: https://q-ctrl.com/terms
Keywords: black opal,boulder opal,fire opal,nisq,open controls,q control,q ctrl,q-control,q-ctrl,qcontrol,qctrl,quantum,quantum algorithms,quantum circuits,quantum coding,quantum coding software,quantum computing,quantum control,quantum control software,quantum control theory,quantum engineering,quantum error correction,quantum firmware,quantum fundamentals,quantum sensing,qubit,qudit
Author: Q-CTRL
Author-email: support@q-ctrl.com
Maintainer: Q-CTRL
Maintainer-email: support@q-ctrl.com
Requires-Python: >=3.7,<3.12
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: Other/Proprietary License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: Embedded Systems
Classifier: Topic :: System :: Distributed Computing
Requires-Dist: sphinx (>=5.0.0,<6.0.0)
Requires-Dist: sphinx_rtd_theme (>=1.1.1,<1.2.0)
Requires-Dist: toml (>=0.10.0,<0.11.0)
Project-URL: Facebook, https://www.facebook.com/qctrl
Project-URL: GitHub, https://github.com/qctrl
Project-URL: LinkedIn, https://www.linkedin.com/company/q-ctrl/
Project-URL: Twitter, https://twitter.com/qctrlHQ
Project-URL: YouTube, https://www.youtube.com/qctrl
Description-Content-Type: text/markdown

# Q-CTRL Sphinx Theme

The Q-CTRL Sphinx Theme is a very opinionated [Sphinx](https://www.sphinx-doc.org/) theme intended for use with public [Q-CTRL Documentation](https://docs.q-ctrl.com/) websites such as the [Q-CTRL Python package](https://docs.q-ctrl.com/boulder-opal/references/qctrl/).

## Installation

```shell
pip install qctrl-sphinx-theme
```

## Usage

1. Add `qctrl-sphinx-theme` as a dev dependency in `pyproject.toml`.
2. Set the `html_theme` config value in `docs/conf.py`.
  ```python
  html_theme = "qctrl_sphinx_theme"
  ```
3. Set the `html_theme_options` config value in `docs/conf.py`.
  ```python
  html_theme_options = {
      "docsearch_api_key": "<YOUR_DOCSEARCH_API_KEY>",
      "docsearch_app_id": "<YOUR_DOCSEARCH_APP_ID>",
      "docsearch_index_name": "<YOUR_DOCSEARCH_INDEX_NAME>",
      "segment_write_key": "<YOUR_SEGMENT_WRITE_KEY>"
  }
  ```

