安企CMS模板制作有哪些基本约定和文件目录结构？
作为一名深谙安企CMS(AnQiCMS)运营之道的资深从业者，我深知模板在网站建设中的核心地位。一套结构清晰、遵循约定的模板不仅能高效呈现内容，更是网站SEO和用户体验的基石。下面，我将详细阐述安企CMS模板制作的基本约定与文件目录结构，希望能为您在AnQiCMS上的内容创作与管理提供有力的支持。
安企CMS模板制作的基本约定
安企CMS的模板系统设计旨在简洁高效，让内容创作者和开发者能够快速上手。在进行模板制作时，我们首先需要了解一些基础约定，这些约定是确保模板正常运行、易于维护和扩展的关键。
所有安企CMS的模板文件都统一使用.html作为文件后缀名。这些模板文件，以及它们所依赖的样式表、JavaScript脚本和图片等静态资源，有着明确的存放位置。所有的.html模板文件都必须放置在项目根目录下的/template文件夹中。而所有模板用到的静态资源，如CSS、JS、图片等，则统一集中存放在/public/static/目录下。这样的分离有助于代码组织，也便于静态资源的管理和CDN加速。
在模板的语法层面，安企CMS采用了类似于Django模板引擎的标签标记方式，这对于熟悉MVC或MVT框架的开发者来说会非常亲切。变量的调用使用双花括号{{变量名}}来定义，例如，如果您需要显示文章标题，可以直接使用{{archive.Title}}。对于条件判断、循环控制等逻辑操作，则使用单花括号和百分号来定义，例如{% if 条件 %}...{% endif %}。需要特别注意的是，这些逻辑标签都是成对出现的，必须有对应的结束标签来闭合，以确保语法结构的完整性，避免解析错误。
变量的命名规范也有一套约定，通常采用驼峰命名法（CamelCase），即每个单词的首字母大写，例如{archive.Id}或{archive.Title}。这种命名方式提高了代码的可读性，也方便了变量的识别。此外，模板文件的编码格式统一为UTF-8。如果模板文件采用其他编码，可能会导致页面出现乱码，影响用户体验。因此，无论是Windows还是Linux环境下的用户编辑模板文件，都应确保将其保存为UTF-8编码格式。
安企CMS的模板系统还具备高度的灵活性，支持多种网站展示模式。您可以选择开发一套自适应模板，自动适配不同屏幕尺寸；也可以选择代码适配模板，为不同设备提供不同的HTML结构；或者直接采用PC+手机端独立站点模式，为PC和移动设备分别提供独立的模板。当选择代码适配模式或PC+手机端模式时，还需要为移动端专门创建一套模板，这套移动端模板应存放在名为mobile的子目录中，其内部结构与PC端模板类似，以实现对移动设备的专门优化。为了进一步简化模板配置，安QiCMS还支持一些默认的自定义模板名称，如果这些特定名称的模板文件存在，系统便能自动应用，无需在后台额外设置。例如，文档默认自定义模板可以命名为{模型table}/{文档id}.html，文档列表模板为{模型table}/list-{分类id}.html，单页面模板为page/{单页面id}.html，这些都为模板开发提供了极大的便利。
安企CMS模板的文件目录结构
安企CMS的模板根目录为/template，所有的模板都必须放置在这个目录下。为了方便管理，每一个独立的模板主题都应在/template下拥有自己的专属目录。在这个专属目录中，一个名为config.json的配置文件是必不可少的，它承载着模板的基本信息和配置。
config.json文件是模板的身份证明，其中包含了模板的名称、包名、版本号、描述、作者、主页、创建时间、模板类型（0为自适应、1为代码适配、2为电脑+手机端）以及启用状态（0为未启用、1为使用中）。这些字段大部分是可选的，但合理填写能够帮助我们更好地管理和区分模板。值得注意的是，在一个多模板的环境中，只能有一套模板的status字段设置为1，表示它是当前正在使用的模板。
在模板目录内部，安企CMS提供了两种主要的文件组织模式，以适应不同的开发习惯和项目需求：
首先是文件夹组织模式。这种模式下，模板文件通过多级目录来分类，结构清晰，易于大型项目管理。例如，通用的头部、底部等代码片段通常会抽离到bash.html文件中供全局引用；侧边栏、面包屑等可复用组件则存放于partial/目录。首页文件位于index/index.html。不同内容模型（如文章、产品）的页面则有各自的目录，例如文档详情页可以有{模型table}/detail.html，甚至针对特定文档ID的{模型table}/detail-{文档ID}.html；文档列表页则对应{模型table}/list.html或{模型table}/list-{文档分类ID}.html。此外，评论列表页、在线留言页、单页面详情页、搜索页、标签页以及各种错误页（404、500、站点关闭）都有各自明确的存放路径。如果是PC+手机端模式，移动端模板会复制一套同样的目录结构，存放在mobile/子目录中。
另一种是扁平化文件组织模式。这种模式下，文件不进行深层目录嵌套，而是通过文件名的前缀来区分页面类型。例如，首页是index.html，模型首页是{模型table}_index.html，文档详情页是{模型table}_detail.html，以此类推。这种模式对于小型项目或偏好扁平结构的开发者可能更为便捷。与文件夹模式一样，移动端模板的目录结构和文件命名在mobile/目录下也会保持一致。
无论采用哪种组织模式，安企CMS都提供了高度的灵活性。对于特定的内容页面，例如某个特定的单页面（如“关于我们”），您可以在后台指定一个独立的模板文件，例如page/about.html。这样，该单页面就可以拥有完全个性化的展示样式，而无需修改通用模板。这种自定义功能使得安企CMS在满足多样化业务需求方面表现出色。
遵循这些模板制作的约定和目录结构，不仅能确保您的安企CMS网站稳定运行，更能为未来的内容更新、功能扩展和团队协作打下坚实的基础。清晰的结构能让您专注于高质量内容的创作和发布，真正发挥安企CMS作为企业级内容管理系统的强大价值。
常见问题 (FAQ)
1. 为什么我的AnQiCMS网站页面显示乱码？
页面乱码通常是由于模板文件编码不正确导致的。请确保所有的.html模板文件都以UTF-8编码格式保存。您可以在代码编辑器（如VS Code, Sublime Text等）中检查并重新保存文件的编码。
2. 如何为移动端设置独立的模板？
如果您选择了“代码适配”或“PC+手机端独立站点”的模板类型，您需要在当前模板目录下创建一个名为mobile的子目录。在这个mobile目录中，按照与PC端模板相同的目录结构和文件命名约定，放置您为移动端设计的模板文件。AnQiCMS会根据访问设备的类型自动加载相应的模板。
3. 我想针对某个特定的文章或分类使用不同的模板，AnQiCMS是否支持？
是的，AnQiCMS支持高度自定义的模板应用。对于文章，您可以在文章编辑页面指定“文档模板”；对于分类，可以在分类编辑页面指定“分类模板”。您只需提供对应的模板文件名（例如download.html），并确保该文件存在于您的模板设计包中，系统就会自动应用。单页面也可以通过类似的方式指定独立模板。