Velocity模板中的注释

Velocity ——VTL模板中的注释

　　注释允许在模板中包含描述文字，而这些文字不会被放置到模板引擎的输出中。注释是一种有效的提醒自己和向别人解释你的VTL语句要做什么事情的方法。你也可以把注释用来做其他你认为有用的用途。下面就是一个注释的例子。

　　## This is a single line comment.

　　一个单行的注释以##开始，直到行尾才结束。如果你要写很多行的注释，那么不用使用多各单行注释，VTL还提供了多行注释。多行注释以#*开始，以*#结束。下面是一个多行注释的例子。

　　This is text that is outside the multi-line comment.

　　Online visitors can see it.

　　#*

　　Thus begins a multi-line comment. Online visitors won't

　　see this text because the Velocity Templating Engine will

　　ignore it.

　　*#

　　Here is text outside the multi-line comment; it is visible.

　　在使用Velocity引擎解析上面的模板时，输出的结果是：

　　This is text that is outside the multi-line comment.

　　Online visitors can see it.

　　Here is text outside the multi-line comment; it is visible.

　　可以看到，多行注释内的内容是不会输出的。

　　下面的例子阐明了注释的用法：

　　This text is visible. ## This text is not.

　　This text is visible.

　　This text is visible. #* This text, as part of a multi-line comment,

　　is not visible. This text is not visible; it is also part of the

　　multi-line comment. This text still not visible. *# This text is outside

　　the comment, so it is visible.

　　## This text is not visible.

　　用Velocity引擎解析上面的模板，输出的结果是：

　　This text is visible. This text is visible.

　　This text is visible. This text is outside

　　the comment, so it is visible.

　　在VTL中还有第三种注释：VTL注释块。VTL注释块用来保存如文档的作者、版本号等信息。例如：

　　#**

　　This is a VTL comment block and

　　may be used to store such information

　　as the document author and versioning

　　information:

　　@author

　　@version 5

　　*#