docs/ru/designers/language-basic-syntax/language-syntax-comments.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2628 Maintainer: freespace Status: ready -->
<sect1 id="language.syntax.comments">
 <title>Комментарии</title>
 <para>
  Комментарии в шаблонах заключаются в звездочки (*) окруженные
  <link linkend="variable.left.delimiter">разделителями</link>,
  например:
 </para>
 <informalexample>
  <programlisting>
<![CDATA[
{* это комментарий *}
]]>
  </programlisting>
 </informalexample>
  
 <para>
  Smarty НЕ отображает комментарии в выводе шаблона, в отличие
  от <literal>&lt;!-- комментариев HTML --&gt;</literal>.
  Они используются для внутренних примечаний в шаблонах, которые никто
  не увидит ;-)
 </para>
 <example>
  <title>Комментарии внутри шаблона</title>
  <programlisting>
<![CDATA[
<body>
{* Я - простой комментарий Smarty, я не существую в скомпилированном выводе *}
<html>
<head>
 <title>{$title}</title>
</head>
<body>

{* другой однострочный комментарий Smarty *}
<!-- HTML-комментарий, который будет отправлен браузеру -->

{* этот многострочный комментарий
   не отправляется в бразуер
*}

{*********************************************************
 Многострочный блок комментариев с информацие об авторе 
  @ author:         bg@example.com
  @ maintainer:     support@example.com
  @ para:           var that sets block style
  @ css:            the style output
**********************************************************}

{* Файл-заголовок с главным логотипом и т.д. *}
{include file='header.tpl'}


{* Примечание разработчика: переменная $includeFile назначается в скрипте foo.php *}
<!-- Отображает блок комментариев главного контента -->
{include file=$includeFile}

{* этот блок <select> ненужен *}
{*
<select name="company">
  {html_options options=$vals selected=$selected_id}
</select>
*}

<!-- Отображение заголовков от аффилиатор отключено -->
{* $affiliate|upper *}

{* вложенные комментарии использовать нельзя *}
{*
<select name="company">
  {* <option value="0">-- нет -- </option> *}
  {html_options options=$vals selected=$selected_id}
</select>
*}

{* cvs-тэг шаблона: эти 36 ДОЛЖНЫ быть американской валютой,
   но в таком случае CVS обработает их *}
{* &#36;Id: Exp &#36; *}
{* $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
-->