andyorbis/gulp-bitrix

Конфиг Gulp и package.json для CMS «1С-Битрикс: Управление сайтом»

Gulp-bitrix

Конфиг Gulp и package.json для обработки JS/CSS/картинок в CMS «1С-Битрикс: Управление сайтом» в папке local (в шаблонах сайтов и компонентов). Создан для личного использования, но, возможно, кому-то еще пригодится.

Что эта конфигурация делает

При запуске команды gulp запускается watcher, следящий за изменениями CSS, SCSS, JS файлов и картинок в папке www/local/ (конкретнее - в папках css/js/images в корне всех шаблонов сайта, в папках images в шаблонах компонентов, а также следит за изменениями файлов CSS, SCSS, JS в корне шаблонов компонентов). Работает кеширование, проверяющее даты модификации файлов, за счет этого обрабатываются только измененные/добавленные файлы. По необходимости можно изменить конфигурацию под конкретные задачи.

SCSS/CSS-файлы:

1. преобразуются из SCSS в CSS;
2. автоматически добавляются префиксы для версий браузеров с >1% долей юзеров (задается в package.json);
3. минифицируются, очищаются от комментариев;
4. формируются map`ы на исходные файлы;
5. полученные файлы складываются рядом с исходными с расширением .min.css и .min.css.map.

JS-файлы:

1. преобразовываются из современных стандартов ECMAScript (es2015, es2016, es2017) в старую версию, совместимую с большинством браузеров (можно более тонко настроить версии. По умолчанию используется env-preset babel`а);
2. минифицируются, очищаются от комментариев;
3. формируются map`ы на исходные файлы;
4. полученные файлы складываются рядом с исходными с расширением .min.js и .min.js.map.

Картинки:

1. картинки с расширениями jpg, jpeg, gif, png, svg минифицируются и складываются с суффиксом .min рядом с исходными.

Установка

Чтобы установить конфиг для проекта Битрикс, нужно:

1. поставить на сервер Node.js (проверялось только на Node.js v10, но предположительно должно работать на Node.js v7 и выше);
2. скопировать файлы .babelrc, gulpfile.babel.js, package.json из корня данного репозитория на одну папку выше папки с сайтом (в «1C-Битрикс: Виртуальная машина» это /home/bitrix/);
3. выполнить в этой директории в терминале команду npm install для установки зависимостей;
4. прописать выполнение команды gulp в этой директории в автозапуск при загрузке сервера.

License

This project is licensed under the MIT License - see the LICENSE.md file for details