Template Toolkit 的配置选项

  今天用 Catalyst 写一个 RSS 聚合器程序的时候，发现 TT 的配置总是出错。后来才发现原来是配置选项出了点问题。

原来的代码差不多是这样子的：

package Feeder::V::TT;
use strict;
use base 'Catalyst::View::TT';
use Template::Constants qw( :debug );
__PACKAGE__->config({
    # any TT configurations items go here
    INCLUDE_PATH => Feeder->config->{'home'} . '/templates/',
    POST_CHOMP   => 1,
    PRE_CHOMP    => 1,
    EVAL_PERL    => 1,
    PRE_PROCESS  => 'header.tt',
    POST_PROCESS => 'footer.tt',
    DEBUG        => DEBUG_PARSER | DEBUG_PROVIDER,
    CONTEXT      => undef,
    # two optional config items
    CATALYST_VAR => 'Catalyst',
    TIMER        => 1,
});

可怎么运行都不行。试了好一会儿，后来才发现原来 Template 的 INCLUDE_PATH 默认是用 : 来分隔多个路径的，比如：

INCLUDE_PATH => '/home/abw/templates:/usr/share/templates',

这样就是两个路径。而我运行在 Win32 下，发现 Template 将 E:/Fayland/Feeder/templates 划分为了两个路径 E 和 /Fayland/Feeder/templates, 所以运行程序总是跳出找不到模版文件。知道原因后查了查 Perl Template Toolkit 一书，在配置里加了一句：

DELIMITER    => ';',

这样就不是用 : 而是用 ; 来划分了。

这只是因为自己不熟悉 Template 的配置选项。于是就复习了一遍，将常用的几个翻译如下：

ABSOLUTE

指出用绝对路径的文件是否被解析。默认为 0.
如 /foo/bar 在 1 时为绝对路径而在 0 时为相对路径。
在 0 时使用类如 [% INSERT /etc/passwd %] 会出错，除非相对路径也有这文件。

ANYCASE

指示性要害字如 INCLUDE 是否答应小写

BLOCKS

此选项用于预先定义一系列模版块。

my $tt = Template->new({
    BLOCKS => {
        header  => 'The Header.  [% title %]',
        footer  => sub { return $some_output_text },
        another => Template::Document->new({ ... }),
    },
});

Hash 的值可以是模版内容，子程序或是 Template::Document
这样我们就可以在其他模版文件里调用它们。

COMPILE_DIR/COMPILE_EXT

Template 可以将模版文件编译成 Perl 文件保存以便接下来的再次调用。

my $tt1 = Template->new({
    COMPILE_DIR => '/tmp/ttc',
    COMPILE_EXT => '.ttc1',
});

COMPILE_DIR 是地址，COMPILE_EXT 为后缀名。

DELIMITER

这就是我所碰到的问题解决方案。解释见最前面。

# Win32 only
my $tt = Template->new({
    DELIMITER    => ';',
    INCLUDE_PATH => 'C:/TT2/Templates;D:/My Templates',
});

CONSTANTS

编译时编译一次这些常量，而不是每次运行都编译一次。这样能稍微提高点速度。

my $tt = Template->new({
    CONSTANTS => {
        title   => 'A Demo Page',
        author  => 'Joe Random Hacker',
        version => 3.14,
    },
};

CONSTANT_NAMESPACE

所有定义的 CONSTANTS 默认用 [% constants.title %] 来获得。而 CONSTANT_NAMESPACE 用来改变前缀。如：

CONSTANTS_NAMESPACE => 'const',

后，可以用 [% const.title %] 来访问。
共3页: 上一页 1 [2] [3] 下一页

评论加载中…