Gen-Template-for-Perl

HTML コメント型テンプレートエンジン
１．テンプレートエンジンとは
　１．１．テンプレートエンジンとは
　１．２．テンプレートエンジンの特徴
　１．３．既存のテンプレートエンジンの弱点

２． HTML コメント型テンプレートエンジン
　２．１．目的
　２．２．特徴
　２．３．機能

３．仕様
　３．０．記述方法
　３．１．メインブロック
　３．２．コメント
　３．３．データ
　３．４．ループ
　３．５．ＩＦ文
　３．６．ＵＮＬＥＳＳ文

テンプレートエンジンとは
テンプレートエンジンとは（ソース元： wikipedia)
テンプレートエンジンはテンプレートと呼ばれる雛形と、あるデータモデルで表現される入力データを合成し、成果ドキ
ュメントを出力するソフトウェアまたはソフトウェアコンポーネントである。テンプレートおよび成果ドキュメントは複
数のこともある。成果ドキュメントには様々なフォーマットのものがあり、文書・ウェブページ・ソースコードなどがそ
の例で、ドキュメント全体ではなく、その一部を出力することもある。

機能
template と data をテンプレートエンジンで処理することで結果の文章が得
られる

なぜ、テンプレートエンジンを使うのか？

テンプレートエンジンの特徴
テンプレートエンジンを使わないブログラムテンプレートエンジンを使ったプログラム
#!/usr/bin/perl
#!/usr/bin/perl
# これでページを参照した回数が取得できるとする
# これでページを参照した回数が取得できるとする
require(‘tool.pl’)
require(‘tool.pl’)
$count = &site_count();
$data->{‘count’} = &site_count();
$html = <<EOM;
require(‘template.pl’)
<html>
$template = new Template();
<body>
$html = $template->create_view(‘view’, $data);
EOM
print $html;
if ($count == 0) {
$html .= <<EOM;
<div> ようこそはじめまして！ </di>
view.html
EOM
} else { <html>
$html .= <<EOM; <body>
<div> ありがとうございます。 $count 回目の訪問ですね！ 
</div> はじめまして
EOM 
} <!--!count!
$html .= <<EOM; <!--=count=/ 回目の訪問です
</body> ね
</html> <!--/!count!
EOM </body>
# 出力 </html>
print $html

ロジックとデザインの分離が出来る

既存のテンプレートエンジンの
弱点
利点弱点
　１．ドキュメントが豊富　１．動作環境に制限がある（ Perl の 5.12 以上とか）
　２．機能が豊富　２．結局テンプレートに HTML 以外のものがあるので、
　　　 DreamWeaver のような WYSIWYG 系のソフトで、
　　　デフォルトのままでは編集しづらい
　３．機能な豊富なので覚える事が多い

既存の Perl 用テンプレートエンジン： Template-Toolkit の場合
#!/usr/bin/perl
view.html

# これでページを参照した回数が取得できるとする <html>
require(‘tool.pl’) <body> やっぱり HTML 以外が入る
$data->{‘count’} = &site_count(); [% IF count == 0 %] これでは、 DreamWeaver では
はじめましておかしくなる可能性がある
use Template; [% ELSE %]
$template = Template->new(); [% count %] 回目の訪問ですね
$template->process(‘view.html’, $data, $html,); [% END %]
print $html; </body>
</html>

やっぱり、 DreamWeaver でも使えるようにしたい！！

HTML コメント型テンプレートエンジンを
作った目的

１．ロジックとデザインの分離

２． DreamWeaver でも編集出来るテンプレート

３．学習コストを減らす

４．速度

HTML コメント型テンプレートエンジンの特徴

１．ロジックとデザインの完全な切り離し
　 HTML のコメントタグを使用した、テンプレートエンジンの実現

２． DreamWeaver でも編集出来るテンプレート
　 HTML のコメントタグを使用したことで、 HTML と解釈出来ないタグが、テンプレート上に存在しない

３．学習コストを減らす
　機能が少ないので、当然学習コストも低い

４．速度
　機能が少ないので、パフォーマンスチェックしていないが、それほど遅くはないはず
　（しかし、テンプレートキャッシュの機能がないので、キャッシュ機能を保持しているものよりは遅い）

HTML コメント型テンプレートエンジンの機能
１．メインブロック
　機能：テンプレートファイルの、使用する箇所を指定するタグ
　形式：ブロック形式
　記述方法： <!--%main% <!--/%main%/

２．コメント
　機能：テンプレートファイルから、ドキュメント生成時に削除する
　記述方法 1 ： {{ }}
　記述方法 2 ： <!--# <!--/#/

３．データ
　機能：ドキュメント生成時に、引数にて渡されたオブジェクトのハッシュの値と置き換える
　形式：ライン形式
　記述方法： <!--=data=/

４．ループ
　機能：開始タグから終了タグまでの間をキー値にて渡された配列の回数処理する
　記述方法： <!--~loop~ <!--/~loop~/

５．ＩＦ文
　機能：渡された判定オブジェクトに「 if_ キー値」のメソッドを呼び出し、戻り値が「 1 」の場合に表示する
　記述方法： <!--|if| <!--/|if|/

６．ＵＮＬＥＳＳ文
　機能：渡された判定オブジェクトに「 if_ キー値」のメソッドを呼び出し、戻り値が「 0 」の場合に表示する
　記述方法： <!--!unless! <!--/!unless!/

３． HTML コメント型テンプレートエンジンの仕様
記述方法
記述ルールは、
　【ブロック形式の場合】
　　開始タグの始め　＋　マーク　＋　 [ キー値　＋　マーク ] 　＋　開始タグの終わり
　　終了タグの終わり　＋　マーク　＋　 [ キー値　＋　マーク ] 　＋　終了タグの終わり
記述例）
■ ループの場合 ■ コメントの場合
 
ここは繰り返し処理されますここはコメントなのでテンプレートエンジンを通すと表示されません
 

【ライン形式の場合】
　簡易コメント：　 {{ コメントにする文字 }}
　データ： 
記述例）
■ データの場合


開始タグの始め： 
終了タグの始め： 
マーク： %( メインブロック ) 　 #( コメント ) 　 =( データ ) 　 ~( ループ ) 　 |(if 文 ) 　 !(unless 文 )

記述例
テンプレートエンジンの使い方
■ プログラム側

test.cgi

#!/usr/bin/perl 左の続き

use lib qw(. ./libs); package main;
use Gen::Template; use utf8;

# 条件分岐用クラス # 出力データの生成
package Page; my %data = (
sub new 'data1' => ' データ ',
{ 'loop1' => [
my $class = shift; {
bless {}, $class; 'name' => ' １つ目です ',
} 'check' => 1,
},
sub if_check {
{ 'name' => ' ２つ目です ',
my ($self, $data) = @_; 'check' => 0,
my $ret = 0; }
if ($data->{'check'} == 1) { ]
$ret = 1; );
}
return $ret; # テンプレートファイルの読み込み
} my $template = Gen::Template->new();
my $text = $template->load_template('./test_temp.html', 'utf8');
右に続く my $page = Page->new();
$text = $template->create_view($text, %data, $page);

print "Content-type: text/html; charset=UTF-8nn";
$text = $template->convert_encode($text, 'utf8');
print $text;

記述例
テンプレートエンジンの使い方
■ テンプレート側

test_temp.html

<html>
<body>
<h1>

</h1>


<h2>
check が 1 の時に表示されます <br>
:
</h2>


<h3>
check が 1 以外の時に表示されます <br>
:
</h3>


</body>
</html>

Gen-Template-for-Perl
Github : https://github.com/nasneg/Gen-Template-for-Perl

Gen-Template-for-Perl

Recommandé

Recommandé

Contenu connexe

Tendances

Tendances (19)

Similaire à Gen-Template-for-Perl

Similaire à Gen-Template-for-Perl (20)

Gen-Template-for-Perl