Python 在Jinja中是否有记录宏的官方格式?

Python 在Jinja中是否有记录宏的官方格式?,python,django,flask,jinja2,docstring,Python,Django,Flask,Jinja2,Docstring,我想记录我的Jinja宏是如何工作的。在Jinja中是否有一种官方格式来记录宏,就像有多种方式来格式化Python文档字符串一样? 也许是这样的: {% macro my_macro(arg0, arg1, ...) -%} {# Does something. <- summary of macro Parameters: arg0: (summary of arg0) arg1: (summary of arg1) ... #}

我想记录我的Jinja宏是如何工作的。在Jinja中是否有一种官方格式来记录宏,就像有多种方式来格式化Python文档字符串一样?
也许是这样的:

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

    Parameters:
    arg0: (summary of arg0)
    arg1: (summary of arg1)
    ...
    #}
{%- endmacro %}
{%macro my_macro(arg0,arg1,…)-%}
{#

做一些事情。只需使用与记录普通Python函数相同的格式,因为Jinja宏只是一个函数。

这取决于您个人的喜好。