模板开发
快速开始
DuxCMS Next 版本使用 latte 模板引擎作为模板标签扩展。
模板说明
DuxCMS 的页面模板放置在根目录的 theme
目录中,其中每个目录为一套模板。
每套模板中包含一个配置文件 config.json
用于定义模板中的配置信息,在模板中可以调用配置后的数据。
模板的名称为 latte
格式的后缀,支持全部的 Html 语法,同时支持 latte 模板引擎的语法。
模板渲染
模板中可以通过标签来调用各种数据,最终用户通过路由网址进行访问,访问到的内容即为模板渲染后的内容。
首页模板
首页模板为 index.latte
这个文件为固定的首页名称,无法进行自定义。
页面模板
除首页外的非详情模板都叫做页面模板,可用来展示列表、自定义页面等信息,路由规则为 page/模板名称
。
例如:
新建一个文件为 about.latte
的模板,则可通过 http://域名/page/about
来访问该模板渲染后的页面。
详情模板
该模板可接收到路由传递的id参数,可以用来展示详情信息,路由规则为 page/模板名称/{id}
,其中 id 可随意传递。
例如:
新建一个文件为 article-info.latte
的模板,则可通过 http://域名/page/article/1
来访问该模板渲染后的页面,并且可以通过 $id
来获取传递的 id 值。
静态文件
模板中可以引入图片、css、js等任意文件,必须将引入的文件放置在模板目录中的任意位置。
如果静态文件为 theme/default/images/logo.png
则可通过 /theme/images/logo.png
的绝对地址在模板中调用。