tempaw-tools v2017.10.14-2

tempaw-tools version 2017.10.14

NPM: https://www.npmjs.com/package/tempaw-tools
GIT: https://github.com/OXAYAZA/tempaw-tools.git

Готовый инструментарий веб-разработчика.

Установка

npm i tempaw-tools

Использование (gulpfile.js)

const tempawTools = require( 'tempaw-tools' );
tempawTools();

При первом запуске автоматически создается файл конфигурации config.js.

Настройки (config.js)

livedemo - сервер живой перезагрузки (Browsersync)

• server boolean: корневая папка сервера
• port number: порт сервера
• open boolean: автоматическое открытие страницы при запуске в браузере по умолчанию
• notify boolean: уведомления в браузере
• reloadDelay number: задержка перед живой перезагрузкой в милисекундах
• ghostMode object: синхронизация действий в разных браузерах и устройствах
  • clicks boolean: синхронизация кликов
  • forms boolean: синхронизация заполнения форм
  • scroll boolean: синхронизация скролла

sass - препроцессор CSS (gulp-sass)

• enable boolean: включение/отключение слежения, компиляции и перезагрузки
• watch string: файлы для отслеживания изменений (glob-шаблон)
• source string: файлы для компиляции (glob-шаблон)
• dest string: конечная папка (куда компилить)
• options object: опции gulp-sass
  • outputStyle string: формат вывода стилей nested|expanded|compact|compressed
  • indentType string: тип отступа space|tab
  • indentWidth number: размер отступа 0:10
  • linefeed string: тип перевода строки cr|crlf|lf|lfcr

less - препроцессор CSS (gulp-less)

• enable boolean: включение/отключение слежения, компиляции и перезагрузки
• watch string: файлы для отслеживания изменений (glob-шаблон)
• source string: файлы для компиляции (glob-шаблон)
• dest string: конечная папка (куда компилить)

pug - препроцессор HTML (gulp-pug)

• enable boolean: включение/отключение слежения, компиляции и перезагрузки
• watch string: файлы для отслеживания изменений (glob-шаблон)
• source string: файлы для компиляции (glob-шаблон)
• dest string: конечная папка (куда компилить)
• options object: опции gulp-pug
  • pretty boolean: минифицированный/читабельный формат вывода
  • verbose boolean: вывод в консоль компилируемого файла
  • locals object: переменные для передачи в компилятор

jade - препроцессор HTML (gulp-jade)

• enable boolean: включение/отключение слежения, компиляции и перезагрузки
• watch string: файлы для отслеживания изменений (glob-шаблон)
• source string: файлы для компиляции (glob-шаблон)
• dest string: конечная папка (куда компилить)
• options object: опции gulp-jade
  • pretty boolean: минифицированный/читабельный формат вывода

babel - JS транспайлер (gulp-babel)

• enable boolean: включение/отключение слежения, компиляции и перезагрузки
• watch string: файлы для отслеживания изменений (glob-шаблон)
• source string: файлы для компиляции (glob-шаблон)
• dest string: конечная папка (куда компилить)
• options object: опции gulp-babel
  • presets array: пресеты для конечной среды кода
  • comments boolean: вывод комментариев
  • compact boolean: компактный вывод (удаление пробельних символов)
  • minified boolean: минификация (оптимизация кода)
  • sourceType string: режим обработки кода script|module
• alternate object: альтернативные опции
  • sourcemaps boolean: сорсмапы **

autoprefixer - автопрефиксер для CSS (gulp-autoprefixer)

• enable boolean: включение/отключение автопрефикса при компиляции css
• options object: опции gulp-autoprefixer
• cascade boolean: каскадирование стилей для неминифицированного css
• browsers array: список поддерживаемых браузеров

js - обработка js-файлов *

• enable boolean: вкл/выкл живую перезагрузку
• watch string: файлы для отслеживания изменений (glob-шаблон)

html - обработка html-файлов *

• enable boolean: вкл/выкл живую перезагрузку
• watch string: файлы для отслеживания изменений (glob-шаблон)
• validate string: выборка файлов для валидации
• report string: путь для отчета валидации

css - обработка css-файлов *

• enable boolean: вкл/выкл живую перезагрузку
• watch string: файлы для отслеживания изменений (glob-шаблон)

Список изменений

2017.10.14

• The Gulp of Mr. Atomson переименован в tempaw-tools и добавлен на npm
• Удален таск config

2017.10.13

• action:replaceContent заменен на action:transformContent

2017.10.12

• Добавлено скачивание файлов по ссылке

2017.10.11

• Правило для создания rtl версии стилей action:rtlCSS (rtlcss)
• Правило для замены контента в файлах из выборки по регулярному выражению action:replaceContent
• action:slice переименован в action:sliceContent и параметр regExp теперь имеет тип RegExp а не string

2017.10.10

• Удалены маски, в config.js можно использовать переменные
• Добавлен readme.md

2017.10.06

• Исправлен вывод ошибок в less

2017.10.04

• config.json заменен на config.js для возможности задавания колбеков
• Колбек name для генерации собственного имени в action:slice
• Changelog и версия перенесены в config.js
• Исправлена перезагрузка конфига
• Изменен способ версионности
• Генерация имени файла для бекапа

2017.10.02 (1.4.1)

• Нарезка файлов по регулярному выражению action:slice

2017.09.30 (1.4.0)

• Добавлен babel

2017.08.30 (1.3.4)

• Удалена переменная config.buildPreset, теперь из правил автоматически генерируются таски
• Изменена функция formSerialArray, теперь тип правила по умолчанию - serial
• Удален таск browsersync, сам browsersync запускается только в default

2017.08.26 (1.3.3)

• Нормализован вывод сообщений в консоль (плагин gulp-util, удалена функция genTime)
• Добавлена переменная config.pug.options.verbose переключающая отображение компилируемого файла в консоли
• Добавлена переменная config.pug.options.locals с помощью которой можно передавать параметры в pug-файлы
• gulp-util передан в pug, можно адевкатно выводить сообщения в консоль при компиляции
• Исправлена ошибка при использовании action:clean

2017.08.21 (1.3.2)

• Добавлен action:portJadePug для быстрого портирования Jade в Pug
• Исправлен вывод путей при использовании масок в build

2017.08.17 (1.3.1)

• Добавлена возможность создания масок config.mask для глобальной замены в путях
• В правиле с action:minifyimg добавлен параметр base задающий путь относительно которого формируется структура архива (по умолчанию ./)

2017.08.11 (1.3.0)

• Добавлен таск validate для валидации *.html файлов, параметры config.html.validate и config.html.report

2017.08.09 (1.2.1)

• Добавлен action:pack в правилах, создает zip-архив из переданых файлов относительно корня проекта
• Добавлен action:minifyimg в правилах, сжатие изображений

2017.08.08 (1.2.0)

• Изменена структура правил сборки (теперь правило это объект, вместо массива)
• Добавлены пресеты для сборки
• Добавлена возможность указать последовательные и паралельные этапы сборки serial или parallel
• Правила сборки action вместо отдельных тасков
• Служебные функции приведены к виду обьявления функции (Function Declaration) вместо функционального выражения (Function Expression) и перенесены в конец кода
• Иправлены проблемы с less и jade

2017.08.07 (1.1.2)

• Добавлен Jade
• Слежение за *.html и *.css
• Время компиляции в успешных оповещениях

2017.08.05 (1.1.0)

• Нормализован вывод сообщений об ошибках

2017.08.04 (1.0.2)

• Добавлена возможность задать правила для очистки
• Добавлен less

2017.08.03 (1.0.1)

• Добавлена возможность задать правила для сборки проекта

TODO

• Правила для компиляции sass, less, pug, jade, babel или запуск таска с параметрами
• action:runBuild для запуска блоков buildRules
• Цикличная обработка в правилах, вложенность блоков правил
• Довести до ума валидатор html
• Переделать action:slice
• Кеширование *.pug
• Оптимизация кода

Дополнительно

1. Browsersync
2. glob-шаблоны
3. gulp-sass/node-sass
4. gulp-less
5. gulp-pug/pug
6. gulp-jade/jade
7. gulp-babel/balel
8. gulp-autoprefixer
9. пример списка поддерживаемых браузеров
10. rtlcss

* - используется при откюченных компиляторах и отсутствии исходников
** - работает только в случае если код неминифицированный