fis3-hook-relative

让 fis3 产出能够支持相对路径。

如何使用？

1. 安装插件

全局安装

npm install -g fis3-hook-relative

或者，局部安装

npm install fis3-hook-relative

2. 配置启动

// 启用插件
fis.hook('relative');

// 让所有文件，都使用相对路径。
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);

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