How to apply the `wordwrap` filter in AnQiCMS Markdown rendering content?

How to ensure that information is presented to visitors in the clearest and most friendly manner in content management and website operations, is a core issue that every content operator pays attention to.AnQiCMS as an efficient content management system provides a rich set of features and flexible template mechanisms, including various practical filters to help us finely process content.Today, let's delve deeply into one of the frequently mentioned but easily misunderstood filters -wordwrapAnd its role in handling Markdown rendering content.

I.wordwrapFilter: elegant line break for long text

In the process of content creation, we often encounter long text or code blocks. If not handled properly, they may exceed the container on the page, affecting the overall layout and reading experience.wordwrapThe filter is designed for this purpose, its core function is to automatically wrap a long text according to the specified character length.

Imagine, when you are using the Markdown editor on the AnQiCMS backend to write a technical article, it contains a long code example or a long English description without natural breakpoints.If not processed, this content may cause a horizontal scrollbar on small screen devices, or overflow in a fixed-width layout. At this time,wordwrapThe filter can intervene to automatically insert line breaks in the text when it reaches a preset length, thereby improving the readability of the content and the beauty of the page.

wordwrapThe principle of the filter's operation is relatively straightforward: it identifies 'words' based on spaces in the text, and then tries to break lines between words within a specified length. This means that if your text is composed of English words separated by spaces,wordwrapIt can maintain the integrity of words very well. However, for Chinese characters that are continuous, since there is no natural space separation,wordwrapThe filter does not force line breaks in the middle of Chinese characters. This is a feature that needs to be paid special attention to when in use.

Second, applying in AnQiCMS templatewordwrapFilter

AnQiCMS template system is based on Django template engine syntax, making the application of filters very simple and intuitive.wordwrapThe basic usage format of the filter is:{{ 变量 | wordwrap: 长度 }}. Among them,变量is the text content you want to process,长度Is the maximum number of characters you expect per line of text.

For example, if you have a variable namedlong_descriptionA text variable, you want it to wrap at every 20 characters, you can write it like this:

{{ long_description|wordwrap:20 }}

How is it applied in AnQiCMS's Markdown rendering content?

Here we need to understand the process of AnQiCMS handling Markdown content. When you enable the Markdown editor and in the content field (such asarchive.ContentAfter entering Markdown text, the system will convert it to HTML. The document mentions,ContentThe field will automatically convert content to Markdown to HTML when the Markdown editor is turned on, and you can even specify the conversion through parameters.render=trueParameter manual conversion.

An important clarification is: wordwrapFilters are designed to processplain text strings. If you directly apply to Markdown content that has already been rendered into HTML (for example,{{ archive.Content | render=true | wordwrap:20 | safe }}This usage), it will try to perform a line break within HTML tags, which is very likely to destroy the HTML structure and cause the page to display abnormally. Therefore,It is strongly recommended not to usewordwrapApply directly to Markdown rendering results that already contain HTML tags.

Then, in the context of Markdown rendering content,wordwrapWhere is it more suitable to apply?

1. Process specific plain text paragraphs from Markdown source (use with caution): If your Markdown content field contains long paragraphs that you know are plain text (not processed through Markdown syntax), and you