fis3-hook-relative-legal-html

fis3 relative path support

install

npm install --global fis3-hook-relative-legal-html

配置

// 启用插件
fis.hook('relative-legal-html')

// 让所有文件，都使用相对路径。
fis.match('**', {
  relative: true,
})

如何解决 html 性质文件，访问路径与实际服务端存放路径不一致，导致相对路径错误

比如： /templates/xxx.tpl 发布到服务端后，是通过 http://domain.com/user 访问的，为了让 /templates/xxx.html 中的相对路径正确。请加上如下配置：

fis.match('/templates/xxx.tpl', {
  relative: '/user/', // 服务端访问路径
})

注意

如果 js 文件中有引用其他资源的情况。相对路径相对的其实不是 js 所在目录，而是页面所在目录。所以这块，如果要正确处理，也需要配置 relative 属性。

API

此插件还提供其他插件生成相对地址。如：

var message = {
  target: target, // 目标文件对象，或者目标文件的绝对 url
  file: file, // target 相对的文件。
}
fis.emit('plugin:relative:fetch', message)

// 如果 fis3-hook-relative 开启了。
// 那么 message.ret 将返回 target 相对与 file 的相对路径。
console.log(message.ret)

因为其他插件与该插件是非耦合的，所以是通过发送事件的方式询问，如果起了该插件，那么监听此事件来处理相对路径。

修复问题

fex-team/fis3-hook-relative 中间过程会生成类似src=__relative___<<<'some/file.ext'>>>的代码 导致 postprocess 插件在处理文件的时候可能出错

links

• fis3: http://fis.baidu.com/

license

MIT © fisker Cheung