Metadata-Version: 2.1
Name: furo
Version: 2020.10.15b13
Summary: A clean customisable Sphinx documentation theme.
Home-page: https://github.com/pradyunsg/furo
License: UNKNOWN
Author: Pradyun Gedam
Author-email: mail@pradyunsg.me
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Requires-Dist: beautifulsoup4
Requires-Dist: sphinx
Requires-Dist: myst-parser ; extra == "doc"
Requires-Dist: sphinx-inline-tabs ; extra == "doc"
Requires-Dist: pytest ; extra == "test"
Requires-Dist: pytest-cov ; extra == "test"
Requires-Dist: pytest-xdist ; extra == "test"
Provides-Extra: doc
Provides-Extra: test

<h1 align="center">Furo</h1>
<p align="center">
  A clean customizable theme for <a href="https://www.sphinx-doc.org/">Sphinx</a>.
</p>
<a href="https://pradyunsg.me/furo/">
  <img align="center" src="https://github.com/pradyunsg/furo/raw/main/docs/_static/demo.png" alt="Demo image">
</a>

## Quickstart

Furo can be installed using `pip`:

```
pip install furo
```

Update the `html_theme` in `conf.py`:

```py
html_theme = "furo"
```

Your Sphinx documentation will now be generated with this theme! For more information, visit [Furo's documentation][docs].

[docs]: https://pradyunsg.me/furo/

## Contributing

Furo is a volunteer maintained open source project, and we welcome contributions of all forms. Please take a look at our [Contributing Guide](https://pradyunsg.me/furo/contributing/) for more information.

## Acknowledgements

Furo is inspired by (and borrows elements from) some excellent technical documentation themes:

- [mkdocs-material] for MkDocs
- [Just the Docs] for Jekyll
- [GitBook]

We use [BrowserStack] to test on real devices and browsers. Shoutout to them for supporting OSS projects!

[mkdocs-material]: https://squidfunk.github.io/mkdocs-material/
[just the docs]: https://pmarsceill.github.io/just-the-docs/
[gitbook]: https://www.gitbook.com/
[browserstack]: https://browserstack.com/

## License

This project is licensed under the MIT License.

