在AnQiCMS中，网站的首页常常是访客了解网站内容的第一扇窗。如何高效、动态地展示最新的文章，吸引访客持续浏览，是内容运营的关键。AnQiCMS提供了灵活易用的模板标签系统，其中archiveList标签就是实现这一目标的核心工具。
理解archiveList标签的核心作用
archiveList标签是AnQiCMS模板系统中的一个强大工具，它允许你在网站的任何位置动态地调取文章（或其他内容模型，如产品）列表。无论是需要展示最新发布的文章、浏览量最高的文章，还是特定分类下的内容，archiveList都能通过简单的参数配置来实现。
要实现在首页展示最新文章列表，我们将主要关注archiveList的几个关键参数：
type: 这个参数决定了列表的类型。对于常规内容列表，我们通常会设置为"list"，表示只显示指定数量的内容而不会生成分页。order: 它定义了文章的排序方式。要显示“最新”文章，我们会根据文章的发布时间或ID进行倒序排序。在AnQiCMS中，"id desc"（按ID降序）或"CreatedTime desc"（按创建时间降序）是常见的选择。limit: 这个参数用于控制显示的文章数量，例如"10"表示显示最新的10篇文章。moduleId: 如果你的网站有多种内容模型（如文章、产品等），可以通过moduleId参数指定只显示特定模型的文章，避免产品信息出现在文章列表中。默认情况下，文章模型的ID通常是1。
在AnQiCMS首页展示最新文章列表的实际操作
现在，我们来一步步看看如何在你的AnQiCMS首页模板中实现最新文章的展示。
第一步：确定你的首页模板文件
在AnQiCMS中，首页的模板文件通常位于你的模板主题目录下的index/index.html或直接是index.html。你需要进入后台的“模板设计”功能，找到并编辑这个文件。
第二步：插入archiveList标签
在确定了要在首页显示最新文章的位置后，你可以插入archiveList标签。这个标签会定义一个变量，比如我们命名为archives，用于存储获取到的文章列表数据。
{% archiveList archives with type="list" order="id desc" limit="10" %}
{# 接下来在这里循环展示文章内容 #}
{% endarchiveList %}
在这段代码中：
archives是我们自定义的变量名，后续将通过它来访问每篇文章的数据。type="list"表示我们期望获取一个简单的文章列表。order="id desc"告诉系统按照文章ID从大到小排序，由于新发布的文章ID通常更大，这能有效地获取最新文章。limit="10"则指定了只显示最新的10篇文章。- 如果你只想展示“文章模型”下的内容，可以加上
moduleId="1"（假设你的文章模型ID是1），这样可以更精确地控制显示的内容类型。
第三步：循环展示文章信息
archiveList标签获取到文章列表后，你需要使用for循环来遍历archives变量，并从中提取每篇文章的具体信息进行展示。
{% archiveList archives with type="list" order="id desc" limit="10" %}
<ul>
{% for item in archives %}
<li>
<h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
<p>{{ item.Description|truncatechars:100 }}</p> {# 截取前100个字符作为简介 #}
<div>
<span>发布日期: {{ stampToDate(item.CreatedTime, "2006-01-02") }}</span>
<span>阅读量: {{ item.Views }}</span>
{% if item.Thumb %}
<img src="{{ item.Thumb }}" alt="{{ item.Title }}" style="width: 100px; height: auto;">
{% endif %}
</div>
</li>
{% empty %}
<li>目前还没有最新文章哦，敬请期待！</li>
{% endfor %}
</ul>
{% endarchiveList %}
在这段代码中：
{% for item in archives %}循环会依次处理每一篇最新文章。item是每次循环中代表当前文章的变量。{{ item.Link }}和{{ item.Title }}分别获取文章的链接和标题。{{ item.Description|truncatechars:100 }}会获取文章的描述，并使用truncatechars过滤器将其截取到前100个字符，防止内容过长影响布局。{{ stampToDate(item.CreatedTime, "2006-01-02") }}是AnQiCMS中一个非常实用的时间格式化函数。item.CreatedTime是文章的创建时间戳，通过"2006-01-02"这个Go语言风格的日期格式，你可以将其显示为常见的“年-月-日”格式。{{ item.Views }}显示文章的浏览量。{% if item.Thumb %}检查文章是否有缩略图，并根据item.Thumb展示。{% empty %}块是一个非常友好的设计。如果archives列表中没有任何文章，它就会显示{% empty %}后面的内容，而不是空空如也，提升用户体验。
优化与小贴士
- 日期格式化灵活性：
stampToDate函数非常灵活，你可以根据需求调整第二个参数来显示不同的日期和时间格式，例如"2006年01月02日 15:04"会显示为“年-月-日 时:分”。 - 内容简介截取：
truncatechars过滤器（按字符截取）和truncatewords过滤器（按单词截取）可以帮助你控制文章简介的长度，保持首页的整洁。 - 图片处理：
item.Thumb通常指向系统自动生成的缩略图，如果你希望使用文章首图或其他图片，可以尝试item.Logo或item.Images（Images是一个图片数组，需要循环遍历）。 - SEO友好： 最新文章列表有助于搜索引擎蜘蛛发现新内容，结合AnQiCMS内置的SEO功能，可以进一步提升新文章的收录效率和排名。
通过以上步骤，你就能在AnQiCMS的首页优雅地展示最新文章列表了。AnQiCMS的模板标签设计使得内容展示既直观又高效，让你可以专注于内容的创作和运营。
常见问题 (FAQ)
1. 我想在首页显示更多的最新文章，应该修改哪个参数？
要显示更多的最新文章，你需要调整archiveList标签中的limit参数。例如，如果想显示15篇文章，将limit="10"修改为limit="15"即可。
2. 我只想显示特定分类下的最新文章，应该怎么做？
如果你只想显示某个特定分类下的最新文章，可以在archiveList标签中添加categoryId参数。你需要先在后台找到该分类的ID（通常在分类管理页面的URL或编辑页面中可以看到），然后像这样使用：{% archiveList archives with type="list" order="id desc" limit="10" categoryId="你的分类ID" %}。
3. 为什么我配置了最新文章列表，但首页没有显示任何内容？
如果首页未显示内容，可能有几个原因：
- 无文章可显示： 检查你的后台是否已发布了文章，且文章状态为“已发布”。
moduleId配置错误： 如果你使用了moduleId，请确认其值是否正确对应文章内容模型。limit或order问题： 检查limit值是否合理，order参数是否正确（如"id desc"）。- 模板文件未保存或缓存问题： 确保模板文件已保存，并尝试清除AnQiCMS的系统缓存。
- 循环内部错误： 检查
for循环内部的代码是否有语法错误，导致无法正常渲染。可以尝试简化for循环内的代码，逐步排查。