Docmaker is a WIP markdown documentation rendering tool.
$ docmaker <dir>
Docmaker will try to find
docmaker.yaml in the current directory or above and resolve all filepaths specified in the config relative to this
Via a config file called
docmaker.yaml you can specify pages to render, which data to load and which layout HTML file the document should use.
layout: layout.html data: - data.yaml - dynamic_data.js pages: - "_titlepage.html" - "_toc.md" - "[0-9]+*.md" assets: - styles.css.liquid
Every docmaker project can specify a
layout file to use when rendering the document. All pages will be rendered, joined and added into the layout file to render the final document.
You can specify globs for files to load as
pages. These globs are expanded, sorted and the resulting filepaths will be loaded as files, processed and joined together into a document.
assets, you may specify additional assets to copy into the build dist directory in case they are needed for the final render to PDF. For example you can specify your document CSS or images needed to render the PDF.
It is also possible to use data variables in assets by giving the asset file a
data files to load before rendering the pages. All pages will get the output from these datafiles as liquid variables for use while rending their content.