跳转到主要内容

用于记录Jinja2模板文件的简单工具

项目描述

作者:

Hartmut Goebel <h.goebel@crazy-compilers.com>

许可:

GNU通用公共许可证v3或更高版本(GPLv3+)

此工具允许您将文档直接写入jinja2模板文件作为注释。然后,这些注释将被转换为文本,而模板代码则进入文字块。

这类似于一种 可读编程,只不过您不是将代码写入文本,而是将文本写入代码。这种差异使得可以直接使用模板文件而无需任何预处理。

用法

jinja2rst [-h] infile outfile

positional arguments:
  infile      jinja2-template-file to read (`-` for stdin)
  outfile     rst-file to write (`-` for stdout)

optional arguments:
  -h, --help  show this help message and exit

如何工作

此脚本将所有以#开头的行(以及仅由#组成的行)视为文本行。其余内容将被视为“代码”。文本行将移除#,而“代码”将添加前置空格。

此外,在“代码”块的开始和结束处,将添加所需的reStructuredText行。此外,如果需要,在“代码”块的开始处,还将添加一个::

示例

您可以在examples目录中找到jinja2-input、rst-output和生成的html示例。您也可以在线查看生成的html,地址为https://rawgit.com/htgoebel/jinja2rst/develop/examples/main.html

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源分布

jinja2rst-0.1.tar.gz (21.0 kB 查看哈希值)

上传时间

支持