Metadata-Version: 2.1
Name: horkos-doc
Version: 0.0.2
Summary: A library for building data documentation.
Home-page: https://gitlab.com/kjschiroo/horkos-doc
Author: Kevin Schiroo
Author-email: kjschiroo@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: beautifulsoup4
Requires-Dist: bleach
Requires-Dist: jinja2
Requires-Dist: markdown
Requires-Dist: horkos

# Horkos Doc

A command-line tool for generating HTML documentation from `horkos` schemas

## Install

```
pip3 install horkos-doc
```

## Usage

```
> horkos-doc --help
usage: horkos-doc [-h] [--config CONFIG] [--author AUTHOR]
                  [--home-page HOME_PAGE] [--output OUTPUT]
                  [input]

positional arguments:
  input                 A directory of schema files from which to build the
                        html documentation. This is not required if a value is
                        set within the given config file.

optional arguments:
  -h, --help            show this help message and exit
  --config CONFIG, -c CONFIG
                        The path to a configuration file for horkos-doc. This
                        file can be used to override the built-in default for
                        command-line arguments. By default this is
                        `.horkos_doc`.
  --author AUTHOR, -a AUTHOR
                        The author of the documentation. This is used to
                        create copyright statements within the generated
                        documentation.
  --home-page HOME_PAGE, --hp HOME_PAGE
                        The name to use for the home page of the generated
                        documentation. By default this is "Horkos Doc".
  --output OUTPUT, -o OUTPUT
                        The directory in which to store built html. By default
                        this is ./build
```

If all the schema files are in `./schemas` to build the docs run:

```
horkos-doc ./schemas
```

## Configuration

All options available on the command-line can also be set in an optional
configuration file. By default this file is expected to be `.horkos_doc`.

```
[default]
input = ./schemas
output = ./docs
author = Mr. Foobar
home_page = The Docs!
```


