In website content management, we often need to precisely control the length of text, which not only concerns the beauty of the page but also directly affects search engine optimization (SEO) and user experience.For example, set an appropriate number of characters for the meta description of a search engine, or ensure consistent length when displaying article summaries on a list page.AnQiCMS (AnQiCMS) provides us with an intuitive way to achieve this goal with its flexible and powerful template engine.

Most of the time, people may confuse the 'word count' with the 'character count'.It is particularly important to distinguish between these two when dealing with multilingual content, especially Chinese.A Chinese character is usually considered a character, but it is not a standalone 'word'.If we need to accurately know how many characters a string contains, including punctuation, spaces, and characters of various languages, we need a tool that can count accurately, not just English words.

AnQiCMS's template system borrows the syntax of the Django template engine, making it very convenient for content developers to create templates and handle data processing.The system is built-in with rich filters (filters), which can help us perform various operations on variables, including the string length calculation we are focusing on today.

To accurately count the number of characters in a string, AnQiCMS provideslengthFilter. This filter is very practical, it can accurately count the actual UTF-8 character count of a string.This means that whether it is English letters, numbers, symbols, or Chinese characters, each one is counted as a character, thereby providing the most accurate length.

Uselengtha very straightforward method, we just need to add it after the variable that needs to be calculated for length|lengthJust do it.

For example, if you want to know the number of characters in an article title:

{# 假设 archive.Title 是文章标题变量 #}
<p>文章标题字符数：{{ archive.Title|length }}</p>

Similarly, if you want to limit the display length of an article description and need to know the original number of characters without breaking the HTML structure:

{# 假设 archive.Description 是文章描述变量 #}
<p>文章描述原始字符数：{{ archive.Description|length }}</p>
{# 如果需要截取，可以使用 truncatechars_html 过滤器，它会同时维护 HTML 结构 #}
<p>截取后的文章描述：{{ archive.Description|truncatechars_html:100|safe }}</p>

Even for a string written directly in the template, we can easily obtain its character count:

<p>“安企CMS”的字符数：{{ "安企CMS"|length }}</p>
{# 输出结果会是：4 #}
<p>“AnQiCMS”的字符数：{{ "AnQiCMS"|length }}</p>
{# 输出结果会是：7 #}

These character counts calculated in the template can be applied to various scenarios. For example, on the page's<head>The area is for setting dynamic meta descriptions and titles for SEO, ensuring they comply with the recommended length of search engines:

<head>
    {% tdk seoTitle with name="Title" siteName=true %}
    {% tdk seoDescription with name="Description" %}
    <title>{{ seoTitle }}</title>
    <meta name="description" content="{{ seoDescription }}">
    {# 可以额外展示字符数以供调试或参考 #}
    <!-- 当前页面标题字符数：{{ seoTitle|length }} -->
    <!-- 当前页面描述字符数：{{ seoDescription|length }} -->
</head>

In addition to simple display,lengthThe filter can also be used with conditional judgment tagsifCombine usage to provide more intelligent control for page content. For example, if the article title is too long, we may need to apply different CSS styles to it:

{% if archive.Title|length > 30 %}
    <h1 class="long-title">{{ archive.Title }}</h1>
{% else %}
    <h1>{{ archive.Title }}</h1>
{% endif %}

This flexibility allows us to dynamically adjust the display method of content based on the change in the number of characters, thereby optimizing the user interface and content presentation.

In summary, AnQiCMS provideslengthThe filter is a powerful assistant we use to precisely control the number of characters in a string in the template.It is simple to use, able to accurately process various characters, whether it is used for SEO optimization or to enhance user experience, it can play an important role.By combining with other template tags and filters, we can build more intelligent and demand-compliant content display solutions.

Frequently Asked Questions (FAQ)

1.lengthFilters andwordcountWhat are the differences between filters?

lengthThe filter is used to calculate the string inallThe total number of UTF-8 characters, including spaces, punctuation, and text of various languages, each one counts as a character. AndwordcountThe filter is mainly based on spaces to distinguish and calculatewordsThe number of. For example, for the Chinese sentence, "Anqi CMS is very useful",lengthit will return 7 (if spaces are included), whereaswordcountit may return 4.

2.lengthDoes the filter support non-string data types?

According to the AnQiCMS template document,lengthThe filter can obtain the length of 'string, array, and key-value pairs'. If you pass a number directlylengthA filter that usually tries to convert the number to a string before calculating its character length. For arrays and key-value pairs,lengththe filter returns the number of elements or key-value pairs they contain.

3. Is the character count of Chinese content accurate in AnQiCMS?

Yes, it is AnQiCMS'slengthThe filter can accurately calculate the number of characters in Chinese content. It uses UTF-8 encoding for character counting, ensuring that each Chinese character is correctly identified and counted as a character, which is particularly important for content management on multilingual websites.