如何在AnQiCMS中获取并显示特定单页面的内容和标题？

在AnQiCMS中，单页面是网站结构中非常实用的一部分，它们通常用于展示“关于我们”、“联系方式”等静态内容。作为内容运营者，您可能会经常需要在网站的不同位置获取并展示这些特定单页面的内容和标题。AnQiCMS提供了直观且强大的模板标签，让这个过程变得十分简单。

理解AnQiCMS中的单页面

AnQiCMS的设计理念之一就是内容的高度可定制性。单页面在后台的“页面资源”模块中进行管理，您可以为每个单页面设定独立的标题、内容、关键词、描述，甚至自定义URL和专属的模板文件。这种灵活性使得单页面不仅能承载丰富的信息，还能完美融入网站的整体设计风格。

在AnQiCMS的模板体系中，您会发现它采用了类似Django模板引擎的语法，使用双花括号 {{变量}} 来输出变量，而条件判断和循环控制则使用 {% 标签 %} 结构。所有的模板文件都建议统一采用UTF-8编码，以避免出现乱码问题。

获取特定单页面的内容和标题的核心工具：pageDetail 标签

要获取并显示特定单页面的内容和标题，我们主要会用到pageDetail这个模板标签。这个标签专门设计用于提取单个页面的详细信息。

pageDetail标签的基本用法是：{% pageDetail 变量名称 with name="字段名称" id="页面ID" %}。

这里的变量名称是一个可选参数，如果您设定了它，就可以通过这个变量来调用获取到的数据。如果省略了变量名称，pageDetail标签会直接输出指定name字段的值。name参数则用于指定您想要获取的具体字段，而id或token参数则用来指定是哪个单页面。

获取单页面的标题

要显示某个单页面的标题，您需要在name参数中指定Title。例如，如果您想获取当前正在访问的单页面的标题，您可以这样写：

<h1>{% pageDetail with name="Title" %}</h1>

如果您想获取ID为10的单页面的标题，无论当前是哪个页面，都可以这样操作：

<p>这是ID为10的单页面标题：{% pageDetail with name="Title" id="10" %}</p>

除了通过页面ID来指定，您还可以使用单页面的URL别名（即token）来指定页面。这在您希望通过更具描述性的URL来引用页面时非常有用。例如，如果您的“关于我们”页面的URL别名设置为about-us，您可以这样获取其标题：

<p>关于我们页面的标题是：{% pageDetail with name="Title" token="about-us" %}</p>

获取单页面的内容

获取单页面的主要内容也同样简单，只需要将name参数设置为Content即可。需要注意的是，单页面内容通常包含HTML标签，为了让浏览器正确解析并显示这些格式，您需要配合|safe过滤器使用。|safe过滤器会告诉模板引擎这部分内容是安全的HTML，不需要进行转义。

如果您在后台启用了Markdown编辑器来编辑单页面内容，并且希望在前端将其渲染为HTML，可以在Content字段后添加render=true参数：

<div>
    {% pageDetail pageContent with name="Content" render=true %}
    {{ pageContent|safe }}
</div>

如果您的内容不是Markdown，或者您不希望进行Markdown渲染，render参数可以省略。

以下是一个获取当前单页面内容的示例：

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

实际应用示例：在侧边栏显示“联系我们”单页面的标题和简介

假设您有一个“联系我们”的单页面，其ID为5，您希望在网站的侧边栏显示它的标题和部分内容（简介）。

<aside class="sidebar-contact">
    <h2>{% pageDetail with name="Title" id="5" %}</h2>
    <p>{% pageDetail with name="Description" id="5" %}</p>
    <a href="{% pageDetail with name="Link" id="5" %}" class="btn-more">了解更多</a>
</aside>

在这个例子中，我们通过指定id="5"，获取了特定单页面的标题（Title）、描述（Description）和链接（Link），并将它们显示在侧边栏中。

小贴士和**实践

1. 善用|safe过滤器：当您显示任何可能包含HTML的内容（如单页面内容、文章内容）时，务必使用|safe过滤器，否则HTML标签可能会被作为纯文本显示出来。
2. 自定义URL别名提升SEO：为单页面设置有意义的自定义URL别名（token），不仅方便记忆和引用，也有助于提升搜索引擎优化效果。
3. 模板文件的命名约定：AnQiCMS支持为特定单页面设置自定义模板。例如，您可以创建template/your_template_folder/page/about.html文件，并在后台“页面管理”中，为“关于我们”页面指定使用这个模板。这样可以实现更细致的页面布局控制。
4. 后台管理：在“页面资源” -> “页面管理”中，您可以方便地创建、编辑和管理所有的单页面。在这里设置的“页面名称”、“自定义URL”、“SEO标题”和“单页面内容”等都会直接影响前端的调用效果。

通过灵活运用pageDetail标签和相关参数，您将能轻松驾驭AnQiCMS的单页面内容展示，无论是构建标准的企业官网，还是复杂的营销型站点，都能得心应手。

常见问题 (FAQ)

1. 为什么我的单页面内容显示的是原始HTML代码，而不是格式化的内容？ 这很可能是因为您在调用单页面内容时没有使用|safe过滤器。AnQiCMS的模板引擎为了安全考虑，默认会对所有输出内容进行HTML转义，以防止XSS攻击。如果您的单页面内容是富文本编辑器编辑的HTML，请务必在显示时加上|safe过滤器，例如 {{ pageContent|safe }}。

2. 我想在文章详情页的侧边栏引用并显示一个特定单页面的标题，应该怎么操作？ 您可以在文章详情页的模板中，使用pageDetail标签并明确指定单页面的id或token。例如，如果您想显示ID为5的“联系我们”页面的标题，可以这样写：<h3>{% pageDetail with name="Title" id="5" %}</h3>。这样，无论当前文章是什么，都会显示指定单页面的标题。

3. 如果我想为某个特定的单页面使用完全不同的布局，而不是使用默认的page/detail.html，应该怎么操作？ AnQiCMS支持为每个单页面指定自定义模板。您可以在您的模板文件夹（例如template/default）下创建一个新的模板文件，比如page/custom-about.html。然后，在后台的“页面管理”中编辑该单页面，找到“单页面模板”设置项，填入custom-about.html即可。这样，该单页面就会使用您自定义的布局。