<table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"><tr><th colspan="3" align="center">Smarty - the compiling PHP template engine</th></tr><tr><td width="25%" align="left" valign="bottom"><a href="language.basic.syntax.html" accesskey="P">Prev</a></td> <td width="50%" align="center" valign="bottom">Chapter 3. Basic Syntax[第3章.基本语法]</td> <td width="25%" align="right" valign="bottom"><a href="language.syntax.variables.html" accesskey="N">Next</a></td></tr></table>
# Comments[注释]
Template comments are surrounded by asterisks, and that is surrounded by the delimiter tags like so:{* this is a comment *}
Smarty comments are NOT displayed in the final output of the template, unlike <!-- HTML comments-->. These are useful for making internal notes in the templates which no one will see ;-)
模板注释被*星号包围,而两边的星号又被定界符包围,例如 {* this is a comment *} 。
smarty注释不会在模板文件的最后输出中出现,这与<!-- HTML 注释-->不同(译注:html注释在页面源码中可见,而smarty注释则不能)。这点非常有用,试想,注释只存在于模板里面,而在输出的页面中谁也看不见:)。
<table width="100%" border="0" cellpadding="0" cellspacing="0" class="EXAMPLE"><tr><td><div class="EXAMPLE"><a name="AEN162"/><strong>Example 3.1. Comments within a template</strong><br/><b>例 3-1.模板注释</b><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td> <p> {* I am a Smarty comment, I don't exist in the compiled output *}<br/> <html><br/> <head><br/> <title>{$title}</title><br/> </head><br/> <body><br/> {* another single line smarty comment *}<br/> <!-- HTML comment that is sent to the browser --><br/> {* this multiline smarty<br/> comment is<br/> not sent to browser<br/> *}<br/> {*********************************************************<br/> Multi line comment block with credits block<br/> @ author: bg@example.com<br/> @ maintainer: support@example.com<br/> @ para: var that sets block style<br/> @ css: the style output<br/> **********************************************************}<br/> {* The header file with the main logo and stuff *}<br/> {include file='header.tpl'}</p> <p>{* Dev note: the $includeFile var is assigned in foo.php script *}<br/> <!-- Displays main content block --><br/> {include file=$includeFile}<br/> {* this <select> block is redundant *}<br/> {*<br/> <select name="company"><br/> {html_options options=$vals selected=$selected_id}<br/> </select><br/> *}<br/> <!-- Show header from affiliate is disabled --><br/> {* $affiliate|upper *}<br/> {* you cannot nest comments *}<br/> {*<br/> <select name="company"><br/> {* <option value="0">-- none -- </option> *}<br/> {html_options options=$vals selected=$selected_id}<br/> </select><br/> *}<br/> </body><br/> </html></p> </td></tr></table></div></td></tr></table>
<table summary="Footer navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"><tr><td width="33%" align="left" valign="top"><a href="language.basic.syntax.html" accesskey="P">Prev</a></td><td width="34%" align="center" valign="top"><a href="index.html" accesskey="H">Home</a></td><td width="33%" align="right" valign="top"><a href="language.syntax.variables.html" accesskey="N">Next</a></td></tr><tr><td width="33%" align="left" valign="top">Smarty For Template Designers<br/> 模板设计者篇 </td> <td width="34%" align="center" valign="top"><a href="smarty.for.designers.html" accesskey="U">Up</a></td> <td width="33%" align="right" valign="top">Variables<br/> 变量</td> </tr></table>
- Smarty模板编译引擎
- 序
- 译序
- I.开始
- 第一章. 什么是Smarty?
- 第二章. 安装
- II.模板设计者篇
- 第三章.基本语法
- 注释
- 变量
- 函数
- 属性
- 双引号里嵌入变量
- 数学运算
- 忽略Smarty解析
- 第四章.变量
- 从PHP分配的变量
- 从配置文件读取的变量
- 变量范围
- {$smarty}保留变量
- 第五章.变量调节器
- capitalize
- cat
- count_characters
- count_paragraphs
- count_sentences
- count_words
- date_format
- default
- escape
- indent
- lower
- nl2br
- regex_replace
- replace
- spacify
- string_format
- strip
- strip_tags
- truncate
- upper
- wordwrap
- 第六章.组合修改器
- 第七章.内置函数
- {$var=}
- {append}
- {assign}
- {block}
- {call}
- {capture}
- {config_load}
- {debug}
- {extends}
- {for}
- {foreach},{foreachelse}
- @index
- {function}
- {if},{elseif},{else}
- {include}
- {include_php}
- {insert}
- {ldelim},{rdelim}
- {literal}
- {nocache}
- {php}
- {section},{sectionelse}
- .index
- {while}
- 第八章.自定义函数
- {counter}
- {cycle}
- {eval}
- {fetch}
- {html_checkboxes}
- {html_image}
- {html_options}
- {html_radios}
- {html_select_date}
- {html_select_time}
- {html_table}
- {mailto}
- {math}
- {textformat}
- 第九章.配置文件
- 第十章.调试控制台
- III.模板程序员篇
- 第十一章 常量
- SMARTY_DIR
- 第十二章 Smarty类变量
- $template_dir
- 第十三章.Smarty类方法
- append()
- appendByRef()
- assign()
- assignByRef()
- clearAllAssign()
- clearAllCache()
- clearAssign()
- clearCache()
- clearCompiledTpl()
- clearConfig()
- compileAllConfig()
- compileAllTemplates()
- configLoad()
- createData()
- createTemplate()
- disableSecurity()
- display()
- enableSecurity()
- fetch()
- getConfigVars()
- getRegisteredObject()
- getTags()
- getTemplateVars()
- isCached()
- loadFilter()
- registerFilter()
- registerPlugin()
- registerObject()
- registerResource()
- templateExists()
- unregisterFilter()
- unregisterPlugin()
- unregisterObject()
- unregisterResource()
- testInstall()
- 第十四章.缓存
- 建立缓存
- 多重缓存
- 缓存集合
- 控制插件输出的可缓存性
- 第十五章.高级特性
- 安全
- 通过模板更改设置
- 模板继承
- 数据流
- 对象
- 静态类
- 预过滤器
- 后过滤器
- 输出过滤器
- 缓存处理函数
- 资源
- 第十六章.以插件扩展Smarty
- 插件如何工作
- 命名约定
- 编写插件
- 模板函数
- 调节器
- 块函数
- 编译函数
- 预滤器/后滤器
- 输出过滤器
- 资源
- 插入
- Ⅳ.附录
- 第十七章.疑难解答
- Smarty/PHP 错误
- 第十八章.使用技巧和经验
- 空白变量处理
- 默认变量处理
- 传递变量标题给头模板
- 日期
- WAP/WML
- 组件化模板
- 拒绝电子邮件地址
- 第十九章. 相关资源
- 第二十章. 漏洞
- 3.0安装包
- 2.x版本升级至3.x版本的提示
- 3.0.x使用指南
- 翻译人员列表