mirror of
https://github.com/smarty-php/smarty.git
synced 2025-11-03 13:51:36 +01:00
86 lines
2.2 KiB
XML
86 lines
2.2 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!-- $Revision$ -->
|
|
<sect1 id="language.syntax.comments">
|
|
<title>Comments</title>
|
|
<para>
|
|
Template comments are surrounded by asterisks, and that is surrounded
|
|
by the
|
|
<link linkend="variable.left.delimiter">delimiter</link>
|
|
tags like so: <literal>{* this is a comment *}</literal>
|
|
Smarty comments are NOT displayed in the final output of the template,
|
|
unlike <literal><!-- HTML comments --></literal>
|
|
these are useful for making internal notes in the templates which no one will see ;-)
|
|
</para>
|
|
<example>
|
|
<title>Comments within a template</title>
|
|
<programlisting>
|
|
<![CDATA[
|
|
{* I am a Smarty comment, I don't exist in the compiled output *}
|
|
<html>
|
|
<head>
|
|
<title>{$title}</title>
|
|
</head>
|
|
<body>
|
|
|
|
{* another single line smarty comment *}
|
|
<!-- HTML comment that is sent to the browser -->
|
|
|
|
{* this multiline smarty
|
|
comment is
|
|
not sent to browser
|
|
*}
|
|
|
|
{*********************************************************
|
|
Multi line comment block with credits block
|
|
@ author: bg@example.com
|
|
@ maintainer: support@example.com
|
|
@ para: var that sets block style
|
|
@ css: the style output
|
|
**********************************************************}
|
|
|
|
{* The header file with the main logo and stuff *}
|
|
{include file='header.tpl'}
|
|
|
|
|
|
{* Dev note: the $includeFile var is assigned in foo.php script *}
|
|
<!-- Displays main content block -->
|
|
{include file=$includeFile}
|
|
|
|
{* this <select> block is redundant *}
|
|
{*
|
|
<select name="company">
|
|
{html_options options=$vals selected=$selected_id}
|
|
</select>
|
|
*}
|
|
|
|
{* cvs tag for a template, below the 36 SHOULD be an american currency
|
|
. however its converted in cvs.. *}
|
|
{* $Id: Exp $ *}
|
|
{* $Id: *}
|
|
</body>
|
|
</html>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</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
|
|
-->
|