在 Jinja 中是否有用于记录宏的官方格式？

Question

我想记录我的 Jinja 宏是如何工作的。 Jinja 中是否有用于记录宏的官方格式，就像有多种格式化 Python 文档字符串的方法一样？
也许是这样的：

{% macro my_macro(arg0, arg1, ...) -%}
    {#
    Does something. <- summary of macro

    Parameters:
    arg0: (summary of arg0)
    arg1: (summary of arg1)
    ...
    #}
{%- endmacro %}

还是看个人喜好？

Answer 1

Jinja 宏只是一个 Python 函数。使用与记录普通 Python 函数相同的格式。