Quickly and flexibly generate content based on handlebars templates

Legal

Dual-licensed under MIT or the UNLICENSE.

Installation

cargo install handlebars-magic

Usage

Generates documentation from handlebars templates

Usage: handlebars-magic <INPUT> <OUTPUT>

Arguments:
  <INPUT>   The input folder with templates
  <OUTPUT>  The output folder

Options:
  -h, --help     Print help
  -V, --version  Print version

For each file in the input folder, a corresponding file will be created in the output folder.

For example, this project generates updated documentation using the following call:

handlebars-magic templates .

Supported helpers

from

Searches for the prefix and starts with it if it is found. Otherwise, the entire string is returned.

{{ from "begin" "prefix begin text end" }}

renders to:

begin text end

to

Searches for the prefix and starts with it if it is found. Otherwise, the entire string is returned.

{{ to ")" "hello)" }}

renders to:

hello

render

Processes an argument as handlebars's template.

{{ render "some handlebars template" }}

renders to:

some handlebars template

This does not look useful until we use it in conjuction with other helper such as read_to_str from handlebars_misc_helpers:

{{ render ( read_to_str "templates/README.md" ) }}

codeblock

Allows to insert markdown's fenced code block. Content would be trimmed.

{{ codeblock "bash" "echo test" }}

renders to:

```bash
echo test
```

exec

Allows to include output of command.

{{ exec "echo test" }}

renders to:

test

handlebars_misc_helpers

All helpers from handlebars_misc_helpers.