Files
smarty/docs/en/designers/language-basic-syntax/language-syntax-comments.xml

68 lines
1.5 KiB
XML
Raw Normal View History

2004-04-13 08:46:28 +00:00
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
2004-04-18 17:34:12 +00:00
<sect1 id="language.syntax.comments">
<title>Comments</title>
<para>
Template comments are surrounded by asterisks, and that is surrounded
2005-05-27 16:25:02 +00:00
by the
<link linkend="variable.left.delimiter"> delimiter</link>
2006-02-18 13:43:35 +00:00
tags like so: <emphasis>{* this is a comment *}</emphasis>
2005-05-27 16:25:02 +00:00
Smarty comments are NOT displayed in the final output of the template,
unlike &lt;!-- HTML comments --&gt;
2006-02-18 13:43:35 +00:00
and are useful for making internal notes in the templates.
2004-04-18 17:34:12 +00:00
</para>
<example>
<title>Comments</title>
<programlisting>
2004-04-13 08:46:28 +00:00
<![CDATA[
2005-05-27 16:25:02 +00:00
<body>
2005-09-13 19:32:43 +00:00
{* a single line comment *}
2005-05-27 16:25:02 +00:00
{* this multiline
comment is
not sent to browser
*}
2004-04-13 08:46:28 +00:00
{* include the header file here *}
2006-02-18 13:43:35 +00:00
{include file='header.tpl'}
2004-04-13 08:46:28 +00:00
2005-05-27 16:25:02 +00:00
2005-09-13 19:32:43 +00:00
{* Dev note: $includeFile is assigned in foo.php script *}
2005-05-27 16:25:02 +00:00
<!-- this html comment is sent to browser -->
2004-04-13 08:46:28 +00:00
{include file=$includeFile}
{include file=#includeFile#}
2005-09-13 19:32:43 +00:00
{* this <select> block is redundant *}
{*
2004-04-13 08:46:28 +00:00
<select name="company">
2005-05-27 16:25:02 +00:00
{html_options options=$vals selected=$selected_id}
2004-04-13 08:46:28 +00:00
</select>
2005-09-13 19:32:43 +00:00
*}
2006-02-18 13:43:35 +00:00
2005-05-27 16:25:02 +00:00
</body>
2004-04-13 08:46:28 +00:00
]]>
2004-04-18 17:34:12 +00:00
</programlisting>
</example>
2004-04-13 08:46:28 +00:00
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->