fisp-prepackager-concat

fis-prepackager-concat v0.0.11
======================

> A fis plugin. It first merges the contents of the specified file, then produces a file or replaces some of the content.

Getting Started

If you haven't used F.I.S, be sure to check out the Getting Started guide, as it explains how to create a F.I.S plugin. And reading through how does fis work will help you understand a lot more. Once you're familiar with that process, you may install this plugin with this command:

#### installation

``shell
$ npm install -g fis-prepakcager-concat
`

#### configuration

Once the plugin has been installed, it may be enabled with some line of configuration in your fis-conf.js file at your fis project's root directory.


`js
// add fis-prepackager-concat as a prepackager
fis.config.set('modules.prepackager', fis.config.get('modules.prepackager') + ',concat');

// configure some settings for this plugin
fis.config.set('settings.prepackager.concat', {
files: {
json: {
manifest: {
// 合并满足此格式的所有文件
include: /^\/widget\/plugin\/.*\/(manifest\.json)$/i,
// 是否压缩合并之后的内容
uglify: false,
// 产出文件名称，如果没有output则不产出文件
output: 'manifest.json',
// 内容模板，output为合并之后的内容
template: '{"manifest": [<% output %>]}'
},
log: {
include: /^\/widget\/.*\/(log\.json)$/i,
// 排除此条件的文件
exclude: /^\/widget\/plugin\/.*\/(log\.json)$/i,
uglify: true
}
},
css: {
icons: {
include: /^\/widget\/plugin\/.*\/(icon\.css)$/i,
uglify: true,
output: 'icons.css'
}
}
}
});

`

#### placing placeholders

Let's just assume you want to concatenate files of file_type type, and you want to identify them as placeholder_id

In HtmlLike files:

`html

`

In CssLike files:

`css
@import url(concat.file_type.placeholder_id);
// NOTE the semicolon
`

In JsLike files:
`js
__concat.file_type('placeholder_id')
// or
__concat.file_type("placeholder_id")
// NOTE: no semicolon at the end
`

Behind the scene

Basically, this plugin serves as a prepackager to replace the placeholders in other source files with the concatencated files' content. By doing that, it fails fis release -w when you write concatenating files because of the phase this plugin is in.

In prepackaging phase of fis, when fis is watching files with fis release -w`, fis only release files that's been changed. So if files that have placeholders in it will not be released again even if the concatenating files are changed unless you changed them too.

#### Workaround

You can work this around with two options:

* restart fis watching
* change files where the placeholders are in