基于 handlebars 模板快速灵活地生成内容

法律

双许可协议下 MIT 或 UNLICENSE。

安装

cargo install handlebars-magic

使用

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

对于输入文件夹中的每个文件，输出文件夹中都会创建一个相应的文件。

例如，此项目使用以下调用生成更新后的文档

handlebars-magic templates .

支持的辅助函数

从

查找前缀并从它开始，如果找到则返回整个字符串。否则，返回整个字符串。

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

渲染为

begin text end

到

查找前缀并从它开始，如果找到则返回整个字符串。否则，返回整个字符串。

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

渲染为

hello

渲染

将参数作为 handlebars 的模板处理。

{{ render "some handlebars template" }}

渲染为

some handlebars template

这个函数看起来没什么用，直到我们与其他辅助函数如 read_to_str 一起使用时。

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

代码块

允许插入 markdown 的围栏代码块。内容将被修剪。

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

渲染为

```bash
echo test
```

执行

允许包含命令的输出。

{{ exec "echo test" }}

渲染为

test

handlebars_misc_helpers

handlebars_misc_helpers 中的所有辅助函数。