安企CMS模板文件命名和存放路径有什么约定？

当您开始使用安企CMS搭建网站时，了解其模板文件的命名规则和存放路径约定，是高效进行网站设计与内容呈现的关键。清晰的文件结构不仅能帮助您快速定位和修改模板，还能让团队协作更加顺畅，确保网站稳定运行。

模板文件的“家”：统一的存放位置

安企CMS的所有模板文件都集中存放在项目根目录下的/template文件夹中。这就像一个大型图书馆，所有书籍（模板主题）都归总在这里。每个独立的模板主题，都会在/template下拥有一个自己的专属目录，例如/template/default。这个目录内部，还会包含一个config.json文件，它就像是模板主题的“身份卡”，记录着模板的名称、版本、作者以及它的类型（例如是自适应模板、代码适配还是PC+手机独立站点模式）。

至于模板中需要用到的样式文件（CSS）、脚本文件（JavaScript）以及图片等静态资源，它们则统一安放在项目的/public/static/目录里。这种分离有助于保持模板文件的整洁，让内容逻辑与表现层代码各司其职。所有模板文件的后缀都约定使用.html，并且为了避免乱码，强烈建议统一采用UTF8编码进行保存。

灵活多样的命名与组织模式

安企CMS为方便用户管理和开发，提供了两种主要的模板文件组织模式：文件夹组织模式和扁平化文件组织模式，您可以根据项目规模和个人偏好选择最适合的方式。

在文件夹组织模式下，模板文件会根据功能和类型，分布在不同的子目录中。例如，一些在各个页面都会被引用的公共代码，像是网站的页头或页脚，通常会放在bash.html这样的文件中。而像侧边栏、面包屑导航这类可重复使用的代码片段，则会整齐地归入partial/目录。网站的首页通常是index/index.html。

针对不同的内容类型，安企CMS也设定了清晰的路径：

• 文章或产品等模型的主页，通常是{模型table}/index.html（例如，article/index.html）。
• 它们的详情页，则约定为{模型table}/detail.html（例如，product/detail.html）。
• 列表页则使用{模型table}/list.html。
• 单页面（如“关于我们”）的详情页，则位于page/detail.html。
• 此外，还有诸如comment/list.html用于评论列表，guestbook/index.html用于在线留言，以及errors/404.html、errors/500.html等错误页面。

而扁平化文件组织模式则更侧重简洁，它将大多数模板文件直接放置在主题根目录下，通过文件名的约定来区分。为了避免命名冲突并清晰地表达功能，通常会在文件名前加上前缀或使用下划线连接。例如，首页可以是index.html，文章模型的详情页会是article_detail.html，单页面详情页则可能是page_detail.html。

移动端模板与高度灵活的自定义命名

考虑到移动设备访问的需求，安企CMS还特别支持移动端模板。如果您的网站选择了“代码适配”或“PC+手机独立站点”的模板模式，那么移动端模板会存放在您当前模板主题目录下的mobile/子目录中，其内部的目录结构和文件命名规则与PC端模板保持一致，实现一套模板、两种布局的灵活切换。

除了这些约定俗成的命名，安企CMS还赋予了用户极大的灵活性，可以在后台为特定的分类、文章或单页面指定自定义模板文件。这意味着您可以为“关于我们”这样的特定单页面创建page/about.html，并在后台将其指定为该页面的专用模板。同样，如果您希望某个特定分类下的所有文档都使用download.html模板，或者某个具体的文档（例如ID为10的文章）拥有独一无二的article/10.html模板，这些都可以通过后台设置轻松实现，而系统会优先应用这些更具体的自定义模板。

为什么这些约定如此重要？

清晰的命名规则和存放路径约定，为网站的长期维护和迭代打下了坚实基础。它让无论是新加入的开发者还是长期的运营者，都能迅速理解模板结构，快速定位并修改文件。这种系统化的管理方式，确保了网站的整洁性、可扩展性，并大大降低了运营中的错误率，帮助您更高效地管理内容，展现专业的网站形象。

通过熟悉安企CMS的模板命名与存放约定，您将能够更高效地进行网站设计与内容呈现，充分发挥其灵活性和可定制性，打造出专业且符合自身业务需求的高质量网站。

常见问题 (FAQ)

Q1：如果我想自定义一个全新的模板主题，应该怎么开始？

A1： 要开始一个新的模板主题，您首先需要在/template目录下创建一个新的文件夹，作为您的主题目录，比如my_new_theme。然后，在这个新文件夹中创建一个config.json文件，填写模板的基本信息，例如名称、版本和类型。接着，就可以根据安企CMS的命名和组织约定，开始在my_new_theme文件夹内创建您的index.html、partial/header.html、article/detail.html等模板文件了。别忘了将CSS、JS等静态资源放入/public/static/目录中，并在模板中通过{% system with name="TemplateUrl" %}标签来正确引用它们。

Q2：我修改了模板文件，但前台页面没有立即生效，这是为什么？

A2： 这通常是由于缓存造成的。安企CMS为了提升网站访问速度，会启用模板缓存。当您修改了模板文件后，旧的缓存可能仍然在生效。解决这个问题，您可以登录安企CMS的后台，在“更新缓存”功能区点击清理系统缓存，这会刷新服务器