1. 通用全局 {ms:global.*/}

站点基本信息标签 功能性标签

1.1. 适用模版

首页模版、列表模版、内容模版、自定义页面模版

[!tip]一般html模版页都可以使用通用全局标签

1.2. 格式

{ms:global.*}

1.3. 站点基本信息标签

标签 描述
{ms:global.name/} 网站标题
{ms:global.logo/} 返回logo的图片地址<img src="{@ms:file global.logo/}"/>
{ms:global.keyword/} 网站关键字 范例:<meta name="keywords" content="{ms:global.keyword/}"/>
{ms:global.descrip/} 网站描述 范例:<meta name="description" content="{ms:global.descrip/}"/>
{ms:global.copyright/} 网站版权信息
{ms:global.html/} 返回项目生成的静态文件所在目录,由html和站点生成目录组成,格式如: /html/web/
{ms:global.style/} 返回当前站点的模板名称,主要用于引入css,js等资源文件读取,范例: <script src="/{ms:global.style/}js/index.js"><img src="/{ms:global.style/}images/pic.jpg"/> 使用时必须以"/"开头
{ms:global.contextpath/} 获取项目名(yml中server.servlet.context-path对应的值),用于css,js等文件引入等,范例: <script src="{ms:global.contextpath/}/{ms:global.style/}js/index.js">
{ms:global.template/} 获取对应模版的名称(企业版本及政务版本标签,针对一个网址多套皮肤)
{ms:global.url/} (不推荐在栏目、文章链接中使用,建议使用{ms:global.html/}替代;如果是企业或政务版本长链情况下,需要使用{ms:global.html/}{ms:global.template/}/替代) 返回域名+静态文件目录,格式:域名/html/站点目录/
{ms:global.host/} (不推荐在引入静态资源时使用) 返回项目对应域名地址

[!tip] 由于部署项目时,使用了{ms:global.url/}或{ms:global.host/}标签导致部署在其他服务器上时页面带有固定域名,导致访问失败; [!tip]使用相对路径获取图片时,不需要在标签前加 / ,否则会导致这种相对路径方式为//upload/**.jpg,从而获取不到图片。 同样,项目中文章链接采用相对路径去掉{ms:global.url/}时,需要使用{ms:global.html/}替换。

1.4. 功能性标签

标签 描述
<#include "url"> 用于引入公用的HTML等文件,例如公用的头部导航,<#include "head.htm"> ,注意这里的url参数是带双引号。注意:不支持相对路径,如果不需要include标签,必须删除,不能<!--#include "url"-->
{@ms:file 图片或文件/} 通过后台上传控件发布的图片或者文件都需要通过ms:file获取文件路径
{@ms:len 文本 截取长度/} 根据长度截取文本内容,如果文本内容长度超出截取长度会采用省略号替代,例如:{@ms:len field.title 10/} 对应MCms内容管理...
{@ms:tags/} 获取文章绑定的文章标签。首页获取全部文章标签,列表页获取当前栏目下所有文章标签
{@ms:memorialday/} 国家公祭日标签,会自动将页面变成灰色(政务版本有效),通常应用在首页模版头部或者尾部(在公共页面(head-file)中使用,则所有引用的页面也会生效),需先在公祭日配置开启,日期格式按"MM-dd"以逗号分隔,如05-12,09-18,12-13,12-01
{@ms:accessibility "绑定dom"/} 无障碍阅读,推荐放在模版的最底部,会在 绑定dom 元素上增加开启关闭的事件(政务版本有效),使用格式如下:<button id="wuzhangai"/>
{@ms:accessibility "wuzhangai"/}

[!tip]注意include标签事项(双引号、不支持相对路径,不能适应../方式、不需要必须删除include标签)

ms:file 也可以使用 ${图片或文件?eval\[0\].path}获取,获取多个路径需要循环获取,代码如下:

<#list 图片或文件?eval as file> ${file.path} </#list>

使用{@ms:len 文本 截取长度/} 所截取文本,中英文都只占一个字符,且文字截取从零开始计算,即文字长度是截取长度数字+1

1.5. 范例

<title>{ms:global.name/}</title>
<meta name="description" content="{ms:global.descrip/}">
<meta name="keywords" content="{ms:global.keyword/}">
<link rel="shortcut icon" href="/{ms:global.style/}/fav.ico" type="x-icon">
<link rel="stylesheet" href="/{ms:global.style/}/css/base.css">
<script src="/{ms:global.style/}/js/jquery.js"></script>
<#include "nav.htm">
<h2><a href="/">站点首页</a></h2>
<img src="{@ms:file global.logo/}"/>
<!-- @ms:tags使用范例 点击标签后搜索展示带有该标签的所有文章列表 需要有search.htm模板(参考开源模板) -->
...
{@ms:tags/}
<#list tags?split(",") as content_tag>
  <a href="/mcms/search?content_tag=${content_tag}">${content_tag} </a> 
</#list>
...

[!tip]不能用在.css或.js文件里面,注意{ms:*/}标签没有$符号,且必须/结束

Copyright © mingsoft.net 2021 all right reserved,powered by Gitbook该文件修订时间: 2024-07-22 09:51:32

results matching ""

    No results matching ""

    results matching ""

      No results matching ""