模板说明

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 的绝对地址在模板中调用。