Skip to main content

CrateDB Documentation Theme

Project description

CI status Read the Docs status PyPI version crate-docs version 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

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?

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

crate_docs_theme-0.37.0.tar.gz (2.1 MB view details)

Uploaded Source

Built Distribution

crate_docs_theme-0.37.0-py3-none-any.whl (2.2 MB view details)

Uploaded Python 3

File details

Details for the file crate_docs_theme-0.37.0.tar.gz.

File metadata

  • Download URL: crate_docs_theme-0.37.0.tar.gz
  • Upload date:
  • Size: 2.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.13.0

File hashes

Hashes for crate_docs_theme-0.37.0.tar.gz
Algorithm Hash digest
SHA256 97f5b58c1fdc8755c32ba1cb075eef209faabfdfc8e1d4d8b04de5be636d7376
MD5 a5a2219232b2f16fa1883003fbb5e73a
BLAKE2b-256 5ffecbd0689d6f90ccec8d9884b63e11a3bdbe1a54a636584c8940eede5b5a14

See more details on using hashes here.

File details

Details for the file crate_docs_theme-0.37.0-py3-none-any.whl.

File metadata

File hashes

Hashes for crate_docs_theme-0.37.0-py3-none-any.whl
Algorithm Hash digest
SHA256 dcadaa7766f6364b064d199f57b17a583b53c9f5931fe022ce9d9ee2207ef25c
MD5 a332280aa43a9e878b619f2f774c2777
BLAKE2b-256 332b910d7a7e7a40f68fd616a859ac12f29bf10e39e54facc7a94305cb2607fb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page