AnQiCMS的模板制作有哪些基本约定和推荐的目录结构？
作为一名资深安企CMS网站运营人员，我深知一套高效且规范的模板体系对于网站的长期发展和内容管理效率至关重要。安企CMS凭借其简洁高效的架构和Django风格的模板引擎，为内容创作者和运营者提供了极大的便利。在模板制作过程中，遵循一定的基本约定和推荐的目录结构，能够有效提升开发效率、降低维护成本，并确保网站内容的灵活展示。
安企CMS模板制作的基本约定
安企CMS的模板制作遵循一系列基本约定，旨在确保模板文件的一致性、可维护性和系统兼容性。
首先，所有模板文件统一使用.html作为文件后缀，并集中存放在网站根目录下的/template模板文件夹中。这样做便于系统识别和加载，同时也让模板文件的管理更加条理化。与模板相关的样式表（CSS）、JavaScript脚本以及图片等静态资源，则应独立存放在/public/static/目录，以实现动静分离，优化加载性能。
在模板语法层面，安企CMS采用了类似Django模板引擎的标签标记方式。变量的输出使用双花括号{{变量}}来定义，例如{{archive.Title}}用于输出文档标题。而条件判断、循环控制等逻辑标签，则使用单花括号和百分号{% 标签 %}来定义。需要注意的是，所有逻辑标签都必须成对出现，并使用相应的结束标签来结束，例如{% if archive.Id == 10 %}这是文档ID为10的文档{% endif %}，确保逻辑块的完整性。
变量的命名规范也十分重要。安企CMS推荐采用驼峰命名法则，即每个单词的首字母大写，例如archive.Id和archive.Title，但系统特殊规定的一些变量除外。遵循这一命名习惯有助于提高代码的可读性，减少潜在的错误。
为了避免页面乱码问题，所有模板文件都必须统一采用UTF-8编码格式。对于在Windows环境下编辑模板的用户，务必在保存时选择UTF-8编码。
安企CMS的模板系统支持多种网站模式，包括自适应模板类型、代码适配模板类型以及PC+手机端独立站点模式。其中，如果选择代码适配或PC+手机端模式，则需要专门为移动设备创建单独的模板，这些移动端模板应存放在主模板目录下的mobile子目录中，其内部结构与PC端模板保持一致。
系统还支持一些默认的自定义模板名称。只要按照特定格式创建这些模板文件，即使不在后台单独设置，系统也能自动应用它们。例如，文档的默认自定义模板名称格式可以是{模型table}/{文档id}.html，文档列表的默认格式可以是{模型table}/list-{分类id}.html，而单页面的默认格式可以是page/{单页面id}.html。这种机制为特定的内容提供了更细致的模板控制能力。
安企CMS模板制作推荐的目录结构
规范的目录结构是模板开发和维护的基础。安企CMS模板的根目录为/template，每套模板都需要在该目录下创建自己的独立目录。
在每个模板目录中，都必须包含一个config.json配置文件，用于描述模板的基本信息。这个文件扮演着模板“身份证”的角色，系统通过它来识别和管理模板。config.json文件的内容通常包含以下字段：name（模板名称）、package（模板文件夹名称，仅支持英文字母和数字）、version（模板版本）、description（模板介绍）、author（模板作者）、homepage（作者网站）、created（创建时间）、template_type（模板类型，0为自适应，1为代码适配，2为电脑+手机）和status（模板使用状态，0为未启用，1为使用中）。值得注意的是，所有模板中只能有一套模板的status值为1。
安企CMS的模板目录和文件组织方式主要有两种：文件夹组织模式和扁平化文件组织模式。
在文件夹组织模式下，模板文件会根据功能或页面类型分组到不同的子目录中，形成一个层次分明的结构。例如：
- 公共代码文件：
bash.html，用于存放页头、页脚等每个页面都可能继承的部分。 - 代码片段目录：
partial/，用于存放侧边栏、面包屑等可复用的代码片段。 - 首页：
index/index.html。 - 模型首页：
{模型table}/index.html，如article/index.html。 - 文档详情页：
{模型table}/detail.html，也可以为特定文档定制{模型table}/detail-{文档ID}.html。 - 文档列表页：
{模型table}/list.html，或者针对特定分类的{模型table}/list-{文档分类ID}.html。 - 评论列表页：
comment/list.html。 - 在线留言页：
guestbook/index.html。 - 单页面详情页：
page/detail.html，或特定单页的page/detail-{单页ID}.html。 - 搜索页：
search/index.html。 - 标签首页：
tag/index.html。 - 标签文档列表页：
tag/list.html。 - 错误页面：
errors/404.html、errors/500.html、errors/close.html。 - 手机端模板目录：
mobile/，其内部结构与PC端模板保持一致。
而扁平化文件组织模式则将大部分模板文件直接放置在模板根目录下，通过文件命名来区分不同页面类型。例如：
- 公共代码文件和代码片段目录与文件夹模式相同。
- 首页：
index.html。 - 模型首页：
{模型table}_index.html。 - 文档详情页：
{模型table}_detail.html。 - 文档列表页：
{模型table}_list.html。 - 评论列表页：
comment_list.html。 - 在线留言页：
guestbook.html。 - 单页面详情页：
page.html，或特定单页的page-{单页ID}.html。 - 搜索页：
search.html。 - 标签首页：
tag_index.html。 - 标签文档列表页：
tag_list.html。 - 错误页面：
errors_404.html、errors_500.html、errors_close.html。 - 手机端模板目录：
mobile/，内部结构同样保持一致。
此外，安企CMS还提供了灵活的自定义模板功能。对于文档详情、分类页和单页面等，除了上述默认命名，还支持增加其他自定义文件名。例如，如果“关于我们”单页面需要独特的展示模板，可以将其命名为page/about.html，并在后台创建页面时指定调用这个自定义模板。这种灵活性使得运营人员能够针对特定内容实现高度个性化的设计。
遵循这些约定和推荐的目录结构，不仅可以提高模板代码的组织性和可维护性，还能让团队协作更加顺畅，为网站的长期运营打下坚实基础。
常见问题解答 (FAQ)
1. 安企CMS的模板引擎有何特点，制作模板需要哪些基础知识？
安企CMS采用Go语言开发，其模板引擎语法类似Django模板，易于上手。制作模板通常需要掌握HTML、CSS和JavaScript等前端基础技术，同时熟悉Django风格的模板语法，包括变量输出（{{变量}}）、条件判断（{% if %}）、循环遍历（{% for %}）等。系统还内置了丰富的标签和过滤器，用于调用系统数据、进行逻辑判断和数据格式化，熟练运用这些是高效模板制作的关键。
2. 如何为安企CMS网站实现多语言内容展示和切换功能？
安企CMS内置了多语言支持，这在模板层面也得到了体现。首先，在后台的全局设置中配置网站的默认语言包。其次，在模板目录下创建locales目录，并在其中按语言代码（如en-us、zh-cn）创建子目录及default.yml等语言文件来定义翻译内容。在模板中，可以使用{% tr "键名" %}标签来调用对应的翻译文本。此外，系统提供了{% languages websites %}标签，可以获取所有多语言站点的列表，方便在前端实现语言切换功能和生成hreflang标签，有助于搜索引擎优化和全球化内容推广。
3. 在安企CMS中，静态资源（如图片、CSS、JS）应该如何管理和引用，以保证模板的正确加载？
在安企CMS中，静态资源应统一存放在/public/static/目录下。模板文件通过系统标签来引用这些静态资源，以确保路径的正确性和网站的稳定性。例如，可以使用{% system with name="TemplateUrl" %}标签获取当前模板的静态文件地址，然后结合相对路径来引用CSS或JS文件，如<link href="{% system with name="TemplateUrl" %}/css/style.css" rel="stylesheet">。这样做的好处是，即使网站部署环境或域名发生变化，静态资源的引用路径也能自动适应，无需手动修改模板代码。同时，图片资源也可以通过后台的图片资源管理功能进行上传和分类管理，并在模板中通过相应的文档详情或分类详情标签来引用。