revise-static-content
Managing static documentation within your repository becomes effortless with this tool, which dynamically renders content into markdown files. Why?
Maintaining and synchronizing content across various files can be challenging, often leading to tedious copy-pasting tasks. Consequently, updating these files later becomes a nightmare, resulting in outdated documentation.
The package introduces "directive" comments capable of rendering content within specified tags. Since the comments themselves remain intact, the content can be dynamically re-rendered.
<!-- #directive: ... -->
some generated content
<!-- /directive -->Simply provide a glob pattern to the CLI. It will then render all dynamic content within the directives and overwrite the files accordingly.
revise-static-content **/README.md
This directive allows for the inclusion of content (parts) from other markdown files. The included content also supports template syntax.
<!-- @include: docs/parts/intro.md -->
This code is automatically generated and should be edited elsewhere.
<!-- /include -->Inserts a template specified inline in the directive paramater.
<!-- @insert: Hello {{name}}! -->
Hello John!
<!-- /insert -->Templates are snippets of code whose content can be overwritten. Templates can only be written in dynamic parts used by the include directive, or inline in the insert directive. Templates allow you to insert values defined in the frontmatter.
Hello {{name}}!
You can ignore rendering templates by wrapping the content in the ignore directive.
<!-- @ignore -->
This is how you write mustache `{{name}}`!
<!-- /ignore -->