Html编译配置
Html编译配置使用boi.spec
API:
boi.spec('html',<options>);
第一个参数代表需要配置的模块,Html对应value为html
。
options
包括以下可配置项:
ext
:String
,源文件扩展类型,默认为html
;engine
:String
,指定模块引擎类型。boi封装了Html、Jade、Swig、Ejs、Handlebar对应的编译方案,此列表之外的模板引擎需自行编写boi插件实现;source
:String
,源码html文件目录,相对于[basic](config.basic.md).source
。默认为views
;output
:String
,编译输出html文件目录,相对于[basic](config.basic.md).output
。默认为views
;mainFilePrefix
:String
,html文件的命名前缀,默认为index
。也就是说,默认的js主文件名为index.[name].html
;staticSrcmap
:Boolean
,是否编译输出静态资源映射表,默认为false
。此配置项是配合前后端分离方案boit的一种尝试;favicon
:String
,为项目指定favicon,取值为相对于项目根目录的相对地址,默认为null
。如果指定正确的favicon路径,boi会将favicon进行编译并将其引用地址自动注入到html文件中。favicon编译输出的本地路径为[image](config.image.md).output
指定目录的/favicon
子目录。urlTimestamp
:Boolean
,是否在静态资源url后加上时间戳(比如//static.app.com/common.js?1476183177875
),默认为false
。此配置项是处理浏览器缓存的一种方案,理想方案是使用文件hash指纹,而不是url query。之所以有此配置项是为了配合仍然使用url query作为静态资源更新方案的团队。