RichCMS使用标准的Go语言html模板语法,在此基础上,RichCMS也有自定义的模板函数,本文结合每一个前台页面,讲解模板使用教程。
一、前言
用户端页面的模板文件,包括在以下目录中。
views/front/比如,views/front/site ,表示使用site这个名称的模板,views/front/blog,表示使用blog这个名称的模板,站长可以在 views/front/ 下自动扩展自己的模板。本文以 模板名称为 cms 的目录为例,展开说明。
二、新建一个模板
在 views/front/下,新建一个cms的目录,同时,新建以下文件:
| 文件名 | 作用 |
|---|---|
| index.html | 首页 |
| channel.html | 频道页 |
| category.html | 栏目页 |
| article.html | 文章详情页 |
| tag.html | 标签首页 |
| tag_detail.html | 标签的文章列表页 |
| archive.html | 月份归档首页 |
| archive_month.html | 月分归档的详情页 |
| 404.html | 页面不存在时的错误显示页面 |
| _header.html | 头部子模板,可以被其他模板包含 |
| _nav.html | 导航子模板,可以被其他模板包含 |
| _footer.html | 底部子模板,可以被其他模板包含 |
以上模板文件,与管理后台->路由配置 相对应,如果不需要某一级页面,可在后台关闭,用户端就不需要对应的模板文件。
三、站点配置基本信息
以下模板调用,使用使用 <% %>符号,可以在页面输出信息。
站点名称:
<% .config.Name %>Logo地址:
<% .config.Logo %> 使用例子:
<img src="<% .config.Logo %>" alt="<% .config.Name %>">网站域名:
<% .config.Domain %>首页标题:
<% .config.Title %>首页keywords:
<% .config.Keywords %> 首页description:
<% .config.Description %> 网站 Icon:
<% if .config.Icon %><link rel="shortcut icon" href="<% .config.Icon%>" /><% end %>MetaCode:
其中:str2html 是一个模板函数,可以显示成html格式输出。
<% if .config.MetaCode %><% str2html .config.MetaCode %><% end%>统计代码:
其中:str2html 是一个模板函数,可以显示成html格式输出。
<% if .config.StatisticalCode %>
<% str2html .config.StatisticalCode%>
<%end %>工信部备案号:
<%if .config.MITTNumber%>
工信部备案号:<a href="https://beian.miit.gov.cn/" target="_blank"><% .config.MITTNumber%></a>
<%end%>公安平台备案号:
<%if .config.MPSNumber%>
公安部备案号:<% .config.MPSNumber%></a>
<%end%>静态资源地址:
<%.staticPath %>例子:
<link rel="stylesheet" href="<%.staticPath %>/static/front/site/css/base.css?v=<% .ver%>" />静态资源版本号:
<% .ver %>年份:
<% .year %>