# Sphinx RTD Theme Dark Mode
[](https://travis-ci.com/github/MrDogeBro/content_filter) [](https://pypi.python.org/pypi/sphinx-rtd-dark-mode/) [](https://pypi.python.org/pypi/sphinx-rtd-dark-mode/) [](https://pypi.python.org/pypi/sphinx-rtd-dark-mode/) [](https://github.com/MrDogeBro/sphinx_rtd_dark_mode/blob/main/LICENSE) [](http://makeapullrequest.com)
This Sphinx extension adds a toggleable dark mode to the Read the Docs theme.
A little icon is added in the bottom right hand corner which allows the user
to switch between light or dark mode.
## Installation
**Python 3.4 or higher is required**
To install dark mode for the RTD theme, enter the following command into your
terminal or command prompt.
```bash
# Linux/OSX
python3 -m pip install sphinx-rtd-dark-mode
# Windows
py -3 -m pip install sphinx-rtd-dark-mode
```
## Using the Extension
To use the extension, you will need to add it to the extensions array in your config
file (`conf.py`).
```py
extensions = ["sphinx_rtd_dark_mode"]
```
You will also need to be using the Sphinx RTD theme for this to work. If your not,
then the extension will change it for you as it only works for that theme.
## Config
Below are the options that are customizeable for the extension. Currently, there
is only one option available to configure.
#### Default Dark Mode
This lets you choose which theme the user sees when they load the docs for the first
time ever. After the first time however, this setting has no effect as the users
preference is stored in local storage within their browser. This option accepts a
boolean for the value. If this option is true (the default option), users will start
in dark mode when first visiting the site. If this option is false, users will start
in light mode when they first visit the site.
```py
# user starts in dark mode
default_dark_mode = True
# user starts in light mode
default_dark_mode = False
```
## License
The Sphinx RTD Dark Mode module for Python is licensed under an [MIT license](https://github.com/MrDogeBro/sphinx_rtd_dark_mode/blob/master/LICENSE).
Raw data
{
"_id": null,
"home_page": "https://github.com/MrDogeBro/sphinx_rtd_dark_mode",
"name": "sphinx-rtd-dark-mode",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.4",
"maintainer_email": "",
"keywords": "",
"author": "MrDogeBro",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/fb/7c/bb1c20458f498d907d78a357b246a0ee1a3a94ee5a5ec39378726e646661/sphinx_rtd_dark_mode-1.3.0.tar.gz",
"platform": null,
"description": "# Sphinx RTD Theme Dark Mode\n\n[](https://travis-ci.com/github/MrDogeBro/content_filter) [](https://pypi.python.org/pypi/sphinx-rtd-dark-mode/) [](https://pypi.python.org/pypi/sphinx-rtd-dark-mode/) [](https://pypi.python.org/pypi/sphinx-rtd-dark-mode/) [](https://github.com/MrDogeBro/sphinx_rtd_dark_mode/blob/main/LICENSE) [](http://makeapullrequest.com)\n\nThis Sphinx extension adds a toggleable dark mode to the Read the Docs theme.\nA little icon is added in the bottom right hand corner which allows the user\nto switch between light or dark mode.\n\n## Installation\n\n**Python 3.4 or higher is required**\n\nTo install dark mode for the RTD theme, enter the following command into your\nterminal or command prompt.\n\n```bash\n# Linux/OSX\npython3 -m pip install sphinx-rtd-dark-mode\n\n# Windows\npy -3 -m pip install sphinx-rtd-dark-mode\n```\n\n## Using the Extension\n\nTo use the extension, you will need to add it to the extensions array in your config\nfile (`conf.py`).\n\n```py\nextensions = [\"sphinx_rtd_dark_mode\"]\n```\n\nYou will also need to be using the Sphinx RTD theme for this to work. If your not,\nthen the extension will change it for you as it only works for that theme.\n\n## Config\n\nBelow are the options that are customizeable for the extension. Currently, there\nis only one option available to configure.\n\n#### Default Dark Mode\n\nThis lets you choose which theme the user sees when they load the docs for the first\ntime ever. After the first time however, this setting has no effect as the users\npreference is stored in local storage within their browser. This option accepts a\nboolean for the value. If this option is true (the default option), users will start\nin dark mode when first visiting the site. If this option is false, users will start\nin light mode when they first visit the site.\n\n```py\n# user starts in dark mode\ndefault_dark_mode = True\n\n# user starts in light mode\ndefault_dark_mode = False\n```\n\n## License\n\nThe Sphinx RTD Dark Mode module for Python is licensed under an [MIT license](https://github.com/MrDogeBro/sphinx_rtd_dark_mode/blob/master/LICENSE).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Dark mode for the Sphinx Read the Docs theme.",
"version": "1.3.0",
"project_urls": {
"Download": "https://github.com/MrDogeBro/sphinx_rtd_dark_mode/archive/v1.3.0.tar.gz",
"Homepage": "https://github.com/MrDogeBro/sphinx_rtd_dark_mode"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "abf116b919bf5d33b282f13c0c39be687c658a33debb2caf4137a63be4bb21f6",
"md5": "9fa3e4e7cbe7e2c2ad324b4037391c38",
"sha256": "478da69c72a2a2ed7665c1f633cc612039f5801df416fd5f7c4820c2fe08c9c5"
},
"downloads": -1,
"filename": "sphinx_rtd_dark_mode-1.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9fa3e4e7cbe7e2c2ad324b4037391c38",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.4",
"size": 10031,
"upload_time": "2023-09-19T22:22:13",
"upload_time_iso_8601": "2023-09-19T22:22:13.642636Z",
"url": "https://files.pythonhosted.org/packages/ab/f1/16b919bf5d33b282f13c0c39be687c658a33debb2caf4137a63be4bb21f6/sphinx_rtd_dark_mode-1.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fb7cbb1c20458f498d907d78a357b246a0ee1a3a94ee5a5ec39378726e646661",
"md5": "6463fbb1906c54f593e059b9eb9f4cc6",
"sha256": "0272bf3d9ef620921adc67e5634a66969419e744da84ea18830adacfdb160ea8"
},
"downloads": -1,
"filename": "sphinx_rtd_dark_mode-1.3.0.tar.gz",
"has_sig": false,
"md5_digest": "6463fbb1906c54f593e059b9eb9f4cc6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.4",
"size": 8627,
"upload_time": "2023-09-19T22:22:14",
"upload_time_iso_8601": "2023-09-19T22:22:14.692163Z",
"url": "https://files.pythonhosted.org/packages/fb/7c/bb1c20458f498d907d78a357b246a0ee1a3a94ee5a5ec39378726e646661/sphinx_rtd_dark_mode-1.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-19 22:22:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MrDogeBro",
"github_project": "sphinx_rtd_dark_mode",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "sphinx-rtd-dark-mode"
}
JSON
