Как вы комментируете в Liquid?

Question

Как правильно комментировать на языке шаблонов Liquid?

Answer 1

В Liquid вы комментируете, используя {% comment %} а также {% endcomment %} теги:

{% comment %} This is a comment in Liquid {% endcomment %}

Неважно, является ли комментарий встроенным или блочным комментарием.

{% comment %}
    This is a block comment in Liquid
{% endcomment %}

Answer 2

Если, как и я, вы ищете решение, которое фактически комментирует "все"/ "все" между тегами комментариев (как описано в документации), вы можете использовать {% raw %} тег (в сочетании с {% comment %} тег, если вы не хотите, чтобы что-либо отображалось в браузере), например

{% comment %}
    {% raw %}
        Here is some text that I don't want displayed and
        {% some_liquid_stuff_that_I_don't_want_parsed %}
    {% endraw %}
{% endcomment %}

вообще ничего не будет отображать, а

{% raw %}
    Here is some text that I want displayed but
    {% some_liquid_stuff_that_I_don't_want_parsed %}
{% endraw %}

окажет

Вот текст, который я хочу отобразить, но

{% some_liquid_stuff_that_I_don't_want_parsed %}

Дополнительная информация в этой ветке GitHub.

Answer 3

Начиная с Liquid 5.4.0 вы сможете использовать короткие встроенные комментарии, не требующие закрывающего тега! Синтаксис:

      {% # This is a new inline comment! %}

Как и в случае с другими тегами, вы можете добавить дефисы, чтобы удалить вокруг них пробелы:

      {%- # This is a new inline comment without whitespace! -%}

И даже использовать несколько строк:

      {%- 
################################
#  This is a really big block  #
################################ 
-%}

Более подробная информация доступна в объединенном PR.

Answer 4

Liquid позволяет вам оставлять не визуализированный код внутри шаблона Liquid, используя {% comment %} а также {% endcomment %} теги.

Входные данные :

Anything you put between {% comment %} and {% endcomment %} tags
is turned into a comment.

Выход:

Anything you put between  tags
is turned into a comment.

Справочная документация: Тег комментария в Liquid

Answer 5

В жидкости вы используете {% comment %} а также {% endcomment %} теги:

{% comment %} This would be commented out {% endcomment %}

Вы также можете использовать его в блоке:

{% comment %}
    This would also be commented out
{% endcomment %}

Если {% comment %} а также {% endcomment %} теги будут комментировать все, включая элементы HTML и такие:

 {% comment %}
    <div class="commented_out">
    <p>This whole div would be commented out</p>
    </div>
{% endcomment %}

Answer 6

В жидкости с помощью тега комментария заключите текст для комментария внутри тега комментария

{%comment%}
Text to be commented
{%endcomment%}