在安企CMS中，单页面是构建“关于我们”、“联系方式”等静态内容页面的基础。有效展示这些页面的完整内容及其所有字段信息，对于网站的定制化和用户体验至关重要。安企CMS提供了直观且强大的模板标签，让您可以轻松地将后台配置的单页面数据呈现在网站前端。
要显示单个单页面的完整内容和所有相关字段，我们主要会用到 pageDetail 这个核心模板标签。这个标签能够帮助我们获取指定单页面的详细数据，并灵活地在模板中进行展示。
理解 pageDetail 标签的基本用法
pageDetail 标签有两种主要使用方式。您可以选择获取单页面的某个特定字段的值，也可以将整个单页面对象赋值给一个变量，然后通过这个变量来访问其各个字段。
如果您的页面已经是一个单页面详情页，并且您希望显示当前页面的信息，通常无需额外指定ID，pageDetail 标签会自动识别当前页面的上下文。当然，如果您需要在一个页面上显示另一个指定ID或URL别名的单页面信息，也可以通过添加 id 或 token 参数来实现精确调用。
例如，要直接显示当前单页面的标题，您可以这样写：{% pageDetail with name="Title" %}。
如果您想获取整个单页面对象，并将其赋值给一个名为 currentPage 的变量，则可以这样操作：{% pageDetail currentPage %}。接下来，您就可以通过 currentPage.Title、currentPage.Content 等形式来访问该单页面的各项数据了。
展示单页面的核心内容与基本信息
一个单页面通常包含标题、描述、内容等基本构成要素。安企CMS为这些核心字段提供了明确的调用方式。
- 页面标题 (Title)：这是单页面的主标题，通常显示在页面顶部或浏览器标签页中。您可以使用
{% pageDetail with name="Title" %}来获取。 - 页面内容 (Content)：这是单页面的主体内容，往往包含了丰富的文本、图片、视频等富媒体信息。在使用
{% pageDetail with name="Content" %}调用时，请务必配合|safe过滤器使用，以确保HTML内容能够被浏览器正确解析而非被转义为纯文本。如果您的内容是Markdown格式编写的，可以额外添加render=true参数，如{% pageDetail with name="Content" render=true %}，以便将其正确转换为HTML。 - 页面描述 (Description)：这通常是页面的简要概括，对SEO优化有帮助。它可以通过
{% pageDetail with name="Description" %}获取。 - 页面链接 (Link)：获取单页面的完整URL地址，方便在模板中创建跳转链接。调用方式为
{% pageDetail with name="Link" %}。
除了这些，您还可以显示单页面的唯一标识 Id ({% pageDetail with name="Id" %})，以及用于自定义伪静态URL的 自定义URL (token)。
处理图片与多媒体字段
单页面除了文本内容，可能还会包含图片，例如用于页面头部的Banner图或作为页面缩略图。
- 页面缩略图 (Thumb / Logo)：如果单页面设置了缩略图，您可以通过
{% pageDetail with name="Thumb" %}或{% pageDetail with name="Logo" %}来获取图片地址。这两个字段通常用于列表展示或作为页面的代表性图片。 - 页面幻灯片组图 (Images)：有些单页面可能需要展示一组图片作为轮播图或画廊。
Images字段会返回一个图片地址的数组。您需要结合for循环标签来遍历并展示这些图片。
如果您只想获取其中的第一张图片，可以利用数组索引来实现：{% pageDetail pageImages with name="Images" %} {% for item in pageImages %} <img src="{{ item }}" alt="图片描述" /> {% endfor %}{% set firstImage = pageImages[0] %}。
自定义模板与SEO相关字段
安企CMS允许为单页面设置独立的模板，以及进行细致的SEO优化。
单页面模板：在后台为特定单页面指定了独立模板文件（例如
download.html）后，系统会优先使用该模板。这意味着您可以在template/page/目录下创建download.html文件，并在其中编写针对该单页面的独特布局和样式。SEO标题 (SeoTitle)、关键词 (Keywords)：这些字段用于优化搜索引擎抓取和排名。虽然
pageDetail标签可以分别获取这些信息，但更推荐使用tdk标签来统一管理和输出页面的title、keywords和description，因为tdk标签会智能地根据当前页面类型（包括单页面）自动组合和展示这些信息，并能附加网站名称等。例如，在您的
base.html模板文件的<head>区域，您可能已经设置了类似这样的TDK标签，它会根据当前页面的类型智能地获取并显示相关信息：<title>{% tdk with name="Title" siteName=true %}</title> <meta name="keywords" content="{% tdk with name="Keywords" %}"> <meta name="description" content="{% tdk with name="Description" %}">
总结
通过 pageDetail 标签，您可以轻松访问和展示安企CMS单页面的各项信息，无论是基本内容、图片，还是SEO相关的元数据。在实际操作中，关键在于根据您的设计需求，选择性地调用这些字段，并结合模板引擎的循环、条件判断和过滤器，构建出既美观又实用的单页面。灵活运用这些工具，将使您的网站内容管理和展示更加高效。
常见问题 (FAQ)
1. 为什么我的单页面内容（Content）显示的是一堆HTML代码而不是格式化的文本？
这通常是因为您在模板中直接输出了 Content 字段，而没有使用 |safe 过滤器。安企CMS默认会对输出的HTML内容进行转义，以防止XSS攻击。为了让HTML内容被浏览器正确解析并显示为格式化的文本，您需要在输出 Content 字段时加上 |safe 过滤器，例如：{{ currentPage.Content|safe }}。如果内容是Markdown格式，还需确保启用了Markdown渲染，并使用 render=true 参数。
2. 如何为特定的“关于我们”单页面设置一个不同于其他单页面的独特布局？
您可以在安企CMS后台编辑该“关于我们”单页面时，在“其他参数”中找到“单页面模板”设置项。在此处填写您自定义的模板文件名，例如 about.html。然后，在您的主题模板文件夹（通常是 /template/您的主题名/page/ 目录下）创建 about.html 这个文件，并按照您的设计需求编写其内容。这样，只有这个特定的单页面会使用您指定的 about.html 模板，其他单页面仍将沿用默认的 page/detail.html 模板。
3. 我的单页面内容中包含图片，如何确保它们能够正确显示，并且支持懒加载？
单页面内容中的图片通常会通过内容编辑器插入，默认情况下它们会作为HTML的一部分存储在 Content 字段中。确保这些图片正确显示的第一步是像问题1中提到的，正确使用 |safe 过滤器。如果需要懒加载功能，您可能需要在模板中引入一个支持懒加载的JavaScript库。在调用 Content 字段时，您可以尝试添加 lazy="data-src" 等参数，如 {% pageDetail with name="Content" lazy="data-src" %}，这会通知安企CMS在渲染内容时将 src 属性替换为 data-src（或其他您指定的懒加载库所需的属性），从而配合前端懒加载脚本实现效果。