AnqiCMS 模板的根目录为 /template
,每一套模板,都需要在 /template
下创建自己的模板目录,并在模板目录中添加 config.json
配置文件,来说明模板的一些信息。
config.json
文件的内容格式为:
{
"name": "默认模板",
"package": "default",
"version": "1.0",
"description": "系统默认模板",
"author": "kandaoni.com",
"homepage": "https://www.kandaoni.com",
"created": "2022-05-10 22:29:00",
"template_type": 0,
"status": 0,
}
config.json
的字段都是选填的,如果都不填,系统将会根据实际情况生成,其中的字段说明:
name
模板名称,按照实际情况来取名package
模板文件夹,仅支持英文字母和数字,请填写你的模板文件夹名称。version
模板的版本,自定义description
模板的介绍author
模板作者homepage
模板作者的网站created
模板创建时间,格式为:2022-05-10 22:29:00
template_type
模板类型,可选值为:0 自适应;1 代码适配;2 电脑+手机status
模板使用状态,可选值为:0 未启用,1 使用中。所有的模板中,只能有一套模板的status
值 为 1
模板目录和文件支持2种模式
文件夹组织模式
- 公共代码
bash.html
比如页头、页脚等每个页面都继承的部分,则放在这里,供引用。 - 代码片段目录
partial/
比如侧边栏、面包屑等代码片段,则存放在这里 - 首页
index/index.html
- 模型首页
{模型table}/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
- 404错误页
errors/404.html
- 500错误页
errors/500.html
- 站点关闭提示页
errors/close.html
- 手机端模板目录
mobile/
手机端模板目录里的目录结构和模板文件跟上面一致,重复一遍即可。
扁平化文件组织模式
- 公共代码
bash.html
比如页头、页脚等每个页面都继承的部分,则放在这里,供引用。 - 代码片段目录
partial/
比如侧边栏、面包屑等代码片段,则存放在这里 - 首页
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
- 404错误页
errors_404.html
- 500错误页
errors_500.html
- 站点关闭提示页
errors_close.html
- 手机端模板目录
mobile/
手机端模板目录里的目录结构和模板文件跟上面一致,重复一遍即可。
同时,部分模板还支持自定义名称,如文档详情、分类页、单页面,可以增加其他文件名,来处理不同的分类、页面需要不同的模板的情况。如需要对 关于我们
这个单页,采用独立的模板,则可以命名模板为 page/about.html
,并在后台创建一个 调用自定义模板为 page/about.html
的关于我们页面即可。