作为一位资深网站运营专家，我深知高效的内容管理系统对于网站成功的关键作用，尤其是在灵活的内容展示方面。安企CMS（AnQiCMS）凭借其强大的模板功能和简洁的Go语言架构，为我们提供了极大的便利。今天，我们就来深入探讨一下在AnQiCMS中，如何轻松获取单页面的标题、内容和链接，以便您能更好地定制和展示网站信息。

认识安企CMS中的“单页面”

在安企CMS中，单页面（Single Page）通常指的是那些内容相对独立、结构固定，不常进行频繁更新的页面，例如“关于我们”、“联系方式”、“服务条款”或者“隐私政策”等。这些页面往往承载着网站的基础信息和品牌故事，它们在网站结构中扮演着重要角色，却又不同于持续更新的文章或产品详情。安企CMS的“页面管理”功能便是为此类内容而生，它允许我们为每个单页面自定义内容、SEO信息甚至是独立的模板文件，如page/detail.html或page/{单页面ID}.html。

获取单个单页面的详细信息：pageDetail 标签的妙用

要获取某个特定单页面的详细信息，安企CMS提供了一个非常便捷的模板标签——pageDetail。这个标签如同一个智能的向导，能精准地从数据库中提取出你所需要的单页面数据。

1. 精准定位目标单页面

使用pageDetail标签时，你需要告诉它你想要哪一个单页面。你可以通过单页面的ID（id参数）或者其URL别名（token参数）来精确指定。例如，如果你知道“关于我们”页面的ID是1，你可以这样写：{% pageDetail with id="1" %}。如果你当前就在一个单页面上，并且希望获取当前页面的信息，那么甚至无需指定id或token，pageDetail标签会智能地识别并获取当前单页面的数据。

2. 获取单页面的标题

一旦指定了目标单页面，获取它的标题就轻而易举了。你只需在pageDetail标签中使用name="Title"参数。这会直接输出该单页面的清晰标题，用于网页的H1标签或者导航链接文本。

{# 假设获取ID为1的单页面标题 #}
<h1>{% pageDetail with name="Title" id="1" %}</h1>

{# 如果是当前单页面的标题 #}
<title>{% pageDetail with name="Title" %}</title>

3. 提取单页面的丰富内容

内容是单页面的核心。使用name="Content"参数，你可以轻松提取页面的主体内容。这部分内容通常是通过后台的富文本编辑器编辑的，可能包含图片、格式化的文本等。

<div class="page-content">
    {% pageDetail pageContent with name="Content" %}
    {{ pageContent|safe }}
</div>

这里有几个关键点需要注意：

  • |safe 过滤器： 如果你的单页面内容包含HTML标签（这在富文本编辑中非常常见），为了让浏览器正确解析这些标签并显示出排版后的效果，而非直接显示HTML代码，你必须配合使用|safe过滤器。它告诉模板引擎，这部分内容是安全的，无需进行转义。
  • render 参数（针对Markdown）： 如果你的安企CMS启用了Markdown编辑器来编写单页面内容，并且你希望模板自动将Markdown语法渲染成HTML，可以在name="Content"后添加render=true。

4. 获取单页面的访问链接

除了标题和内容，单页面的链接（URL）也是不可或缺的。使用name="Link"参数即可获取该单页面的访问路径，你可以将其应用于导航菜单、面包屑或者页面内的跳转按钮。

<a href="{% pageDetail with name="Link" %}">了解更多</a>

5. 其他有用的信息

pageDetail标签还能帮助您获取到单页面的摘要（Description）、缩略图（Thumb）甚至大图（Logo）等多种信息，这些都可以在模板中通过name参数指定来灵活调用。

获取单页面列表信息：pageList 标签的灵活运用

有时候，您可能需要在网站的某个区域（比如底部导航、侧边栏）展示多个单页面的列表，例如“关于我们”、“服务条款”和“联系方式”等。这时，pageList标签就派上用场了。

pageList标签会返回一个单页面对象的数组，你需要通过for循环来遍历这些对象。在循环的每次迭代中，你可以像获取单个单页面那样，通过item.Title、item.Link、item.Description等方式来访问每个单页面的属性。

<nav class="footer-links">
    <ul>
        {% pageList pages %}
        {% for item in pages %}
        {# 判断是否是当前页面，可以添加active样式 #}
        <li {% if item.IsCurrent %}class="active"{% endif %}>
            <a href="{{ item.Link }}">{{ item.Title }}</a>
            {# 如果需要显示简短描述，可以使用item.Description #}
            {# <p>{{ item.Description }}</p> #}
        </li>
        {% endfor %}
        {% endpageList %}
    </ul>
</nav>

这段代码会遍历所有已创建的单页面，并为每个单页面生成一个带有标题和链接的列表项。您可以根据需要调整for循环中的内容，例如添加缩略图item.Thumb或简短描述item.Description。

灵活运用模板语法

安企CMS的模板系统采用类似Django的简洁语法，使得内容的调用直观高效。

  • 变量引用： 使用双花括号{{变量名}}来输出变量的值，例如{{ item.Title }}。
  • 标签使用： 使用{% 标签名 参数 %}来调用功能性标签，例如{% pageDetail %}和{% pageList %}。
  • 过滤器： 通过管道符|来应用过滤器，对变量进行处理，例如|safe用于防止HTML转义。

通过熟练掌握pageDetail和pageList这两个强大的模板标签，您将能够轻松地在安企CMS中获取并展示单页面的标题、内容和链接，从而为网站的用户提供更丰富、更友好的内容体验。

常见问题 (FAQ)

  1. 为什么我的单页面内容显示的是HTML代码，而不是解析后的效果？ 这通常是因为您在输出单页面内容时，没有使用|safe过滤器。安企CMS为了安全起见，默认会对所有输出内容进行HTML转义。若内容中包含HTML标签，请务必在模板中像这样使用：{{ pageContent|safe }}。

  2. 我能否在pageDetail标签中不指定ID或URL别名，直接获取当前页面的单页面信息？ 是的，完全可以。当您的模板文件就是用于渲染某个单页面时（例如page/detail.html或`page/{单