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 %>