AnQiCMS 模板如何组织公共代码（如页头、页脚）？
作为一名资深的安企CMS网站运营人员，我深知高效的内容管理离不开一套组织良好、易于维护的模板系统。在安企CMS中，为了更好地管理网站的公共代码，如页头（Header）和页脚（Footer），系统提供了清晰的模板组织结构和强大的模板引擎特性。这不仅提升了开发效率，也确保了网站内容展示的一致性和可维护性。
安企CMS模板结构概览
安企CMS的模板系统采用类似Django模板引擎的语法，以.html作为模板文件的后缀名，并统一存放在根目录下的/template模板文件夹中。与模板相关的样式、JavaScript脚本和图片等静态资源，则独立地放置在/public/static/目录，实现了内容与表现层代码的有效分离。这种分层设计是确保网站长期稳定运营的基础。
组织公共代码的核心：bash.html 与 partial/ 目录
在安企CMS的模板设计中，公共代码的组织遵循一种直观且高效的模式。所有模板共用的基础结构，例如网站的整体骨架、每个页面都需要继承的页头和页脚，通常会被集中放置在 bash.html 这个文件中。这个文件可以被视为网站模板的“母版”或“布局文件”，它定义了页面的整体框架，减少了重复代码的编写。
除了 bash.html 这样的整体布局文件，安企CMS还鼓励使用 partial/ 目录来存放代码片段。这些代码片段通常是网站中独立、可复用的UI组件或内容模块，比如侧边栏、面包屑导航、版权信息块、广告位或者特定的表单组件。将这些小块代码抽离成单独的文件，不仅使得模板结构更加清晰，也便于在不同页面或模板中灵活引用和管理。无论是采用文件夹组织模式还是扁平化文件组织模式，bash.html 和 partial/ 目录都是组织公共代码的基石。
模板继承机制：extends 标签的应用
安企CMS的模板引擎支持强大的模板继承功能，这主要通过extends标签实现。extends标签允许开发者定义一个基础模板（通常就是上面提到的bash.html），其中包含网站的通用结构和占位符。其他页面模板可以通过extends标签继承这个基础模板，然后使用block标签重写或填充基础模板中定义的特定区域。
例如，bash.html可以定义一个{% block title %}{% endblock %}来放置页面标题，以及一个{% block content %}{% endblock %}来放置页面主体内容。当具体页面模板继承bash.html时，只需在自己的模板文件中重新定义这些block，就可以实现内容的定制化，而无需重新编写整个页面的HTML结构。这种机制极大地提高了模板的复用性，并保证了网站整体风格的一致性。
代码片段复用：include 标签的灵活运用
除了模板继承，include标签是安企CMS中另一种重要的代码复用方式。include标签用于在当前模板中嵌入另一个独立的模板文件，通常是那些不包含整体布局，而是提供特定功能或展示内容的代码片段，比如partial/header.html或partial/footer.html。
通过include标签，可以将页头、页脚、导航菜单、侧边栏等模块化内容以独立文件的形式引入到任何需要的模板中。include标签还支持with参数，允许开发者向被引入的模板传递特定的变量，例如{% include "partial/header.html" with title="当前页面标题" %}。如果只需要传入的变量而不希望继承当前模板的所有变量，可以使用only参数进行限制。这种灵活性使得include成为构建模块化、可组合模板的利器，有效提升了开发效率和代码的可读性。
宏函数：macro 实现高级复用
对于更复杂的、需要参数化和逻辑处理的代码片段，安企CMS的模板引擎还提供了macro（宏函数）标签。宏函数类似于编程语言中的函数，它可以在模板中定义一段可重复使用的代码逻辑，并接受参数。这使得开发者能够创建高度抽象和复用的UI组件，例如一个带自定义参数的文章列表项渲染函数。宏函数可以被定义在当前模板中，也可以像include一样，被保存到单独的文件中，并通过import标签引入和使用。这种高级复用方式，为资深运营人员提供了更大的定制空间和代码组织能力。
总结
安企CMS通过bash.html作为网站的骨架文件，partial/目录存储可复用的代码片段，并结合extends、include和macro等强大的模板引擎标签，构建了一套高效、灵活且易于维护的公共代码组织体系。这使得网站的页头、页脚以及其他公共模块的管理变得简单而有序，极大地提升了内容发布和网站优化的效率，也为后续的二次开发和功能扩展奠定了坚实的基础。
常见问题解答 (FAQ)
问：在安企CMS中，bash.html和partial/header.html有什么区别？
答：bash.html通常被视为网站的整体布局文件或“母版”，它定义了整个页面的基本HTML结构，例如<html>、<head>、<body>标签以及页面的大致分区，并包含可被子模板重写的block区域。而partial/header.html则是一个更具体的代码片段，它只包含页面顶部（Header）的HTML内容，例如网站Logo、主导航菜单等，这个片段通常会通过include标签被引入到bash.html或其他基础布局文件中。简单来说，bash.html是框架，partial/header.html是框架中的一个可插拔组件。
问：我应该选择使用extends进行模板继承，还是include来复用公共代码片段？
答：这取决于你要复用的代码的性质。如果你需要一个页面拥有一个统一的整体结构，并且其中某些区域需要根据不同的页面内容进行定制或替换，那么extends（模板继承）是更合适的选择。它提供了一种“是-一个”（is-a）的关系，子模板继承了父模板的骨架。相反，如果你只是想在多个地方插入一个独立的、自包含的代码块，例如一个侧边栏广告、一个版权声明或者一个社交分享按钮，那么include是更好的选择。它提供了一种“有-一个”（has-a）的关系，将一个组件嵌入到当前模板中。在实际操作中，两者常常结合使用，例如基础布局文件通过extends定义，而其中的具体模块则通过include引入partial/目录下的代码片段。
问：如何在 include 引入的公共代码片段中使用当前页面的变量？
答：当使用{% include "partial/your_snippet.html" %}时，被引入的your_snippet.html默认会继承当前模板上下文中的所有变量。这意味着你无需额外操作，就可以直接在your_snippet.html中使用当前页面的变量。如果你希望更精确地控制变量的传递，可以配合with参数来显式传递特定变量，例如{% include "partial/your_snippet.html" with page_title=current_page.title %}。如果只想传递with中指定的变量而不继承其他任何上下文变量，可以在with参数后添加only关键字。