Metadata-Version: 2.2
Name: crate-docs-theme
Version: 0.38.2.dev0
Summary: CrateDB Documentation Theme
Home-page: https://github.com/crate/crate-docs-theme
Author: Crate.IO GmbH
Author-email: office@crate.io
License: Apache License 2.0
Keywords: cratedb docs sphinx readthedocs
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Documentation
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: NOTICE
Requires-Dist: furo==2024.8.6
Requires-Dist: jinja2<4,>=3
Requires-Dist: jupysql<0.11
Requires-Dist: myst-nb<1.2
Requires-Dist: myst-parser[linkify]<5
Requires-Dist: oembedpy<0.9
Requires-Dist: sphinx<9,>=7.1
Requires-Dist: sphinx-basic-ng==1.0.0b2
Requires-Dist: sphinx-copybutton<1,>=0.3.1
Requires-Dist: sphinx-design-elements==0.4.0
Requires-Dist: sphinx-inline-tabs
Requires-Dist: sphinx-sitemap<3,>=2.6
Requires-Dist: sphinx-subfigure<1
Requires-Dist: sphinx-togglebutton<1
Requires-Dist: sphinxext.opengraph<1,>=0.4
Requires-Dist: sphinxcontrib-mermaid<2
Requires-Dist: sphinxcontrib-plantuml<1,>=0.21
Requires-Dist: sphinxcontrib-youtube<2
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

===========================
CrateDB Documentation Theme
===========================

|tests| |rtd| |pypi| |build| |python-versions|


About
=====

A `Sphinx`_ theme for the `CrateDB documentation`_.

*Note: This theme is tightly integrated into the cratedb.com website and is
not intended for general use.*

For making changes to the theme, see the `developer docs`_.


Preview
=======

The demo/preview project is rendered and published to https://crate-docs-theme.readthedocs.io/.


Using the theme
===============

Prerequisites
-------------

The documentation can include UML diagrams which will be rendered using
`sphinxcontrib-plantuml`_. In order to satisfy its requirements, run::

    # On Linux
    apt-get install plantuml

    # On macOS
    brew install plantuml

.. _sphinxcontrib-plantuml: https://pypi.org/project/sphinxcontrib-plantuml/

Installation
------------

The CrateDB Documentation Theme is available as a package on `PyPI`_. However, there is no
need to install it yourself. CrateDB projects that use the theme should install
it automatically.


Configuration
-------------

The documentation is composed of multiple separate documentation
projects, seamlessly interlinked via the CrateDB Documentation Theme.

To use the theme, add this line to your Sphinx ``conf.py`` file::

   from crate.theme.rtd.conf.foo import *

Here, replace ``foo`` with the appropriate module for your documentation
project.


Contributing
============

This project is primarily maintained by `Crate.io`_, but we welcome community
contributions!

See the `developer docs`_ and the `contribution docs`_ for more information.


Help
====

Looking for more help?

- Check out our `support channels`_


.. _contribution docs: CONTRIBUTING.rst
.. _Crate.io: https://cratedb.com
.. _CrateDB documentation: https://cratedb.com/docs/
.. _developer docs: DEVELOP.rst
.. _PyPI: https://pypi.python.org/
.. _Sphinx: http://www.sphinx-doc.org/en/stable/
.. _support channels: https://cratedb.com/support/


.. |tests| image:: https://github.com/crate/crate-docs-theme/workflows/docs/badge.svg
    :alt: CI status
    :target: https://github.com/crate/crate-docs-theme/actions?workflow=docs

.. |rtd| image:: https://readthedocs.org/projects/crate-docs-theme/badge/
    :alt: Read the Docs status
    :target: https://readthedocs.org/projects/crate-docs-theme/

.. |build| image:: https://img.shields.io/endpoint.svg?color=blue&url=https%3A%2F%2Fraw.githubusercontent.com%2Fcrate%2Fcrate-docs-theme%2Fmain%2Fdocs%2Fbuild.json
    :alt: crate-docs version
    :target: https://github.com/crate/crate-docs-theme/blob/main/docs/build.json

.. |pypi| image:: https://badge.fury.io/py/crate-docs-theme.svg
    :alt: PyPI version
    :target: https://badge.fury.io/py/crate-docs-theme

.. |python-versions| image:: https://img.shields.io/pypi/pyversions/crate-docs-theme.svg
    :alt: Python Versions
    :target: https://pypi.org/project/crate-docs-theme/
