模板制作的一些基本约定

AnqiCMS 的模板,使用 .html 作为模板文件后缀,并存放在 /template 模板文件夹中,模板用到的样式、js脚本、图片等静态资源,则单独存放在 /public/static/ 目录。

模板文件的使用类似 Django 模板引擎的标签标记,变量则使用双花括号来定义,如 {{变量}}。条件判断、循环控制等标签,使用单花括号和百分号来定义,并且需要用结束标签来结束,标签成对出现,如 {% if archive.Id == 10 %}这是文档ID为10的文档{% endif %}

变量名采用驼峰命名法则,每个单词首字母大写,部分特殊规定的除外,如 {archive.Id}{archive.Title}

模板文件统一编码为UTF8编码,如果是其他编码,则会导致页面乱码,无法正常显示,如果是windows用户编辑模板文件的时候,请存储成UTF-8格式编码的模板文件。

模板支持的类型有:自适应模板类型、代码适配模板类型、PC+手机端模板类型。

模板支持单独的移动端模板定义,移动端模板存放在 mobile 目录,选择 代码适配模式、PC+手机端模式 的模板的时候,需要创建 mobile 模板。

模板支持一些默认的自定义名称,只要存在这些自定义的模板文件,则不需要单独在后台设置模板,就能自动应用该模板。

已支持的模板名称情况:

  • 文档默认自定义模板 名称格式是 {模型table}/{文档id}.html
  • 文档列表默认自定义模板 名称格式是 {模型table}/list-{分类id}.html
  • 单页面默认自定义模板 名称格式是 page/{单页面id}.html