gulp-tributary
v1.1.2
Published
Gulp plugin to insert one file into another
Downloads
4
Readme
Gulp tributary
Includes one file inside another by replacing placeholders with a file. Just like the #include directive of server side includes.
There are several other Gulp plugins that also do this, the differece with this one are the included files are taken from a Gulp stream rather than directly from the file system.
There are also compatible with Vinyl streams.
Example
Given the files:
<head>
<title>My awesome page</title>
<script><!-- include "my.js" --></script>
</head>function myAwesomeFunction() {}We can put them together to create:
<head>
<title>My awesome page</title>
<script>function myAwesomeFunction() {}</script>
</head>By using the following grunt task:
var tributary = require('gulp-tributary');
gulp.src('awesome-page.htm')
.pipe( tributary( gulp.src('script.js') ) )
.pipe( gulp.dest('dest') );However, if we also wanted to minifiy the javascript we could do the following:
var jsSource = gulp.src('script.js')
.pipe( require('gulp-uglify')() );
gulp.src('awesome-page.htm')
.pipe( tributary( jsSource ) )
.pipe( gulp.dest('dest') );tributary( source, options )
sourcea stream of Vinyl files that might be included, e.g.gulp.src()options.mediaTypespecify the media type of the files. Used to choose the placeholder tagsoptions.placeholderan Array containing the start and end parts of the placeholderoptions.ignoreMissingFilesBoolean, default = false, if true don't error if an included file cannot be found.options.delimiterthe delimiter to use around the filename. Defaults to"
Placeholders
The default placeholders depend on the media type of the file and are determined from the extension. The html placeholder is used as the default.
They must be matched exactly. The filetype delimiter is fixed.
- text/html - .htm -
<!-- include "filename" --> - application/javascript - .js -
/* include "filename" */ - text/css - .js, .less, .sass, .scss -
/* include "filename" */
These defaults can be overriden using the placeholder option. The media type of the file can be overriden using the mediaType option.
The default templates are set on a property of the tributary object called placeholders which can be used to modfiy them globally.