Files
docs2website/sample-config.yaml

63 lines
1.8 KiB
YAML

# Input Configuration (where your documents are)
input:
# The root directory for where to find input file. All other
# input paths are relative to this, and must be under this
root: ./docs
# Files identified in this section are copied over to the
# output directory unprocessed
raw:
- ./**/*.{png,jpg,jpeg,gif}
# Files in this section will be processed as mustache templates,
# but will receive no other processing
text:
- ./**/*.{css,html,js,txt}
# Files to be parsed as markdown (optionally with front matter)
# and rendered to HTML pages
markdown:
- ./**/*.md
# Files to be parsed as JSON Schema definitions and rendered
# to HTML documentation. Additionally, the original JSON / Yaml
# file will also be copied to the output directory, unaltered
schema+json:
- ./**/*.schema.json
schema+yaml:
- ./**/*.schema.{yaml,yml}
# Files to be parsed as OpenAPI V3 specifications and rendered
# to HTML documentation. Additionally, the original JSON / Yaml
# file will also be copied to the output directory, unaltered
openapi+json:
- ./**/*.openapi.json
openapi+yaml:
- ./**/*.openapi.{yaml,yml}
# Template Configuration (used by mustache to actually render pages)
templates:
# Root directory where layout files are stored
layouts: ./layouts
# Root directory where partial files are stored
partials: ./partials
# (Optional) whitelist of environment variables to be made accessible
# under `env` when processing templates
env:
- EXAMPLE_ENVIRONMENT_VARIABLE
- FOO_BAR_BAZ
# Output Configuration (where to put your website)
output:
# The root directory to output your website at. The path of an
# input file relative to $.input.root will match (aside from file
# extension) the path of the output file relative to $.output.root
root: ./www
# Markdown-to-HTML Configuration
markdown:
#