Форумы / National / Russian / Комментарий в шаблоне

Если мне нужен общий комментарий для шаблона, то я просто ставлю его в начале и выношу его за рамки главного блока:

# Файл шаблона для ...
# Еще описание

<!-- BEGIN:MAIN -->
[код шаблона]
<!-- END:MAIN -->

Символ `#` вначале —  как общепринятый маркер. и для визуального отделения от кода ашблона.

Если речь о «встроенных в код» комментариях, то, помоему, вы предложили очень элегантный способ.

Еще можно использовать такие варианты:

<!-- IF 0 -->Комментарий №1<!-- ENDIF -->

<!-- BEGIN:COMMENT -->Комментарий №2<!-- END:COMMENT -->

<!--BEGIN:_-->Комментарий №3<!--END:_-->

Если нам в каких-то случаях может потребоваться включить комментарии, то вариант с условием (`IF`) предпочтительный, и можно написать так:

<!-- IF {PHP.show_tpl_comments} -->Этот комментарий не будет отражен до того, как переменная `show_tpl_comments` не будет определена<!-- ENDIF -->

или так 

<!-- IF {PHP.cfg.debug_mode} -->Комментарий будет отражен только в режиме отладки<!-- ENDIF -->