安企CMS在内容展示方面提供了高度的灵活性和强大的组织能力,这主要体现在其对模板文件类型和目录结构的支持上。理解这些约定和机制,能够帮助您更高效地定制网站外观和内容布局。

模板文件的核心结构与约定

首先,安企CMS将所有用于前端展示的模板文件统一存放于站点的根目录下/template文件夹中。每个独立的网站主题或模板集都应该在这个目录下拥有一个自己的文件夹,例如一个名为default的模板主题,它的所有文件就会放在/template/default/

在这个主题文件夹内部,有一个至关重要的config.json文件。这个配置文件就像是模板的“身份证”,它定义了模板的名称、版本、作者、创建时间等基本信息。更重要的是,它也指明了该模板的template_type,也就是模板的适配类型,这决定了网站如何响应不同设备的访问:

  • 自适应模板(template_type: 0:这种模板设计能够自动调整布局以适应各种屏幕尺寸,无论用户是通过电脑、平板还是手机访问,都能获得良好的浏览体验。
  • 代码适配模板(template_type: 1:在某些情况下,您可能需要为不同设备提供完全不同的代码和样式。代码适配模式允许您为移动端内容创建独立的模板文件。
  • PC+手机独立站点模式(template_type: 2:这是最严格的区分模式,系统会根据访问设备自动跳转到不同的域名(例如www.example.comm.example.com),并加载对应的模板。

无论采用哪种适配模式,模板文件都统一使用.html作为后缀。而模板中涉及的样式(CSS)、JavaScript脚本(JS)以及图片等静态资源,则建议单独存放在/public/static/目录,以实现前后端分离,便于管理和优化加载速度。

在模板内容编写上,安企CMS采用了类似Django模板引擎的语法。变量使用双花括号{{变量名}}来输出,而条件判断(如if)、循环控制(如for)等逻辑操作,则使用单花括号和百分号{% 标签名 %}来定义,并且需要以对应的结束标签(如{% endif %}{% endfor %})进行闭合,确保逻辑结构的完整性。为了保证页面内容的正确显示,所有模板文件都应统一采用UTF8编码。

灵活多样的目录组织模式

安企CMS提供了两种主要的目录组织模式,以适应不同规模和复杂度的项目需求:

1. 文件夹组织模式(Folder Organization Mode)

这种模式倾向于将相似功能的模板文件归类到逻辑清晰的子文件夹中,形成模块化的结构。例如:

  • 公共代码片段:像页头(header)、页脚(footer)这些在所有页面中重复出现的部分,通常会放在bash.html文件中供其他模板引用。一些可复用的侧边栏、面包屑等UI组件则可能存放在partial/目录下。
  • 首页模板:网站的首页通常是index/index.html
  • 内容模型相关模板:对于文章、产品等不同的内容模型,会创建以模型表名命名的文件夹。例如,如果有一个“文章”模型,您可能会看到article/index.html(文章模型首页)、article/list.html(文章列表页)、article/detail.html(文章详情页)。
  • 特定内容项模板:安企CMS允许您为单个文章、产品或分类指定独立的模板。例如,您可以为ID为10的文章创建article/detail-10.html,或者为ID为5的分类创建article/list-5.html
  • 其他功能页面:像单页面(page/detail.html)、评论列表(comment/list.html)、在线留言(guestbook/index.html)、搜索结果(search/index.html)、标签列表(tag/list.html)以及错误页面(errors/404.htmlerrors/500.html)等,也都有各自的推荐存放路径。
  • 移动端模板:如果您的网站采用代码适配或PC+手机独立模式,移动端模板文件将统一存放在mobile/子目录中,其内部结构与PC端模板类似,方便单独管理和维护。

这种模式的优点是结构清晰、易于管理,特别是对于大型网站或有复杂内容模型的项目。

2. 扁平化文件组织模式(Flat File Organization Mode)

对于结构相对简单、内容类型不那么复杂的网站,扁平化模式提供了一种更简洁的选择。在这种模式下,大部分模板文件直接放在模板主题的根目录下,文件命名通过前缀来区分其功能,例如:

  • 公共代码和片段:依然会有bash.htmlpartial/目录。
  • 首页模板:直接是index.html
  • 内容模型相关模板:文章模型首页可能是article_index.html,详情页是article_detail.html,列表页是article_list.html
  • 其他功能页面:如guestbook.html(在线留言)、page.html(单页面详情)、search.html(搜索页)等。
  • 移动端模板:同样,mobile/目录会用于存放移动端对应的扁平化模板文件。

这种模式的优点是查找文件更为直接,减少了层级嵌套,适合快速开发和维护。

细致入微的定制化应用

安企CMS的模板系统不仅仅支持这些约定好的目录结构和文件名,还赋予了用户极大的定制自由度。除了系统默认查找的特定名称模板外,您还可以在后台对单个内容项(例如某篇文章、某个产品)、特定分类,甚至是某个单页面指定自定义的模板文件。

这意味着,即使所有文章都默认使用article/detail.html,您仍然可以为一篇特别的文章指定一个article/special-detail.html模板,或者为“关于我们”这个单页面指定page/about.html模板。这种机制使得内容展示能够完全贴合您的运营需求,实现高度个性化的内容布局。

总而言之,安企CMS通过清晰的模板文件类型定义、灵活的目录组织模式,以及强大的后台定制能力,确保您能够轻松驾驭网站的内容展示,无论是构建简单的企业站,还是管理复杂的多站点内容,都能游刃有余。


常见问题 (FAQ)

  1. 问:如何在后台为单个文章、分类或页面指定一个自定义的模板? 答:您可以在编辑文章、产品、分类或单页面时,在后台的“其他参数”或“高级设置”区域找到“文档模板”、“分类模板”或“单页面模板”等选项。在这里输入您自定义模板的文件名(例如special_article.htmlpage/about.html),系统就会在该内容项被访问时,优先加载您指定的模板。

  2. 问:如果我的网站既想在PC端和移动端使用不同的模板,但又不想维护两个独立域名,应该选择哪种模板适配类型? 答:在这种情况下,您应该选择“代码适配(template_type: 1)”模式。您可以在模板主题文件夹内创建一个mobile/子目录,并在其中放置移动端对应的模板文件。安企CMS会根据访问设备自动识别并加载PC端或移动端的模板,而无需额外配置独立的移动端域名。

  3. 问:我想使用扁平化文件组织模式,但我不知道每个页面对应的文件应该如何命名? 答:在扁平化模式下,核心原则是通过文件名来反映页面的内容和功能。例如,网站首页通常是index.html;文章模型的首页可以是article_index.html,文章列表页为article_list.html,详情页为article_detail.html;单页面则直接命名为page.htmlpage-{ID}.html。对于评论列表、留言板、搜索结果等功能页,也通常采用功能名_list.html功能名.html的形式命名,如comment_list.htmlguestbook.html。您可以参考安企CMS的官方文档获取完整的命名约定列表。