Template模块文档翻译.docVIP

Template模块文档翻译 package Template; $Template::VERSION = 2.6; =head1 NAME Template - 在CGI中使用HTML模板的模块 =head1 SYNOPSIS 首先你需要创建一个模板 - 仅仅是带有扩展的标志的 HTML 文件, 最常见的扩展标志就是 TMPL_VAR 例如, test.tmpl: html headtitleTest Template/title body My Home Directory is TMPL_VAR NAME=HOME p My Path is set to TMPL_VAR NAME=PATH /body /html 现在创建一个小 CGI 程序: #!/usr/bin/perl -w use Template; # 打开HTML模板 my $template = Template-new(filename = test.tmpl); # 填充部分参数 $template-param(HOME = $ENV{HOME}); $template-param(PATH = $ENV{PATH}); #发送必须的 Content-Type，并且打印模板输出 print Content-Type: text/html\n\n, $template-output; 如果设置正确的话，运行CGI程序以后，将在浏览器中显示如下的内容： My Home Directory is /home/some/directory My Path is set to /bin;/usr/bin =head1 DESCRIPTION 本模块试图简单并且自然的使用 HTML 模板.她继承了 HTML 并且扩展了部分新的HTML标签 -TMPL_VAR,TMPL_LOOP,TMPL_INCLUDE,TMPL_IF,TMPL_ELSE和TMPL_UNLESS. 使用HTML和上述的标签编写的模板将会被调用，也就是说你的模板可以和你的脚本分离， 甚至可以由其他人来创建，修改，然后使用本模块来填充模板中的变量，循环和分支申明. 这将帮助你将脚本使用的 数据结构设计 和 HTML 分开. =head1 THE TAGS =head2 TMPL_VAR TMPL_VAR NAME=PARAMETER_NAME TMPL_VAR 标签非常的简单. 模板中的每个 TMPL_VAR 都要调用$template-param(PARAMETER_NAME = VALUE). 当页面输出的时候，TMPL_VAR 将会被你赋的变量值取代. 如果你没有设置模板中的一些变量值，在输出时仅仅跳过. 一个可选的属性：你可以在你的标签里面使用 ESCAPE=HTML ，以在输出前编码部 分HTML字符.也就是说, , , 和 字符将转换为 , , 和 . 这个属性在你的变量中如果包含HTML代码可能会带来麻烦的时候才非常有用. 例: input name=param type=text value=TMPL_VAR NAME=PARAM 如果你给 param() 传递类似与 sammy ，那么你将会在双引号部分引来麻烦. 在另外一个方面, 如果你使用ESCAPE=HTML, 例如: input name=param type=text value=TMPL_VAR ESCAPE=HTML NAME=PARAM 无论提交者提交的参数怎么变化，你将会得到任何你想得到的值. 你可以使用的格式： ESCAPE=HTML, ESCAPE=HTML 和 ESCAPE=1. 如果传递给 ESCAPE 的参数0，将关闭过滤，而且默认的设置是关闭的. 同样你也可以使用 ESCAPE=URL 来处理URL. 她将做 URL 过滤, 比如，替换 为 +和替换 / 为 %2F. 你也可以使用一个 DEFAULT 来设置缺省的默认值. 例如, 你要输出 the devil gave me a taco，如果 who 变量没有被设置. The TMPL_VAR NAME=WHO DEFAULT=devil gave me a taco. =head2 TMPL_LOOP TMPL_LOOP NAME=LOOP_NAME ... /TMPL_LOOP TMPL_LOOP标签比TMPL_VAR稍微复杂一点. TMPL_LOOP 允许你划定一块文本区块， 并且给她一个名字. 在区块内部，你可以放置TMPL_VAR标签. 为了循环，需要传递给 param()的参数分配(散列引用（hash refs）)一个表 (一个数组（array ref）). 循环将重述列表，并且给每个参数产生文本块. 未设置的参数将会被跳过. 举例