页面树结构
转至元数据结尾
转至元数据起始

正在查看旧版本。 查看 当前版本.

与当前比较 查看页面历史

« 前一个 版本 7 下一个 »

1.需求背景

客户在做大屏展示,对字体是有自己的规范和要求,而这些字体往往在应用服务器上是缺失的。

2.功能说明

允许通过扩展包的方式把字体上传到应用服务器上,方便更新和维护。

例如:集群环境的同步和更新,生产环境的迁移等。

1)字体文件需要使用者自己提供。

2)字体的使用版权需要使用者自行解决。


3.使用说明

3.1. 扩展包部署

扩展包:Smartbi_Special_ExtendedFonts

部署说明:扩展包部署

1)更新扩展包之前,请做好知识库以及扩展包的备份。

2)服务器必须重启,否则,前端不会看到对应的字体。

3.2.配置说明

需要用解压工具,把对应的字体文件放到 Smartbi_Special_ExtendedFonts.ext 对应的目录下,同时 把修改的配置文件替换原来的文件。

1)字体目录:把对应的字体文件放到以下目录中

目录:Smartbi_Special_ExtendedFonts.ext\vision\js\ext\fonts

字体文件需要兼容应用服务器所在的操作系统。

扩展包自带的字体文件只作为演示使用,如果使用者要用于商用,请自行进行授权的购买。


2)css样式文件:修改ExtendedFonts.css文件内容,增加对应的字体文件的定义

目录:Smartbi_Special_ExtendedFonts.ext\vision\css\ExtendedFonts.css

示例:

@font-face {
    font-family: 'impact-2';
    font-style: normal;
    font-weight: 400;
    src: url(../js/ext/fonts/impact-2.ttf) format('truetype');
}

@font-face {
    font-family: 'NotoSansCJK-Regular-1';
    font-style: normal;
    font-weight: 400;
    src: url(../js/ext/fonts/NotoSansCJK-Regular-1.otf) format('opentype');
}

@font-face {
    font-family: 'PingFang-Jian-ChangGuiTi-2';
    font-style: normal;
    font-weight: 400;
    src: url(../js/ext/fonts/PingFang-Jian-ChangGuiTi-2.ttf) format('truetype');
}

不同格式的字体,配置css中的format不同;

例如:

ttf后缀的字体:format('truetype')

otf后缀的字体:format('opentype');

woff后缀的字体:format('woff');

woff2后缀的字体:format('woff2');

eot后缀的字体:format('embedded-opentype');


3)配置文件:修改ConfigurationPatch.js文件内容,增加对应的字体文件的配置

目录:Smartbi_Special_ExtendedFonts.ext\vision\js\ext\ConfigurationPatch.js

示例:

var ConfigurationPatch = {
    extensionPoints: {
        css: ["vision/css/ExtendedFonts.css"],
        xfontFamilies: [
            ["impact-2", "impact"], 
			["NotoSansCJK-Regular-1", "NotoSansCJK"],
            ["PingFang-Jian-ChangGuiTi-2", "PingFang-Jian"]
        ],
    }
};

自定义字体的名称,不要使用中文,Smartbi产品有些版本此处不兼容中文。


3.3.前端效果



  • 无标签