您如何在 Liquid 中发表评论？

Question

用 Liquid 模板语言注释掉的正确方法是什么？

Answer 1

In Liquid you comment out using the {% comment %} and {% endcomment %} tags:

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

It doesn't matter if the comment is inline or a block comment.

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

Answer 2

Liquid allows you to leave un-rendered code inside a Liquid template by using the {% comment %} and {% endcomment %} tags.

Input:

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

Output:

Anything you put between  tags
is turned into a comment.

Reference documentation: Comment tag in Liquid

Answer 3

If, like me, you are looking for a solution that actually comments out "anything"/everything between the comment tags (as described in the documentation ), you can use the {% raw %} tag (in conjuction with the {% comment %} tag if you don't want anything rendered in the browser), eg

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

will render nothing at all, while

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

will render

Here is some text that I want displayed but

{% some_liquid_stuff_that_I_don't_want_parsed %}

Additional information on this GitHub thread .

Answer 4

In liquid, you use {% comment %} and {% endcomment %} tags:

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

You can also use it in block:

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

If the {% comment %} and {% endcomment %} tags would comment anything, including HTML elements and such:

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

Answer 5

In the liquid, using comment tag enclose the text to be commented inside the comment tag

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

Answer 6

Starting with Liquid 5.4.0 you will be able to use a short inline comment that does not require a closing tag! The syntax is:

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

As with other tags you can add hyphens to remove whitespace around it:

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

And even use multiple lines:

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

More info is available in the merged PR .