Render mandoc

Render man pages for your script.

Note that this renderer will render specially formatted markdown documents and
will then use pandoc to convert them.

Usage

# Generate all man pages to the ./docs directory
$ bashly render :mandoc docs

# Generate on change, and show one of the files
$ bashly render :mandoc docs --watch --show cli-download.1

Supported custom definitions

Add these definitions to your bashly.yml to render them in your
markdown:

Footer: x_mandoc_footer

Add additional sections to your man pages. This field is expected
to be in markdown format.

Example

x_mandoc_footer: |-
  # ISSUE TRACKER

  Report issues at 

Authors: x_mandoc_authors

Add an authors string to your man pages.

Example

x_mandoc_authors: Lana Lang

See Also: x_mandoc_see_also

Adds additional pages to the SEE ALSO section, in addition to the
pages that are added automatically (like the parent command, and
sub commands).

This property should be an array of strings. You can optionally add
a section number in parentheses. If not provided, (1) will be used
as default.

Example

x_mandoc_see_also:
  - docker
  - docker-compose.yml(5)