Metadata-Version: 2.1
Name: cirrus-docs
Version: 0.1.1
Summary: Utilities to manage cirrus project documentation.
Home-page: https://github.com/cirrus-geo/cirrus-docs
Author: Jarrett Keifer (jkeifer), Element 84
License: Apache-2.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown

[![build-status-image]][build-status]
[![coverage-status-image]][codecov]
[![pypi-version]][pypi]

# cirrus-docs

cirrus-docs is a plugin for the [cirrus-geo] processing pipeline framework to
add documentation commands to the `cirrus` cli. The plugin allows a cirrus
project instance to develop and build documentation, pulling in the docs for
cirrus-geo, cirrus-lib, all of the available components, and any installed
plugins.


## Quickstart

cirrus-docs in `pip`-installable:

```
pip install cirrus-docs
```

When installed alonside [cirrus-geo], it will add a `docs` subcommand to the `cirrus` cli, which can be used within a cirrus project to initialize, stage, and build the project documentation:

```
~ ❯ cd project-dir
~/project-dir ❯ cirrus docs init
~/project-dir ❯ cirrus docs stage
`/project-dir ❯ cirrus docs build
```

cirrus-docs is built on top of [sphinx]. See the [full plugin
documentation][docs] for more information about how to use it.


[sphinx]: https://www.sphinx-doc.org/en/master/
[docs]: https://cirrus-geo.github.io/cirrus-docs/
[cirrus-geo]: https://github.com/cirrus-geo/cirrus-geo
[build-status-image]: https://github.com/cirrus-geo/cirrus-docs/actions/workflows/python-test.yml/badge.svg
[build-status]: https://github.com/cirrus-geo/cirrus-docs/actions/workflows/python-test.yml
[coverage-status-image]: https://img.shields.io/codecov/c/github/cirrus-geo/cirrus-docs/master.svg
[codecov]: https://codecov.io/github/cirrus-geo/cirrus-docs?branch=master
[pypi-version]: https://img.shields.io/pypi/v/cirrus-docs.svg
[pypi]: https://pypi.org/project/cirrus-docs/
