Merge branch 'master' of github.com:nicothin/NTH-start-project

README.md

@@ -60,18 +60,22 @@ npm start
 При `npm start` запускается дефолтная задача gulp:
 
 1. Очищается папка сборки (`build/`).
-5. Записывается `src/pug/mixins.pug` и компилируются файлы страниц (`src/pages/**/*`).
-5. Из скомпилированных html-файлов извлекаются все классы уровня БЭМ-блока, чтобы взять в сборку css и javascript только нужные файлы.
-5. Генерируются спрайты, в папку сборки копируются доп. файлы и картинки.
-5. Записывается `src/scss/style.scss`, в котором:
-    - Импорты файлов из `config.js#addStyleBefore`.
-    - Импорты файлов БЭМ-блоков, использующихся на проекте (если их scss-файлы существуют).
-    - Импорты файлов из `config.js#addStyleAfter`.
-5. Записывается `src/js/entry.js`, в котором:
-    - `require` файлов из `config.js#addJsBefore`.
-    - `require` файлов БЭМ-блоков, использующихся на проекте (если их js-файлы существуют).
-    - `require` файлов из `config.js#addJsAfter`.
-5. Компилируются и обрабатываются PostCSS-ом стили (`src/scss/style.scss`), собирается javascript (`src/js/entry.js`).
+5. Записывается файл `src/pug/mixins.pug` со всеми pug-файлами блоков.
+5. Компилируются файлы страниц (`src/pages/**/*.pug`).
+5. Из скомпилированных html-файлов извлекаются все классы уровня БЭМ-блока. На основании этого списка будут построены диспетчер подключения стилей и список всех js-файлов проекта.
+5. Генерируются спрайты, в папку сборки копируются картинки блоков и доп. файлы из секции `addAssets` файла `config.js`.
+5. Записывается диспетчер подключения стилей `src/scss/style.scss`, в котором:
+    - Импорты файлов из секции `addStyleBefore` файла `config.js`. По умолчанию — SCSS-переменные и примеси.
+    - Импорты файлов БЭМ-блоков, использующихся на проекте.
+    - Импорты файлов БЭМ-блоков, упомянутых в секции `alwaysAddBlocks` файла `config.js`. Таким образом, можно взять в сборку любой блок, даже если его css-класс не упоминается в разметке страниц.
+    - Импорты файлов из секции `addStyleAfter` файла `config.js`. По умолчанию — стили для печати страницы.
+5. Записывается диспетчер подключений скриптов `src/js/entry.js`, в котором:
+    - `require` файлов из секции `addJsBefore` файла `config.js`.
+    - `require` файлов БЭМ-блоков, использующихся на проекте.
+    - `require` файлов БЭМ-блоков, упомянутых в секции `alwaysAddBlocks` файла `config.js`.
+    - `require` файлов из секции `addJsAfter` файла `config.js`.
+5. Компилируются и обрабатываются PostCSS-ом стили (`src/scss/style.scss`).
+6. Javascript (`src/js/entry.js`) собирается webpack-ом.
 5. Запускается локальный сервер и слежение за файлами для пересборки.