如何获取并显示文章(文档)的标题、详细内容、简介和推荐属性?

📅 👁️ 88

在安企CMS中,无论是展示单个文章的详细内容,还是在列表页中预览多篇文章,灵活地获取并显示文章的标题、详细内容、简介和推荐属性都是网站运营的基础。安企CMS的设计使得这一过程直观而高效,我们主要通过模板标签和变量调用的方式来实现。

首先,了解安企CMS的模板系统是关键。它采用了类似于Django的模板引擎语法,这意味着您将主要使用双花括号 {{变量}} 来显示数据,以及单花括号和百分号 {% 标签 %} 来执行逻辑判断或调用特定功能。


获取和显示单个文章的详细信息

当您访问一篇具体的文章页面时,通常需要展示其完整的标题、详细内容、简洁的介绍以及可能设置的推荐属性。安企CMS为当前页面的文章提供了一个名为 archive 的全局变量,您可以直接通过它来访问文章的各项字段。

1. 文章标题 (Title)

文章的标题是内容的灵魂,在详情页中,您可以通过以下方式轻松获取并显示:

<h1>{{archive.Title}}</h1>

如果您的模板需要获取指定ID文章的标题,可以使用 archiveDetail 标签,并传入文章的ID:

{# 获取ID为10的文章标题 #}
<h2>{% archiveDetail with name="Title" id="10" %}</h2>

2. 详细内容 (Content)

文章的核心内容是详细信息的重要组成部分。安企CMS的 archive.Content 字段包含了文章的完整内容,这可能包括HTML标签或Markdown格式的文本。为了确保HTML内容能够正确渲染而不是作为纯文本显示,您需要使用 |safe 过滤器。如果内容是Markdown格式,安企CMS会自动将其转换为HTML:

<div class="article-content">
    {{archive.Content|safe}}
</div>

若您希望获取指定ID文章的详细内容,同样可以使用 archiveDetail 标签:

{# 获取ID为10的文章详细内容,并正确渲染HTML #}
<div class="other-article-content">
    {% archiveDetail articleContent with name="Content" id="10" %}
    {{articleContent|safe}}
</div>

3. 文章简介 (Description)

文章简介是对内容的简要概括,在详情页中通常用于SEO优化或作为内容的快速预览。安企CMS会将您在后台填写的简介原样输出。如果您在发布文章时没有手动填写简介,系统会自动提取文章内容的前150字作为简介。

<p class="article-description">
    {{archive.Description}}
</p>

同样,针对指定文章ID获取简介:

{# 获取ID为10的文章简介 #}
<p class="other-article-description">
    {% archiveDetail with name="Description" id="10" %}
</p>

4. 推荐属性 (Flag)

安企CMS允许您为文章设置多种推荐属性,如头条、推荐、幻灯等,它们在后台以单个字母(例如 h 代表头条,c 代表推荐)来标识。在文章详情页,{{archive.Flag}} 将直接显示这些属性字母。

<p class="article-flags">推荐属性:{{archive.Flag}}</p>

这些属性字母可以用于在模板中进行条件判断,例如,判断文章是否被设置为头条:

{% if archive.Flag | contain: "h" %}
    <span class="flag-headline">头条</span>
{% endif %}

获取和显示文章列表中的信息

在分类页、首页或其他列表页面,您可能需要展示多篇文章的简略信息,包括标题、简介和推荐属性,以及文章链接和缩略图等。这时,archiveList 标签就派上了用场。

1. 文章列表的获取与遍历

archiveList 标签用于获取一个文章列表,您可以根据需要设置不同的筛选条件,如分类ID、显示数量、排序方式等。获取到的文章列表是一个数组对象,需要通过 for 循环来遍历。

{% archiveList archives with type="list" limit="10" categoryId="1" %}
    {% for item in archives %}
        <div class="article-item">
            {# 这里将显示每篇文章的标题、简介、推荐属性等 #}
        </div>
    {% endfor %}
{% endarchiveList %}

上述代码中,type="list" 表示获取一个普通列表,limit="10" 限制显示10篇文章,categoryId="1" 则指定了文章所属的分类ID。archives 是您自定义的变量名,代表获取到的文章列表。

2. 显示列表中的文章标题和链接

在列表循环中,item.Title 用于显示每篇文章的标题,item.Link 则提供了文章的访问链接:

<h3><a href="{{item.Link}}">{{item.Title}}</a></h3>

3. 显示列表中的文章简介

在文章列表中,我们通常会显示简介而非详细内容,以提供快速预览:

<p class="item-description">{{item.Description}}</p>

4. 列表中的推荐属性

推荐属性在列表页中通常有两种用法:一是用于筛选文章,二是用于在文章旁边显示一个小图标或标记。

  • 筛选列表中的推荐文章: 如果您只想显示被设置为“推荐”属性的文章,可以在 archiveList 标签中添加 flag="c" 参数(假设 c 代表推荐)。请注意,每次调用 archiveList 标签时,只能使用一个推荐属性进行筛选。

    ”`twig {# 只显示被设置为“推荐”属性的文章列表 #} {% archiveList recommendedArticles with type=“list” limit=“5” flag=“c” %}

    {% for item in recommendedArticles %}
        <div class="recommended-
    

相关文章

AnQiCMS如何支持多模板切换功能,以及如何为特定页面或内容类型指定独立模板?

## AnQiCMS的灵活面:如何驾驭多模板切换与个性化页面设计 在内容管理系统中,一套灵活的模板机制是网站保持竞争力、适应多样化运营需求的关键。AnQiCMS作为一款高效的企业级内容管理系统,在这方面展现出了出色的能力,它不仅支持整站级别的多模板切换,更提供了为特定页面或内容类型指定独立模板的细致功能,这对于需要进行精细化内容运营的网站来说,无疑是一项强大的利器。 首先

2025-11-07

如何使用`for`循环标签在AnQiCMS模板中遍历并显示列表数据?

在AnQiCMS模板中,动态地展示列表数据是构建丰富网站内容的核心操作之一。无论是展示最新的文章、热门产品、分类列表,还是任何自定义的内容集合,`for`循环标签都是您的得力助手。它让您能够轻松遍历数据,并根据需求定制每一项的显示方式。 ### 理解`for`循环标签的基础 `for`循环标签是AnQiCMS模板引擎中用于遍历集合数据的一种控制结构。它的基本语法非常直观

2025-11-07

在AnQiCMS模板中,如何利用`if-else`条件判断标签控制内容的显示逻辑?

## 在AnQiCMS模板中,巧用`if-else`条件判断标签,让内容展示更智能 在网站内容运营中,我们常常需要根据不同的条件来展示不同的内容或样式。例如,当文章列表为空时显示“暂无内容”,当某篇文章是推荐状态时加上“HOT”标记,或者为循环中的第一个项目添加特殊样式。安企CMS(AnQiCMS)的模板系统充分考虑了这些需求,借鉴了Django模板引擎的强大语法

2025-11-07

如何使用Django模板引擎语法在AnQiCMS中高效显示各类动态内容?

在安企CMS中管理网站内容,您会发现其内置的Django模板引擎语法是极其强大和灵活的工具,它能帮助您高效地将后台数据转化为前端页面上生动活泼的动态内容。掌握这套语法,您不仅能展示基本的文本和图片,更能构建复杂的、互动性强的动态页面,让您的网站充满活力。 安企CMS的模板语法设计得非常直观,它借鉴了Django模板引擎的特点,并融入了Go语言的简洁高效。您主要会接触到两种核心元素

2025-11-07

如何有效地获取并显示文章的缩略图、封面首图或多张图片集合?

在内容运营中,引人入胜的图片是吸引读者、提升文章质量不可或缺的元素。安企CMS(AnQiCMS)深知这一点,为您提供了多样化且灵活的功能,无论是文章列表的缩略图、详细页面的封面首图,还是内容丰富的多图集合,都能轻松获取并以您期望的方式展示。 ### 安企CMS如何处理各类图片? 在安企CMS中,图片通常分为几种类型,以满足不同场景下的展示需求: * **文章缩略图(Thumb):**

2025-11-07

AnQiCMS如何实现文章列表的分页显示功能,以及如何自定义分页样式和逻辑?

在内容运营中,文章列表的分页显示是一个基础而关键的功能,它不仅影响用户浏览体验,更与网站的性能和SEO表现息息相关。AnQiCMS作为一个高效、可定制的内容管理系统,为我们提供了灵活的方式来实现和美化文章列表的分页功能。 ### AnQiCMS 中的文章列表分页:轻松掌握显示与个性化定制 在网站内容日益丰富的今天,如何高效地组织和展示大量文章,同时保证用户体验流畅

2025-11-07

在文章详情页,如何获取并显示上一篇和下一篇文章的标题及链接?

在我们的网站运营中,提供流畅的用户体验是至关重要的。当访问者阅读完一篇内容丰富的文章时,他们往往希望能顺藤摸瓜,继续浏览同类别或相关主题的其他内容。在这种情况下,在文章详情页显示“上一篇”和“下一篇”文章的标题及链接,就显得尤为重要。这不仅能显著提升用户的阅读体验,减少他们离开网站的几率,还能有效引导用户在网站内部进行深度浏览,间接帮助提升网站的SEO表现

2025-11-07

如何在文章详情页配置并显示相关文章列表,并指定相关性规则(如关键词或手动设置)?

在网站运营中,如何让访客在阅读完一篇精彩文章后,能够轻松发现更多相关内容,持续探索您的网站,这不仅能显著提升用户体验,也是优化网站SEO、降低跳出率的关键策略。安企CMS(AnQiCMS)提供了强大而灵活的功能,让您能够轻松在文章详情页配置和展示相关文章列表,并根据实际需求指定相关性规则。 接下来,我们将一起了解如何在安企CMS中实现这一目标。 ### 理解相关文章列表的价值 想象一下

2025-11-07