nDiki : Template::Provider

Template Toolkit UTF-8 UTF8 フラグ HTML FAQ インストール キャッシュ PAR Perl モジュール インタフェース Perl v5.8.4 拡張子 エラー

■ Template Toolkit + PAR

今回のプロジェクトに Template Toolkit を本格的に適用しようかと。 問題となるのは PAR にした時に、どのようにテンプレートを取得するか。 (PARでない場合は)テンプレートはモジュールと同じ位置にインストールしておき @INC から探すようにするつもり。

• PARのキャッシュディレクトリから読み込ませる -> PAR にはキャッシュ位置を取得する公開インタフェースが用意されていない。(今後)常にキャッシュディレクトリに展開されるとも限らない。
• Template::Provider をオーバーライドして、PAR から直接テンプレートをロードできるようにする -> http からのテンプレートの取得についてなどの話で FAQ に掲載されている方法。面倒。キャッシュ処理とかももっと面倒。

ということで泥臭いが「起動時に一時ディレクトリに展開してしまう」という方法を選択。 %PAR::LibCache を舐めて拡張子が '.tt2' であるものを、File::Temp で作ったディレクトリに放り込んで、Template の INCLUDE_PATH に指定する (実際には上記の処理を行うオブジェクトを作って INCLUDE_PATH で指定)。 Daemon 系ならこれで充分。

で、順次 Perl モジュールに散財していたHTML出力をテンプレートベースに変更。 コードがかなりすっきりしてきて気持ちいい。

今回の作業で @INC にサブルーチンリファレンスやら、オブジェクトやらを渡せることを初めてしった。実際 PAR で利用している。 CODE の混ざった @INC をそのまま Template の INCLUDE_PATH に渡すとエラーが起きるので除外したものを渡すように。

• 音楽再生にあわせて処理をする amaroK スクリプトを書いてみる (2006-01-31)
• [ Java ] 22:30 Cocoon2 はどうかな? (2001-12-05)
• NSIS が再び Linux でコンパイルできるように (2005-01-08)
• CGI プログラム、Out of memory! に泣く (2001-01-04)
• 私的10大ニュース2004 [ comp ] (2004-12-31)

■ Template Toolkit で UTF-8 なファイルを INCLUDE すると文字化け

"UTF8" flag に起因する既知の問題のようだ。

Perl v5.8.4 において Template Toolkit 2.14 だと化けるが、2.13 以前 (2.13 と 2.10 で確認)だと大丈夫。

Template::Providerを継承して UTF8 フラグまわりの処理をする自前の Provider を作ってそれを使うという手もあるようだが、今回は 2.13 を使う事で対処。

• Template Toolkit 2.14 の UNICODE パラメータ (2004-11-03)
• [WiKicker] WiKicker の文字化け対応 (2004-02-03)
• Template Toolkit + PAR (2004-09-13)
• YAML Perl モジュール (2004-05-19)
• [ WiKicker ] hell mode - HTMLタグ付けブロックの導入 (2005-09-13)

■ Template Toolkit 2.14 の UNICODE パラメータ

Template Toolkit で UTF-8 なファイルを INCLUDE すると文字化けする問題だが、ソースを読んでみると Template::Provider に UNICODE という undocumented な初期化パラメータを発見。

Template (か Template::Provider) を new するときに UNICODE => 0 すれば化けなくなった。 "UTF8" flag を立てないで文字列を扱っているスクリプトはこれでOKか?

• Template Toolkit で UTF-8 なファイルを INCLU... (2004-10-29)
• [WiKicker] WiKicker の文字化け対応 (2004-02-03)
• Template Toolkit + PAR (2004-09-13)
• [ WiKicker ] hell mode - HTMLタグ付けブロックの導入 (2005-09-13)
• YAML Perl モジュール (2004-05-19)