root/websites/perl-users.jp/ttroot/modern_introduction_perl/template-tt.html @ 16718

[% TAGS asp -%]
<% WRAPPER modern_introduction_perl/wrapper.tt,
    title => "Template-Toolkit - モダンなPerl入門",
    last_modified => '$Date: 2008-05-22T09:21:23.154313Z $'
-%>
<%- USE Markdown -%><%- FILTER markdown -%>

Template-Toolkit
==============================================================================

Template-Toolkit は perl の世界でもっともよく使われているテンプレートエンジンの一つです。

### つかいかた

    # hoge.pl
    use strict;
    use warnings;
    use utf8;
    use Template;
    
    my $tt = Template->new(
        ENCODING => 'utf-8',  # utf-8で保存されたテンプレートファイルを utf8 flag つきでロードする
    );
    $tt->process('hoge.tt', { author => "アンディ" }, \my $out) or die $tt->error;
    
    binmode STDOUT, ':utf8'; # utf-8で出力するというオマジナイ
    print $out;

    # または
    # use Encode;
    # print Encode::encode('utf-8', $out);

    # hoge.tt
    わたしのなまえは [% author %] です。

ね。かんたんでしょ。

#### テンプレートファイルを utf-8 以外で記述したいのですが。。。

    my $tt = Template->new(
        ENCODING => 'euc-jp', # とか
    );

### Template::Provider::Encoding を使う方法

    # hoge.pl
    use strict;
    use warnings;
    use utf8;
    use Template;
    use Template::Provider::Encoding;

    my $tt = Template->new(
        LOAD_TEMPLATES => [ Template::Provider::Encoding->new ],
    );
    $tt->process('hoge.tt', { author => "アンディ" }, \my $out) or die $tt->error;
    
    binmode STDOUT, ':utf8'; # オマジナイ
    print $out;

    # hoge.tt
    わたしのなまえは [% author %] です。

#### テンプレートファイルを utf8 以外で記述したいのですが。。。

    [% USE encoding 'cp932' %]

のように書くとよい。Template::Provider::Encoding を使うとこのようにテンプレートごとにエンコーディングを変えられます。

### 備考

Template::Stash::ForceUTF8 は、BK なのでできるだけつかわないようにしたほうがよいでしょう。

<%- END -%><%- END -%>