如何包含 Template::Toolkit- 宏？

Question

这个问题是关于 Template::Toolkit (Perl)

中宏的用法

我无法编写宏并将它们放入单独的文件中以在其他几个模板文件中使用它们。

我的宏位于一个名为 macros.tt:

的单独模板文件中

----- file macros.tt ------
[% MACRO decorateStatus(status) BLOCK -%]
    [% ico = 'status_unknown' -%]
    [% IF status == "New" -%][% ico = 'status_waiting' -%]
    [% ELSIF status == "Working" -%][% ico = 'status_work' -%]
    [% ELSIF status == "Deleted" -%][% ico = 'status_deleted' -%]
    [% END -%]
    [% status %] <img src="[% c.uri_for('/images/ico/' _ ico _ '.png') %]" text="[% status %]">
[% END-%]

现在我正尝试在另一个模板中使用这个宏——但是由于宏没有展开而失败了：

----- file demo.tt -------
[% INCLUDE macros.tt %]
….
[% status = ‘New’ %]
<td>[% decorateStatus(status) %]</td>
….

将宏直接放在我要使用它的文件中，一切都按预期工作。

从不同文件中包含宏的“正确”方法是什么？

Answer 1

使用INCLUDE，所有变量定义（宏实际上只是一个奇特的变量）都本地化到包含的文件中。这意味着宏定义在包含的文件之外是不可见的。

要使宏在调用文件中可见，您需要 PROCESS 而不是 INCLUDE。作为 the documentation says:

The PROCESS directive is similar to INCLUDE but does not perform any localisation of variables before processing the template. Any changes made to variables within the included template will be visible in the including template.

Answer 2

如果您使用多个共享宏的模板文件，试试这个：

比在每个模板中包含 [% PROCESS 'macros.tt' %] 更容易和更清晰的是让 TT 在每次使用 PRE_PROCESS.

调用之前处理您的宏文件

use Template;

my $tt = Template->new({
    INCLUDE_PATH => '/usr/local/templates',
    PRE_PROCESS  => 'macros.tt',
})

如何包含 Template::Toolkit- 宏？

How to include Template::Toolkit- Macros?

perl

template-toolkit