So Outside Technology Security CMS
AnQiCMS
Online Demonstration

How to avoid Chinese garbled or incomplete truncation caused by the `slice` operation in AnQiCMS template?

Calendar 👁️ 76

When using AnQiCMS for website content development, you may encounter the use of filters in templatessliceThe filter fails to handle Chinese content properly, resulting in incomplete content truncation, which undoubtedly affects user experience and the accuracy of content presentation.Although the underlying design of the system is intended to avoid garbled characters, it is particularly important to understand its working mechanism due to the characteristics of Chinese multi-byte characters and the expected display effects.

AnQiCMS is a content management system developed based on the Go language, its template engine has good support for UTF-8 encoding, and explicitly requires that template files be unified in UTF-8 encoding.This is the basis for processing Chinese content and also the key to avoiding character garbling.sliceThe underlying logic of the filter is based on Go languagerune(i.e., Unicode code point, which can be understood as a single character) rather than bytes for operations. This means that when you usesliceWhen extracting Chinese content, it ensures the integrity of each Chinese character, so that no Chinese character will be cut in half, causing real garbled characters.

For example, if you have a Chinese string “Hello World”, and use{{ "你好世界"|slice:"1:3" }}to truncate, you will get “Good World”. Here is thesliceThe operation is performed according to the number of characters, starting from index 1 (the second character “好”) and ending before index 3 (the fourth character “界”).sliceThe filter itself is able to correctly identify and extract characters when processing UTF-8 encoded Chinese, and will not produce any "garbled" encoding.

However, why do you still feel that it is 'incomplete'? This is often due to the fact thatsliceThere is a deviation between the expected and actual behavior requirements.In front-end display scenarios, we may be more accustomed to cutting according to visual width (for example, a Chinese character usually occupies the width of two English characters visually), or automatically adding an ellipsis after cutting.sliceThe filter provides pure character count truncation, does not involve visual width adaptation, and will not automatically add ellipses.This difference may cause the content truncated to look 'incomplete' or 'too short'.

To avoid this misunderstanding and enhance the display effect of Chinese content, we recommend that you flexibly choose the appropriate filter when processing Chinese truncation in the AnQiCMS template:

First, make sure that all your AnQiCMS template files are saved in UTF-8 encoding format. This is the foundation for all character processing. Indesign-convention.mdZhong also emphasized this point:

Secondly, when you indeed need to cut the content strictly according to the number of characters (rune),slicethe filter is completely applicable. For example, if you want to get the first 10 characters of the content:{{ archive.Title|slice:":10" }}If your need is for front-end display, and you want to have an ellipsis prompt after truncation, thentruncatecharsortruncatechars_htmlThe filter will be a better choice.

  • truncatecharsFilterThis filter can intelligently handle multibyte characters and automatically add an ellipsis after truncating to a specified number of characters....It ensures the integrity of characters while also being more in line with common needs for text content preview. For example:{{ archive.Description|truncatechars:30 }}It will truncate the first 30 characters of the description and add an ellipsis as needed. For content containing HTML tags, you can usetruncatechars_htmlIt will try to maintain the integrity of the HTML structure when extracting.

  • lengthFilterUse it before extracting,lengthThe filter can obtain the actual character count of the content. This helps you to more accurately control the truncation length in backend logic or frontend judgment. For example:{% if archive.Title|length > 20 %}...{% endif %}.

  • make_listFilter: If you need to perform a more detailed character-level traversal or processing of Chinese content (for example, you need to make independent judgments or modifications for each character),make_listThe filter can split a string intoruneArrays, convenient for iteration operations.

In summary, AnQiCMS'ssliceThe filter processes Chinese text by using Unicode characters (rune) instead of bytes, which ensures the integrity of the encoding of Chinese content at the bottom level and avoids real garbled text. When you process Chinese content truncation in the AnQiCMS template, please choose flexibly according to your actual needsslice(For precise character number truncation),truncatecharsortruncatewords(For preview on the front end and automatically adding ellipses) and other filters to ensure the correct display and a good user experience.The key is to understand the mechanism of different filter functions and choose the tool that best suits your business scenario.

Frequently Asked Questions (FAQ)

  1. Question: Why does my Chinese title usesliceAfter truncation, although there is no garbled code, it still looks incomplete?Answer: This question may be due to the fact that thesliceMisunderstanding of behavior. In AnQiCMSsliceIt is cut according to the number of Unicode characters (rune), one Chinese character counts as one.rune. But if the display space reserved for the extracted content in the template is calculated based on the width of English characters (usually one Chinese character occupies two English character widths), then evenruneThe quantity is correct, and it may appear too short or incomplete visually. In this case, it is recommended to usetruncatecharsA filter that not only truncates characters but also intelligently adds ellipses, more in line with common text preview needs.

  2. Ask: Can AnQiCMS template directly cut Chinese content by byte number?Answer: AnQiCMS template filter (such asslice/truncatecharsAt the design stage, it took into account the integrity of Unicode characters, so it is default to be according torune(Characters) rather than bytes when performing operations to avoid garbled Chinese content due to byte truncation.The built-in filter does not provide direct functionality for truncating by byte count.We do not recommend doing this, as truncating multi-byte characters (such as Chinese) can easily lead to incomplete content and display garbled characters.If you indeed have such a special requirement, you may need to consider using custom template functions or performing byte-level processing on the backend in Go before the content enters the template, but this should be done carefully to avoid potential problems.

  3. Ask: My AnQiCMS template files are all saved in UTF-8, but occasionally some strange symbols still appear. What's the matter?Answer: Even if the template file is UTF-8 encoded, if the content source itself (such as reading from a database, user input, or third-party collection) contains non-UTF-8 encoded characters, or the character sequence does not conform to UTF

Related articles

Does Go template's `slice` filter support negative indices? How to use it to slice in reverse order?

In AnQiCMS, templates are the key to building dynamic content, allowing us to flexibly display data.In the process of template development, it is often encountered that string or list (usually slice in Go template, which can be understood as an array) truncation operations need to be performed.AnQiCMS provides a powerful `slice` filter to handle such needs.### Deeply understand the basic usage of `slice` filter The `slice` filter is mainly used to extract specified elements from strings or lists

2025-11-08

In AnQiCMS template, how to implement `slice` to extract a segment of content from a string?

In AnQi CMS template development, we often need to flexibly handle the displayed content, such as extracting key parts from a paragraph of text or simply displaying several items from the list.At this point, the `slice` filter is very practical.It can help us accurately extract a segment of content from the middle of a string or array (a slice in Go language).

2025-11-08

How does the `slice` filter handle string or array index out of bounds situations?

In Anqi CMS template development, the flexibility of data display is crucial for building dynamic and user-friendly websites.The `slice` filter is a powerful and practical tool that helps us accurately extract part of the string or array content.However, when performing such operations, we are bound to encounter index out of bounds situations, that is, attempting to access a position beyond the data range.Fortunately, the `slice` filter of Anqi CMS has considered these edge cases and provided a set of elegant solutions.

2025-11-08

How to use `slice` to get the last N elements of an array in AnQiCMS template?

In AnQiCMS template development, we often need to handle list or array type data, such as article lists, product lists, and so on.Sometimes, we might only be concerned with a part of these data, such as the latest few articles, or a specific number of elements at the end of the list.At this time, the `slice` filter built into AnQiCMS is particularly powerful and convenient.It allows us to flexibly extract elements from an array or string within a specified range.This article will thoroughly introduce how to use the `slice` filter in AnQiCMS templates

2025-11-08

How to assign the result of a `slice` filter to a new variable for subsequent use?

In AnQiCMS template development, we often need to process displayed data in various ways, such as truncating a segment of text, or extracting specific items from a list.The `slice` filter is born for this, it can help us accurately slice a part of the string or array.However, it is not enough to simply extract data, how to conveniently assign the extracted results to a new variable for repeated use in the subsequent parts of the template or for more complex logic processing, this is the key to improving template development efficiency and code readability.### `slice` filter basics

2025-11-08

Batch processing content: How to use `slice` to dynamically truncate strings of different lengths in a loop?

In website content operation, we often encounter situations where we need to display content in bulk, such as article lists, product introduction summaries, etc.In order to ensure the beauty of the page and the clarity of information presentation, we often need to truncate the titles or descriptions of these contents so that they can display different lengths in different areas or under different conditions.AnQiCMS provides powerful template tags and filters, making this requirement simple and flexible.

2025-11-08

AnQiCMS development: Application scenarios of the `slice` filter in handling list pagination or displaying summaries?

In AnQiCMS template development, the `slice` filter is a very practical tool that allows us to perform precise slicing operations on strings (text) or arrays (lists).Mastering its usage can help you gain more flexible control when handling content display.The basic syntax of the `slice` filter is `{{obj|slice:"from:to"}}`.Here the `obj` is the string or array variable you want to process, and `from` and `to` define the start and end positions

2025-11-08

Template optimization: What is the difference between the `slice` filter and the `truncatechars` filter? When should you choose which one?

In Anqi CMS template development, we often need to control or truncate the displayed content to adapt to different layout requirements and optimize the user experience.At this point, the `slice` filter and `truncatechars` filter have become our commonly used tools.Although they can all achieve text slicing, there is a significant difference in functional focus and application scenarios.Understanding these differences can help us choose the appropriate filters more accurately, making the template code more efficient and the page display more reasonable.

2025-11-08