Python 在Jinja中是否有记录宏的官方格式?
我想记录我的Jinja宏是如何工作的。在Jinja中是否有一种官方格式来记录宏,就像有多种方式来格式化Python文档字符串一样?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) ... #}
也许是这样的:
{% 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宏只是一个函数。这取决于您个人的喜好。