全局属性

全局属性通过 fis.set 设置，通过 fis.get 获取；

内置的默认配置

var DEFAULT_SETTINGS = {
  project: {
    charset: 'utf8',
    md5Length: 7,
    md5Connector: '_',
    files: ['**'],
    ignore: ['node_modules/**', 'output/**', '.git/**', 'fis-conf.js']
  },
  component: {
    skipRoadmapCheck: true,
    protocol: 'github',
    author: 'fis-components'
  },
  modules: {
    hook: 'components',
    packager: 'map'
  },
  options: {}
};

project.charset

• 解释：指定项目编译后产出文件的编码。
• 值类型：string
• 默认值：’utf8’

• 用法：在项目的fis-conf.js里可以覆盖为

    fis.set('project.charset', 'gbk');

  使用 charset 编码需要使用encoding插件发布编译结果

project.md5Length

• 解释：文件MD5戳长度。
• 值类型：number
• 默认值：7

• 用法：在项目的fis-conf.js里可以修改为

    fis.set('project.md5Length', 8);

project.md5Connector

• 解释：设置md5与文件的连字符。
• 值类型：string
• 默认值：_

• 用法：在项目的fis-conf.js里可以修改为

    fis.set('project.md5Connector ', '.');

project.files

• 解释：设置项目源码文件过滤器。
• 值类型：Array
• 默认值：’**’

• 用法：

    fis.set('project.files', ['*.html']);

project.ignore

• 解释：排除某些文件
• 值类型：Array
• 默认值：['node_modules/**', 'output/**', 'fis-conf.js']

• 用法

    fis.set('project.ignore', ['*.bak']); // set 为覆盖不是叠加

project.fileType.text

• 解释：追加文本文件后缀列表。
• 值类型：Array | string
• 默认值：无
• 说明：fis系统在编译时会对文本文件和图片类二进制文件做不同的处理，文件分类依据是后缀名。虽然内部已列出一些常见的文本文件后缀，但难保用户有其他的后缀文件，内部已列入文本文件后缀的列表为： [ ‘css’, ‘tpl’, ‘js’, ‘php’, ‘txt’, ‘json’, ‘xml’, ‘htm’, ‘text’, ‘xhtml’, ‘html’, ‘md’, ‘conf’, ‘po’, ‘config’, ‘tmpl’, ‘coffee’, ‘less’, ‘sass’, ‘jsp’, ‘scss’, ‘manifest’, ‘bak’, ‘asp’, ‘tmp’ ]，用户配置会 追加，而非覆盖内部后缀列表。

• 用法：编辑项目的fis-conf.js配置文件

    fis.set('project.fileType.text', 'tpl, js, css');

project.fileType.image

• 解释：追加图片类二进制文件后缀列表。
• 值类型：Array | string
• 默认值：无
• 说明：fis系统在编译时会对文本文件和图片类二进制文件做不同的处理，文件分类依据是后缀名。虽然内部已列出一些常见的图片类二进制文件后缀，但难保用户有其他的后缀文件，内部已列入文本文件后缀的列表为： [ ‘svg’, ‘tif’, ‘tiff’, ‘wbmp’, ‘png’, ‘bmp’, ‘fax’, ‘gif’, ‘ico’, ‘jfif’, ‘jpe’, ‘jpeg’, ‘jpg’, ‘woff’, ‘cur’ ]，用户配置会 追加，而非覆盖内部后缀列表。

• 用法：编辑项目的fis-conf.js配置文件

    fis.set('project.fileType.image', 'swf, cur, ico');

文件属性

fis3 以文件属性控制文件的编译合并以及各种操作；文件属性包括基本属性和插件属性，插件属性是为了方便在不同的插件扩展点设置插件；

基本属性

• release
• packTo
• packOrder
• query
• id
• url
• charset
• isHtmlLike
• isCssLike
• isJsLike
• useHash
• domain
• rExt
• useMap
• isMod
• extras
• requires
• useSameNameRequire
• useCache
• useCompile

release

• 解释：设置文件的产出路径。默认是文件相对项目根目录的路径，以 / 开头。该值可以设置为 false ，表示为不产出（unreleasable）文件。
• 值类型：string

• 默认值：无

    fis.match('/widget/{*,**/*}.js', {
        isMod: true,
        release: '/static/$0'
    });

packTo

• 解释：分配到这个属性的文件将会合并到这个属性配置的文件中
• 值类型：string

• 默认值：无

    fis.match('/widget/{*,**/*}.js', {
        packTo: '/static/pkg_widget.js'
    })

  widget 目录下的所有 js 文件将会被合并到 /static/pkg_widget.js 中。
  packTo 设置的是源码路径，也会受到已经设置的 fis.match 规则的影响，比如可以配置fis.match) 来更改 packTo 的产出路径或者 url；

    fis.match('/static/pkg_widget.js', {
        release: '/static/${namespace}/pkg/widget.js' // fis.set('namespace', 'home'),
        url: '/static/new/${namespace}/pkg/widget.js'
    })

packOrder

• 解释：用来控制合并时的顺序，值越小越在前面。配合 packTo 一起使用。
• 值类型：Integer
• 默认值：0

fis.match('/*.js', {
  packTo: 'pkg/script.js'
})
fis.match('/mod.js', {
  packOrder: -100
})

query

• 解释：指定文件的资源定位路径之后的query，比如’?t=123124132’。
• 值类型：string

• 默认值：无

    fis.set('new date', Date.now());
    fis.match('*.js', {
        query: '?=t' + fis.get('new date')
    });

id

• 解释：指定文件的资源id。默认是 namespace + subpath 的值
• 值类型：string

• 默认值：namespace + subpath

  如下方例子，假设 /static/lib/jquery.js 设定了特定的 id jquery,
  那么在使用这个组件的时候，可以直接用这个 id；

    fis.match('/static/lib/jquery.js', {
        id: 'jquery',
        isMod: true
    });

  使用

    var $ = require('jquery');

moduleId

• 解释：指定文件资源的模块id。在插件fis3-hook-module里面自动包裹define的时候会用到，默认是 id 的值。
• 类型：string

• 默认值：**namespace + subpath**

    fis.match('/static/lib/a.js', {
        id: 'a',
        moduleId: 'a'
        isMod: true
    });

  编译前

    exports.a = 10

  编译后

    define('a',function(require,exports,module){
      exports.a = 10
    })

url

• 解释：指定文件的资源定位路径，以 / 开头。默认是 release 的值，url可以与发布路径 release 不一致。
• 值类型：string

• 默认值：无

    fis.match('*.{js,css}', {
        release: '/static/$0',
        url: '/static/new_project/$0'
    })

charset

• 解释：指定文本文件的输出编码。默认是 utf8，可以制定为 gbk 或 gb2312等。
• 值类型：string

• 默认值：无

    fis.match('some/file/path', {
        charset: 'gbk'
    });

  使用 charset 编码需要使用encoding插件发布编译结果

isHtmlLike

• 解释：指定对文件进行 html 相关语言能力处理
• 值类型：bool
• 默认值：无

isCssLike

• 解释：指定对文件进行 css 相关的语言能力处理
• 值类型：bool
• 默认值：无

isJsLike

• 解释：指定对文件进行 js 相关的语言能力处理
• 值类型：string
• 默认值：无

useHash

• 解释：文件是否携带 md5 戳
• 值类型：bool
• 默认值：false

• 说明：文件分配到此属性后，其 url 及其产出带 md5 戳；

    fis.match('*.css', {
        useHash: false
    });
    fis.media('prod').match('*.css', {
        useHash: true
    });

  • fis3 release 时不带hash
  • fis3 release prod 时带 hash

domain

• 解释：给文件 URL 设置 domain 信息
• 值类型：string
• 默认值：无

• 说明：如果需要给某些资源添加 cdn，分配到此属性的资源 url 会被添加 domain；

    fis.media('prod').match('*.js', {
        domain: 'http://cdn.baidu.com/'
    });

  • fis3 release prod 时添加cdn

rExt

• 解释：设置最终文件产出后的后缀
• 值类型：string
• 默认值：无

• 说明：分配到此属性的资源的真实产出后缀

    fis.match('*.less', {
        rExt: '.css'
    });

  源码为.less文件产出后修改为.css文件；

useMap

• 解释：文件信息是否添加到 map.json
• 值类型：bool
• 默认值：无

• 说明： 分配到此属性的资源出现在静态资源表中，现在对 js、css 等文件默认加入了静态资源表中；

    fis.match('logo.png', {
        useMap: true
    });

isMod

• 解释：标示文件是否为组件化文件。
• 值类型：bool
• 默认值：无

• 说明：标记文件为组件化文件。被标记成组件化的文件会入map.json表。并且会对js文件进行组件化包装。

    fis.match('/widget/{*,**/*}.js', {
        isMod: true
    });

extras

• 注释：在[静态资源映射表][]中的附加数据，用于扩展[静态资源映射表][]表的功能。
• 值类型：Object
• 默认值：无

• 说明：无

    fis.match('/page/layout.tpl', {
        extras: {
            isPage: true
        }
    });

requires

• 注释：默认依赖的资源id表
• 值类型：Array
• 默认值：无

• 说明：

    fis.match('/widget/*.js', {
        requires: [
            'static/lib/jquery.js'
        ]
    });

useSameNameRequire

• 注释：开启同名依赖
• 值类型：bool
• 默认值：false

• 说明：当设置开启同名依赖，模板会依赖同名css、js；js 会依赖同名 css，不需要显式引用。

    fis.match('/widget/**', {
        useSameNameRequire: true
    });

useCache

• 注释： 文件是否使用编译缓存
• 值类型：bool
• 默认值： true

• 说明：当设置使用编译缓存，每个文件的编译结果均会在磁盘中保存以供下次编译使用。设置为 false 后，则该文件每次均会被编译。

    fis.match('**.html', {
        useCache: false
    });

useCompile

• 注释： FIS是否对文件进行编译
• 值类型：bool
• 默认值： true

• 说明：设置为 false 后文件会通过FIS发布，但是FIS不对文件做任何修改

    fis.match('**.html', {
        useCompile: false
    });

插件属性

插件属性决定了匹配的文件进行哪些插件的处理；

• lint
• parser
• preprocessor
• standard
• postprocessor
• optimizer

lint

启用 lint 插件进行代码检查

fis.match('*.js', {
    lint: fis.plugin('js', {
    })
})

更多插件

parser

启用 parser 插件对文件进行处理；

如编译less文件

fis.match('*.less', {
   parser: fis.plugin('less'), //启用fis-parser-less插件
   rExt: '.css'
});

如编译sass文件

fis.match('*.sass', {
    parser: fis.plugin('node-sass'), //启用fis-parser-node-sass插件
    rExt: '.css'
});

更多插件

preprocessor

标准化前处理

fis.match('*.{css,less}', {
    preprocessor: fis.plugin('image-set')
});

更多插件

standard

自定义标准化，可以自定义 uri、embed、require 等三种能力，可自定义三种语言能力的语法；

更多插件

postprocessor

标准化后处理

fis.match('*.{js,tpl}', {
   postprocessor: fis.plugin('require-async')
});

更多插件

optimizer

启用优化处理插件，并配置其属性

fis.match('*.css', {
    optimizer: fis.plugin('clean-css')
});

更多插件

打包阶段插件

打包阶段插件设置时必须分配给所有文件，设置时必须 match ::package，不然不做处理。

fis.match('::package', {
    packager: fis.plugin('map'),
    spriter: fis.plugin('csssprites')
});

prepackager

• 解释：打包预处理插件
• 值类型：Array | fis.plugin | function
• 默认值：无

• 用法：

    fis.match('::package', {
        prepackager: fis.plugin('plugin-name')
    })

packager

• 解释：打包插件
• 值类型：Array | fis.plugin | function
• 默认值：无

• 用法：

    fis.match('::package', {
        packager: fis.plugin('map')
    })

  例子

    fis.media('prod').match('::package', {
        packager: fis.plugin('map')
    });

  fis3 release prod 当在 prod 状态下进行打包

spriter

• 解释：打包后处理csssprite的插件。
• 值类型：Array | fis.plugin | function
• 默认值：无

• 用法：

    fis.match('::package', {
        spriter: fis.plugin('csssprites')
    })

  例子

    fis.media('prod').match('::package', {
        spriter: fis.plugin('csssprites')
    });

  fis3 release prod 当在 prod 状态下进行 csssprites 处理

postpackager

• 解释：打包后处理插件。
• 值类型：Array | fis.plugin | function
• 默认值：无

• 用法：

    fis.match('::package', {
        postpackager: fis.plugin('plugin-name')
    })

  例子

    fis.media('prod').match('::package', {
        postpackager: fis.plugin('plugin-name')
    });

  fis3 release prod 当在 prod 状态下调用打包后处理插件

deploy

• 解释：设置项目发布方式
• 值类型：Array | fis.plugin | function
• 默认值：fis.plugin('local-deliver')
• 说明：编译打包后，新增发布阶段，这个阶段主要决定了资源的发布方式，而这些方式都是以插件的方式提供的。比如你想一键部署到远端或者是把文件打包到 Tar/Zip 又或者是直接进行 Git 提交，都可以通过设置此属性，调用相应的插件就能搞定了。

• 用法：

  假设项目开发完后，想部署到其他机器上，我们选择 http 提交数据的方式部署

    fis.match('**', {
        deploy: fis.plugin('http-push', {
            receiver: 'http://target-host/receiver.php', // 接收端
            to: '/home/work/www' // 将部署到服务器的这个目录下
        })
    })

• 常用插件

  • local-deliver
  • http-push
  • replace
  • encoding