在网站运营中，我们经常需要创建一些内容相对固定、信息量较大的独立页面，例如“关于我们”、“联系我们”、“服务条款”或“隐私政策”等。这些页面通常被称为单页面内容，它们是网站不可或缺的一部分，用于向访客提供核心信息、建立信任或引导操作。

AnQiCMS 为管理和展示这类单页面内容提供了直观且灵活的解决方案。它将单页面视为一种特殊的内容类型，让我们可以像管理文章或产品一样，轻松地对其进行创建、编辑和发布，并通过模板实现多样化的展示效果。

一、AnQiCMS 中单页面内容管理概览

AnQiCMS 将单页面内容的管理集中在后台的“页面资源”模块下，您可以在这里找到“页面管理”功能。点开后，您会看到一个清晰的列表，展示了所有已创建的单页面，以及它们的基本信息。这个界面是我们创建、编辑、删除单页面内容的起点，整个过程非常流畅和便捷。

单页面与普通文章或产品的主要区别在于，它们通常没有分类的概念，或者说它们自身就代表了一种独立的“分类”。这使得单页面的管理逻辑更加简单，我们无需为它们设置复杂的分类结构。

二、创建与编辑单页面内容：字段详解与实践

当您在“页面管理”中点击“添加单页面”或编辑现有页面时，会看到一系列直观的字段，这些字段共同构成了单页面的完整信息：

  1. 页面名称： 这是单页面最直接的标识，例如“关于我们”。它会显示在后台管理列表，也是前端页面标题或导航名称的重要来源。
  2. 自定义URL： 为了方便用户记忆和搜索引擎优化（SEO），AnQiCMS 允许您为单页面设置一个友好的、伪静态的URL。例如，将“关于我们”页面的URL设置为 /about.html。系统默认会根据页面名称自动生成拼音URL，但您也可以手动修改，确保其唯一性。一个清晰、简洁的URL有助于提升页面的可访问性和SEO表现。
  3. 单页面内容： 这是单页面的核心，一个功能丰富的富文本编辑器让您可以轻松编辑文字、插入图片、嵌入视频、设置格式等。甚至，AnQiCMS 也支持 Markdown 编辑器，这意味着您可以方便地使用 Markdown 语法来编写内容，并在前端渲染出精美的排版。对于静态信息页而言，这里是您展示所有细节的地方。
  4. SEO标题、关键词与简介： 这些字段对搜索引擎优化至关重要。
    • SEO标题 用于告诉搜索引擎该页面的核心主题，通常会显示在搜索结果中。
    • 关键词 则是您希望通过该页面获得的搜索词，多个关键词之间用英文逗号分隔。
    • 单页面简介 提供页面的概括性描述，常被搜索引擎用作搜索结果的摘要。合理填写这些信息，能有效提升单页面在搜索引擎中的可见度。
  5. Banner图与缩略图： 这些是页面的视觉元素。
    • Banner图 适用于页面顶部需要展示大幅背景图或轮播图的情况，为页面增添视觉吸引力。
    • 缩略图 则可能在某些列表页或分享到社交媒体时作为预览图使用。
  6. 显示顺序： 当您在前端需要按照特定顺序展示多个单页面（例如在页脚导航中），这个字段可以帮助您调整它们的排序，数字越小越靠前。
  7. 单页面模板： 这是AnQiCMS在单页面展示上的一个强大且灵活的功能。默认情况下，所有单页面都会使用 page/detail.html 这个模板文件进行展示。但如果某个单页面（比如“联系我们”）需要独特的布局或样式，您可以：
    • 在您的模板目录下创建一个名为 page/contact.html （假设您的自定义URL别名为 contact）或 page/{单页ID}.html 的模板文件。
    • 然后在后台编辑该单页面时，在“单页面模板”字段中填入 contact.html。 这样，该页面就会自动加载并使用您指定的 contact.html 模板，而不是默认的 page/detail.html。这为设计师和开发者提供了极大的自由度，可以为每个重要单页面量身定制外观。

三、单页面内容的展示与模板调用策略

在AnQiCMS的前端模板中，您可以通过特定的标签来调用和展示这些单页面内容。这主要依赖于 pageDetail 和 pageList 两个标签。

  1. 展示单个页面的详细内容 (pageDetail)： 这是最常用的方式，通常用于 page/detail.html 或您自定义的单页面模板中。例如，要显示“关于我们”页面的标题和内容：

    <h1>{% pageDetail with name="Title" %}</h1>
<div class="page-content">
    {# 注意：如果内容是HTML格式，需要使用 |safe 过滤器防止被转义 #}
    {% pageDetail pageContent with name="Content" %}{{ pageContent|safe }}
</div>

    您也可以通过 id 或 token 参数指定调用特定单页面的内容，而不仅仅是当前页面的内容。例如，在网站首页调用“关于我们”的简介：

    {% pageDetail aboutUs with name="Description" token="about-us" %}
<p>{{ aboutUs }}</p>

  2. 列出多个单页面信息 (pageList)： 当您需要在网站的页脚、侧边栏或其他导航区域列出多个单页面的链接时，pageList 标签就派上用场了。例如，在页脚展示“关于我们”、“联系我们”和“隐私政策”的链接：

    <ul>
{% pageList pages %}
    {% for item in pages %}
        {# 可以根据页面ID或自定义URL别名排除不需要的页面 #}
        {% if item.Id != 999 and item.Link != "/some-excluded-page.html" %}
        <li><a href="{{ item.Link }}">{{ item.Title }}</a></li>
        {% endif %}
    {% endfor %}
{% endpageList %}
</ul>

    这个标签会获取所有已创建的单页面，您可以根据 item.Id 或 item.Link 等字段进行筛选和排序，以满足前端展示的需求。

通过以上管理和调用方式，AnQiCMS 为我们提供了一个既强大又灵活的平台，能够高效地处理网站的各种单页面内容，无论是简单的信息展示，还是需要独特设计的专题页面，都能游刃有余。

常见问题 (FAQ)

1. 我能否为每个单页面都设计一个完全不同的布局？ 是的，AnQiCMS 提供了高度的灵活性。您可以在后台编辑单页面时，在“单页面模板”字段中指定一个自定义的模板文件（例如 download.html 或 my-unique-about-page.html）。只要这个模板文件存在于您的主题目录下（例如 template/your_theme/page/my-unique-about-page.html），该单页面就会加载并使用您指定的模板进行渲染。这让您可以为每个重要单页面实现完全定制化的设计。

2. 单页面内容编辑器是否支持图片上传和格式化？ 当然支持。AnQiCMS 后台的单页面内容编辑器是一个功能丰富的富文本编辑器。您可以直接在编辑器内上传图片、插入视频，并对文字进行加粗、斜体、列表、引用等多种格式化操作。此外，如果启用了 Markdown 编辑器，您也可以使用 Markdown 语法来快速编写和格式化内容。编辑器也支持引用图片资源管理中已上传的图片。

3. 如果我的单页面内容没有正确显示，或者样式错乱，我应该检查哪些地方？ 首先，确认您在后台“单页面模板”字段中填写的模板名称是否正确，并且该模板文件确实存在于您的主题目录下。其次，如果内容是 HTML 格式，请确保在模板中使用 {% pageDetail pageContent with name="Content" %}{{ pageContent|safe }} 这样的方式调用，其中 |safe 过滤器是必需的，它告诉 AnQiCMS 不需要对内容进行 HTML 转义。如果样式错乱，很可能是 CSS 文件没有正确加载，检查模板中对 CSS 文件的引用路径是否正确，或者自定义模板中是否有与全局样式冲突的规则。