Плагин для gulp — собираем файлы по кусочкам

Недавно встала задача сверстать сайт не просто быстро, а очень быстро.

Поэтому было принято решение развернуть gulp-проект (до сегодняшнего дня я еще никогда не прибегал к его помощи) и сосредоточиться непосредственно на кодинге. К сожалению, этого оказалось недостаточно.

В процессе верстки стало понятно, что огромные полотна html- и js-кода с каждой строчкой все больше и больше замедляют процесс верстки. Если честно, данная проблема возникала и раньше, а сегодня встала особенно остро.

Поэтому потребовалось найти решение, благодаря которому можно подключить в нужном месте уже сверстанный блок и уменьшить тем самым размер кода в исходниках.

Порывшись в интернете, нашел плагин gulp-rigger. Получаса хватило для того, чтоб понять, что это совсем не то, что нужно:

• во-первых, странная обработка имен файлов. Почему-то, он не может работать с файлами .html (именно так), возможно есть и другие ограничения — не изучал;
• во-вторых (и наиболее важно), что он не умеет работать рекурсивно — если попробуете подключить таким образом файл, в котором уже есть подключение другого файла, вывалится ошибка.

Стало понятно, что моих проблем он решить не может.

Поэтому был изучен необходимый минимум и написан собственный плагин для gulp — gulp-pagebuilder.

Вышеназванные проблемы rigger он решает. Использование максимально просто. Допустим, имеем директорию с html-исходниками src, файлы собираются в build

Таск для галпа будет выглядеть примерно так:

var gulp = require('gulp'),
    pagebuilder = require('gulp-pagebuilder'));

gulp.task('default', function () {
    return gulp.src('src/*.html')
        .pipe(pagebuilder('src'))
        .pipe(gulp.dest('build/'));
});

pagebuilder('src') — сюда мы передаем директорию с исходниками, относительно которой будут искаться подключаемые файлы

В исходном файле подключаем другой файл:

<div class="someclass" >
    [snp tpl="some/block/in/src/somefile.html" class="foo bar" tag="sometag" content="bla bla bla" ]
</div>

Причем, параметры, которые можно передавать и использовать в подключаемом сниппете (отсюда и сокращение [snp… ]), могут быть совершенно любые — class, tag и прочие. Главное, чтоб tpl указывал на существующий файл, в противном случае ничего не подключится.

Подключаемый файл выглядит примерно так

<div class="otherclass {class}" data-tag="{tag}" >
    Some content, {content}
</div>

В случае успешной сборки результирующий файл будет выглядеть следующим образом:

<div class="someclass" data-tag="sometag" >
    <div class="otherclass foo bar" >
        Some content, bla bla bla
    </div>
</div>

Плагин работает с любыми текстовыми форматами, инклудить с его помощью можно и js

Плагин доступен в npm, код выложен на github.

Исправлять ошибки/замечания и причесывать код до нормального вида буду позже, когда появится время. Также буду рад любому фидбеку