Bonelate 0.1.0

Bonelate 是一个基于 pyparsing 针对 LaTeX 的 mustache 模版语言变种的实现。

Bonelate

Bonelate 是一个基于 pyparsing 针对 LaTeX 的类似 mustache 语言的模版渲染器。 与采取 mustache 的其他模板渲染器相比（例如chevron或pymustache）， Bonelate 针对 LaTeX 的语法做了很多优化，使模板文件在不渲染的情况下也可使用 LaTeX 工具编译通过。

背景

Bonelate 是从 BoneTeX 模板块分离出来的项目，可以独立使用。

优势

Bonelate 是参考 mustache 且针对 LaTeX 的语法微调了标记符， 原本的{{#partial}}改为{{!partial}}，从而在不渲染的情况下 LaTeX 编译时也不会报错。 通过 Bonelate，用户可以很方便的将现有 LaTeX 项目渐进地转换为 BoneTeX 项目。

安装

这个项目使用 Python 开发，请确保你本地安装了它。

使用PyPI安装

$ pip install bonelate[all]

源码安装

$ git clone [e-mail]:zrr1999/bonelate.git
$ cd bonelate
$ pip install .

使用说明

简单示例

from bonelate import render


test_string = """
        {{!persons}}{{name}} is awesome.{{/persons}}
        {{person}} is beautiful.
        {{!is_person}}{{.}} is a person.{{/is_person}}
        """
print(render(test_string, {
    "persons": [{"name": "Xiao Ming"}, {"name": "Yuan Long"}],
    "person": "Xiao Ming",
    "is_person": "Xiao Ming",
    "not_person": False
}))

命令行示例

如果你的环境变量中有 python 脚本目录，你可以使用

$ bonelate render .\examples\ml_work\bonework.tex .\examples\ml_work\data.json

如果没有的话，你需要使用如下命令

$ python bonelate render .\examples\ml_work\bonework.tex .\examples\ml_work\data.json

更新日志

0.1.0 (2021.5.2)

1. 重构 tokenizer，现在命名为parser。
2. 增加了 partial 语法。
3. 增加了 docs 目录。
4. 增加了更多例子。
5. 修改了单元测试。

0.0.2 (2021.4.29)

1. 不再兼容mustache语法。
2. 增加了命令行指令。
3. 增加了更多例子。
4. 添加了单元测试（不完全）。
5. 修复了大括号内的内容不能正常解析的问题。
6. 修复了模板变量中含有空白符不能正常解析的问题。

维护者

@六个骨头

如何贡献

非常欢迎你的加入！提一个 Issue 或者提交一个 Pull Request。

贡献者

感谢以下参与项目的人：

使用许可

MIT © Rongrui Zhan