Gulp plugin using paginationator to create pagination data for vinyl files coming through the stream.
Install with npm:
$ npm install --save gulp-paginationator
var paginationator = require('gulp-paginationator');
Uses paginationator to add pagination data to each file coming through the stream.
Params
options {Object}: Options to control which files are paginated and where the data is put.options.prop {String}: This is the property that the pagination data will be set on. Defaults to pager.options.filter {Function}: Function that may be used to control which files are paginated.options.sort {Function}: Function that may be used to sort the files before paginating.returns {Stream}: Stream to be passed to .pipe that will add pagination data to each file.Example
gulp.task('default', function() {
return gulp.src(['*.hbs'])
.pipe(paginationator())
.on('data', function(file) {
console.log(file);
console.log(file.data.pager);
});
});
See the examples folder showing each of the options. Run examples using node directly:
$ node examples
$ node examples/prop.js
$ node examples/filter.js
$ node examples/sort.js
Change the property that pagination data is stored on.
gulp.task('default', function() {
return gulp.src(['*.hbs'])
.pipe(paginationator({prop: 'pagination'}))
.on('data', function(file) {
console.log(file);
console.log(file.data.pagination);
});
});
Only include specific files to be paginated. The files that are not paginated will be pushed back into the stream after the paginated files.
gulp.task('default', function() {
return gulp.src(['*.hbs'])
.pipe(paginationator({
filter: function(file, i, files) {
return (i % 2 === 0);
}
}))
.on('data', function(file) {
console.log(file);
console.log(file.data && file.data.pager);
});
});
Sort the files before applying pagination.
gulp.task('default', function() {
return gulp.src(['*.hbs'])
.pipe(paginationator({
sort: function(a, b) {
if (a.stem > b.stem) return 1;
if (a.stem < b.stem) return -1;
return 0;
}
}))
.on('data', function(file) {
console.log(file);
console.log(file.data.pager);
});
});
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Please read the contributing guide for avice on opening issues, pull requests, and coding standards.
(This document was generated by verb-generate-readme (a verb generator), please don't edit the readme directly. Any changes to the readme must be made in .verb.md.)
To generate the readme and API documentation with verb:
$ npm install -g verb verb-generate-readme && verb
Install dev dependencies:
$ npm install -d && npm test
Brian Woodward
Copyright © 2016, Brian Woodward. Released under the MIT license.
This file was generated by verb, v0.9.0, on August 09, 2016.