gulp-include — npm
Пакет | gulp-include |
Описание | Упрощает включение файлов. Обеспечивает функциональность, аналогичную функциям snockets / sprockets или другим инструментам компиляции для вставки файлов. |
Версия узла | >= 6.0.0 |
Глотковая версия | >= 3.0.0 |
Работает с gulp 3 и gulp 4
Особенности
- Объединение файлов с полным доступом
- Учитывает пробелы отступа
- Использует глобусы для простого управления путем
- Работает рекурсивно (файлы могут включать файлы, которые могут включать файлы и т. д.)
Установка
NPM Установка gulp-inplude
Использование
Пример Gulpfile.js
:
Const Gulp = Tress ('Gulp')
CONST Включает констант = Treval Trev ('incl-ind in incl incl' incl 'incl incl incl' incl incl incl incl incl incl incl incl incl incl incl incl incl incl incl ude ude ude ude ude ud gl
exports. scripts = function (done) {
gulp.src('source/js/entry.js')
.pipe(include())
.on('error', console.log)
.pipe (Gulp.Dest ('dist/JS'))
}
включают директивы
ulp-include
, использующие директивы, аналогичные росков
или Snockets
. Директива — это комментарий в ваших файлах, который gulp-include
распознает как команду.
Пример директив:
//=require vendor/jquery.js
//=require vendor/**/*.js
//=include relative/path/to/file.js
// =include ./relative/path/to/file-even-when-includePaths-set.js
/*=include relative/path/to/file.css */
#=include relative/path /to/file.coffee
Содержимое указанного файла заменит файл.
требуют
по сравнению с включают
Файл, включенный с требует
, будет включен только в том случае, если он не был включен ранее. Файлы, включенные с , включают
, всегда будут включены .
Например, допустим, вы хотите включить jquery.js
только один раз и перед любыми другими скриптами в той же папке.
//=требуется поставщик/jquery.js
//=требуется поставщик/*.js
Примечание. Это также работает рекурсивно. Например, в приведенном выше примере, если другой файл в папке поставщика
также включает jquery.js
с директивой require
, он будет проигнорирован.
Опции
удлинители
(дополнительно)- Принимает строку
например:"js"
или["js", "кофе"]
- Если установлено, все директивы, не соответствующие расширению(ям), будут игнорироваться
- Принимает строку
includePaths
(необязательно)- Принимает строку
например:__dirname + "/node_modules"
или[__dirname + "/assets/js", __dirname + "/bower_components"]
- Если установлено,
gulp-include
будет использовать эти папки в качестве базового пути при поиске файлов. - Если установлено, вы по-прежнему можете включать файлы относительно текущего файла, предварительно ожидая включения с помощью
./
.
- Принимает строку
HardFail
(дополнительно)- Булево значение,
ложь
по умолчанию - Установите для этого параметра значение
true
, если вы хотите, чтобыgulp-include
выдавало ошибки, если файл не соответствует директива включения. - Если установлено значение
, false
, gulp include не завершится ошибкой, но отобразит предупреждения в консоли.
- Булево значение,
отдельные входы
(дополнительно)- Логический,
ложь
по умолчанию - Установите для этого параметра значение
true
, чтобы каждый входной файл мог использоватьrequire
-директивы независимо. - Полезно, если вы ссылаетесь на несколько путей в
gulp.src
и вам нужно, чтобы онитребовали
одних и тех же файлов.
- Логический,
Пример использования параметров:
gulp.src('src/js/main.js')
.pipe(include({
extensions: 'js',