网站运营中，我们常常会遇到这样的情况：不同类型的内容，即使是同一个分类下的文章，或者同一个网站上的不同“关于我们”页面，都希望能有独特的展现风格，以更好地吸引读者，传达信息。安企CMS（AnQiCMS）深知这一需求，因此提供了非常灵活的模板定制机制，让我们能够轻松为特定分类或页面量身定制显示样式。

安企CMS的模板系统基于Go语言的Django模板引擎语法，这意味着只要您对前端开发有基础了解，就能很快上手。它允许我们通过创建或修改模板文件，并将其与后台的特定内容关联起来，从而实现精细化的样式控制。

一、理解模板文件的存放与命名约定

在开始定制之前，我们首先需要知道模板文件存放的位置和一些基本的命名约定。安企CMS的模板文件统一存放在 /template 目录下。每一套模板都会有自己的独立文件夹，例如 default。在这个文件夹里，您可以放置所有与这套模板相关的 .html 文件，而样式（CSS）、JavaScript脚本和图片等静态资源则会存放在 /public/static/ 目录。

安企CMS的模板系统非常智能，它支持多种方式来识别和应用模板：

  1. 通用默认模板： 对于文章、产品列表和详情页、单页面等，都有一个通用的默认模板。例如，{模型table}/detail.html 用于所有文章或产品的详情页，{模型table}/list.html 用于所有文章或产品的列表页，而 page/detail.html 则是所有单页面的默认模板。当没有指定特殊模板时，系统就会自动调用这些通用模板。

  2. ID或别名绑定的约定模板： 如果您希望某个特定的文档、分类或单页面拥有独特的样式，可以利用其ID或URL别名来命名模板文件。

    • 对于文档详情页，您可以创建 {模型table}/{文档ID}.html 格式的模板文件，例如 article/123.html，系统在访问ID为123的文章时会自动应用这个模板。
    • 对于分类列表页，可以创建 {模型table}/list-{分类ID}.html 格式的模板，例如 article/list-5.html，当访问ID为5的文章分类列表时，这个模板就会生效。
    • 对于单页面，可以创建 page/{单页面ID}.html 格式的模板，例如 page/7.html。 这些约定命名方式，让您无需在后台进行额外设置，系统就能自动识别并应用。

  3. 自定义命名的灵活模板： 除了上述约定，安企CMS还提供了最灵活的方式——您可以为模板文件随意命名，然后在后台的对应内容编辑界面指定使用这个模板。例如，您可以创建一个名为 download-page.html 的模板，专门用于一个特殊的下载页面。

无论采用哪种方式，请务必确保您的模板文件都使用UTF-8编码，以避免页面乱码。此外，如果您的网站需要适配移动端，可以在模板文件夹内创建一个 mobile 子目录，并在其中复制相同的模板结构，系统便会在手机端自动调用 mobile 目录下的模板。

二、在后台关联自定义模板

创建好模板文件后，接下来的关键一步就是告诉安企CMS，哪个内容应该使用哪个模板。这个过程非常直观，通常在内容编辑界面就能找到相应的选项。

  1. 为文章或产品定制模板： 当您在后台的“内容管理”中发布或编辑一篇文档（文章或产品）时，在编辑界面的“其他参数”部分，会找到一个名为“文档模板”的字段。在这里，您可以填写您希望该文档使用的模板文件名。例如，如果您创建了一个名为 special_news.html 的模板，专门用于展示某篇重要新闻，只需在此处填入 special_news.html 即可。

  2. 为分类定制模板： 在“内容管理”的“文档分类”页面，编辑某个分类时，在“其他参数”中同样有一个“分类模板”字段。在这里填写模板文件名（例如 product_list_promo.html），就能让该分类的所有列表页呈现独特的样式。特别值得一提的是，这里还有一个“是否应用到子分类”的选项，如果您勾选了它，该分类下的所有子分类（及其文档列表）都将继承使用这个自定义模板，这对于实现某一产品线或服务系列的统一风格非常方便。

  3. 为单页面定制模板： 在“页面资源”的“页面管理”中编辑任何一个单页面（例如“关于我们”或“联系我们”），在“单页面模板”字段中，您可以填入为其量身定制的模板文件名。比如，为“关于我们”页面设计了一个独特的 about_us_fancy.html 模板，在此处填写即可。

当您在后台指定了自定义模板后，安企CMS在渲染相应页面时，就会优先查找并使用您指定的文件。如果文件不存在，那么页面将无法正常打开，所以请务必确认模板文件的路径和名称是正确的。

三、模板内部的编写小贴士

在您自定义的模板文件中，可以使用类似Django的标签语法来控制内容的显示。例如，{{变量名}} 用于输出数据，而 {% 标签 %} 则用于实现逻辑控制，比如 {% if 条件 %} 进行判断，{% for item in 列表 %} 进行循环。

为了提高模板的可维护性和复用性，强烈建议利用 {% include "片段.html" %} 和 {% extends "基础模板.html" %} 这两个标签。include 可以将页头、页脚、侧边栏等常用代码片段引入到您的模板中，避免重复编写；extends 则允许您创建一个基础的页面骨架（包含公共的HTML结构、样式引用等），然后让其他页面继承这个骨架，只重写需要定制的区块。这样一来，修改公共部分只需改动一处，大大提升了效率。

通过上述方式，安企CMS的模板定制功能，就像为网站的每一个角落量身定制一套专属服装，让内容在合适的场景以**姿态呈现。无论是为了提升用户体验、强化品牌形象，还是优化特定内容的SEO展现，这种灵活的控制能力都能为您的网站运营带来实实在在的便利和价值。

常见问题（FAQ）

  1. Q: 我自定义的模板文件应该放在网站目录下的哪个位置？ A: 您应该将自定义模板文件放置在 /template/您的模板目录/ 下。例如，如果您的模板目录是 default，那么可以放在 /template/default/。如果您是为特定的文档、分类或单页面定制模板，也可以按照约定（如 article/123.html 或