gulp-htmlsplit

Gulp plugin to split HTML files into multiple output files using HTML comments.

!Travis CI
 
!npm version

Why?

I wrote this to take a static HTML page layout and split it into multiple files
for a WordPress site (header.php, index.php, and footer.php).

I also used gulp-processhtml to
perform other transformations of the layout, such as injecting PHP code and
changing asset paths. Highly recommended.

Installation

npm install gulp-htmlsplit --save-dev

Example Usage

$3

``js
var htmlsplit = require('gulp-htmlsplit');

// ...

gulp.task('foo', function() {
gulp.src('./*.html')
.pipe(htmlsplit())
.pipe(gulp.dest('build'));
})
`

$3

The plugin will look for comments of the form:



Everything following one of these comments will be piped to a file named filename.ext,
until another split comment is encountered, or the file ends.

If the HTML file does not begin with a split comment, the contents will be discarded
until the first comment is encountered. If no split comment is encountered,
the file will be left in the pipeline unchanged.

The resulting files can then be piped to other steps in the task or written out.

`html

My header here

My content here

`

If the filename is the special string stop, all content will be discarded until
the next split comment is encountered. For example, to extract just the header
and footer elements into separate files:

`html

My header here

My content here

`

An alternate stop string can be specified in the options:

`js
gulp.task('foo', function() {
gulp.src('./*.html')
.pipe(htmlsplit({ stop: 'end-here' }))
.pipe(gulp.dest('build'));
})
``