In AnQiCMS template, after using the `-` symbol, do you still need to manually delete blank lines?

As an experienced website operations expert, I am well aware that every detail is crucial on the path to pursuing website performance and code cleanliness.AnQiCMS (AnQiCMS) provides powerful flexibility for content display with its efficient template engine based on the Go language.However, even the most exquisite tools may encounter some common minor "troubles" during use, one of which is the extra blank lines generated during template rendering.

Today, let's delve into a common issue in AnQi CMS template development: "In the AnQiCMS template, using-After the symbol, do you still need to manually delete blank lines?

Say goodbye to the trouble of blank lines: In the AnQiCMS template-The wonderful use and practical application of the symbol

When using any template engine for development, we often encounter a seemingly trivial but potentially affecting the page's neatness issue - that is, the unexpected blank lines in the HTML output.These blank lines may come from conditional judgment, loop structures, or the tags themselves in the template.For those of us who strive for ultimate optimization and code standards, these extra blank lines not only increase the size of the HTML file (although the individual impact is negligible, but when accumulated, it is not negligible), but may also affect page rendering, and even in some extreme cases, interfere with CSS layout.

The Anqi CMS template engine, its syntax is similar to the Django template engine, tags appear in pairs, such as{% if condition %}and{% endif %}. Traditionally, these tags, even if they do not output any actual content, often take up a line, resulting in an empty line in the HTML source code.Imagine a complex navigation menu that includes multiple layers of conditional judgments and loops. If each layer generates a blank line, the final HTML output may become very long and disorganized.

Luckyly, Anqi CMS fully considered this need and provided a simple yet powerful solution: using hyphens in template tags.-Control for blank lines.

-The mystery of the symbol: Precise trimming of label boundary blank

This-The symbol is not used for clearing labelsInternallyThe blank, but is specifically used to trimLabel outsideWhitespace adjacent, including newline characters. Its operation is very intuitive:

• {%- tag %}: When-The symbol is adjacent to the left curly bracket{After that, it will remove the tagOn the leftAll whitespace characters before the label, until a non-whitespace character is encountered.
• {% tag -%}: When-The symbol is adjacent to the right curly bracket.}It will remove the label before it.RightAll whitespace characters after the label until a non-whitespace character is encountered.
• {%- tag -%}If used together, it will remove all whitespace characters on both sides of the label.

Let's understand its effect through a simple example.

Suppose you have aforLoop, hoping it will output the list items in a compact format:

Unprocessed template code:

<ul>
{% for item in archives %}
    <li>{{ item.Title }}</li>
{% endfor %}
</ul>

HTML output that may be generated (including extra blank lines):

<ul>

    <li>文章标题1</li>

    <li>文章标题2</li>

</ul>

Each of these here:{% for %}and{% endfor %}Label, as well<li>The newline characters within the tags may leave blank lines in the final output, resulting in extra blank lines between list items.

Use-The optimized template code with symbols:

<ul>
{%- for item in archives -%}
    <li>{{ item.Title }}</li>
{%- endfor -%}
</ul>

Optimized HTML output:

<ul>
    <li>文章标题1</li>
    <li>文章标题2</li>
</ul>

By adding in{%- for ... -%}and{%- endfor -%}Added on both sides of the tag-Symbol, we successfully removed the extra blank lines that the tag itself may generate during rendering, making the final HTML structure more compact and tidy.This is especially valuable when building responsive layouts, generating JSON or XML, and other content that requires strict formatting.

Why is this detail so important?

1. Enhancing code readability and cleanliness:Remove unnecessary blank lines to make the HTML source code more concise, allowing developers to locate valid content more quickly during checking or debugging.
2. Slightly optimize page loading performance:Although a single whitespace character may not be significant in terms of file size, for large, high-traffic websites, the cumulative whitespace characters can increase the page file size, thereby affecting loading speed.
3. Improve search engine optimization (SEO):The search engine crawler parses the HTML structure when crawling pages.Although the direct impact of blank lines on SEO ranking is limited, a neat and efficient code structure is always beneficial.
4. Avoid layout issues:In some CSS layouts (especially those usinginline-blockIn the layout), whitespace characters between elements may be rendered as actual gaps by the browser, leading to design discrepancies._The symbol can effectively avoid such potential problems.

Therefore, is the Anqi CMS template-The symbol is a very practical feature that allows developers to control HTML output more finely, effectively solving the problem of blank lines caused by template tags.Mastering this skill will greatly benefit the performance and maintenance efficiency of your safe CMS website.

Frequently Asked Questions (FAQ)

1.-symbol will delete the spaces inside the template tag? Answer:No.-The design purpose of the symbol is to delete the tagsExternalAdjacent white space (including spaces, tabs, and newline characters), not the content inside the tag. For example,{% if condition -%}ofconditionThe surrounding spaces will be retained, but-%}The blank lines after it will be removed.

2. When is it most suitable to use-to control spacing with symbols? Answer:Most suitable in the following scenarios:

• List and navigation menu:When you want the list items (<li>When there are no extra spaces between the parentheses or navigation links.
• Table:When generating table rows (<tr>) and cells (<td>) maintain compactness.
• Embedded code block (such as JS or CSS):When you need to output irregularly neat JavaScript or CSS code snippets without extra line breaks affecting the format.
• Conditional statements and loops:When{% if %}/{% for %}Labels themselves will still produce blank lines when no content is output, affecting the layout.

3. Should I use symbols on all template tags?-Will this affect the readability of the template? Answer:Not all tags must be used-symbols. In many cases, retaining blank lines helps improve the readability of the template itself, such as between larger HTML blocks. Overuse-Symbols may make template code difficult to read and understand, as it forces multiline structures into single-line logic.It is recommended to selectively use it when encountering actual blank line issues or when there are explicit requirements for output format (such as performance optimization, specific layout needs) to balance readability and output effect.