Обновил информацию о подключающихся JS

README.md

@@ -38,6 +38,7 @@ block-name/               # Папка блока
   demo-block--mod.js      # js-файл для отдельного модификатора блока
   demo-block.html         # Варианты разметки (как документация блока или как вставляемый микрошаблонизатором фрагмент)
   demo-block.css          # Добавочный css (копируется как отдельный файл в `build/css`)
+  library.js              # Дополнительная js-библиотека, берется в конкатенируемый js-файл проекта (имя любое, в конкатенацию берется перед всеми прочими файлами, повторения ищутся по имени файла)
   readme.md               # Какое-то пояснение
 ```
 

gulpfile.js

@@ -44,7 +44,7 @@ let blocks = getComponentsFiles();
 
 // Вывод в консоль информации о взятых в сборку файлах (без LESS)
 if(blocks.js.length) {
-  console.log('---------- В сборку и обработку взяты JS-файлы:');
+  console.log('---------- В сборку и обработку взяты JS-файлы (указана последовательность):');
   console.log(blocks.js);
 }
 if(blocks.img.length) {
@@ -315,8 +315,8 @@ function getComponentsFiles() {
       let reg = new RegExp(componentName + '(\.|--)', '');
       blockFiles.forEach(function(file, i) {
         if(/\.js$/.test(file) && !reg.test(file)) {
-          if(fileExistAndHasContent(blockDir + '/' + file)) {        // и если он существует и не пуст
-            jsLibs.push(blockDir + '/' + file);  // добавим в массив библиотек
+          if(fileExistAndHasContent(blockDir + '/' + file)) {        // и если он не пуст
+            jsLibs.push(blockDir + '/' + file);                      // добавим в массив библиотек
           }
         }
       });
@@ -345,8 +345,9 @@ function getComponentsFiles() {
   if(jsLibs) {
     сomponentsFilesList.js = jsLibs.concat(сomponentsFilesList.js);
   }
+  // Если хочется иметь jQuery в конкатенируемом JS, раскомментируйте эти строки
   // if(fileExistAndHasContent(dirs.source + '/js/jquery.js')) {
-  //   сomponentsFilesList.js.unshift(dirs.source + '/js/jquery.js');
+  //   сomponentsFilesList.js.unshift(dirs.source + '/js/jquery.js'); // добавляем в самое начало
   // }
   // Добавим глобальный CSS-файл в начало массива с обрабатываемыми CSS-файлами
   if(fileExistAndHasContent(dirs.source + '/css/global-additional-css.css')) {

src/js/global-script.js

@@ -34,18 +34,6 @@ function ready(fn) {
 
 
 
-/*
-  При добавлении новых дополнительных функций, изолируйте их!
-*/
-
-// (function(){
-//   // код
-// }());
-
-
-
-
-
 // Свой код с jQuery
 
 // $( document ).ready(function() {

src/js/readme.md

-Javascript. Файлы иэ этой папки предполагается конкатенировать в один и углифицировать. Очередность конкатенации определяется в `gulpfile.js`
+# Javascript
 
-**ВНИМАНИЕ!** При добавлении сюда файла, нужно прописывать его в задаче по обработке js-файлов, ибо иначе не было бы контроля над последовательностью конкатенации.
+Файлы иэ этой папки предполагается конкатенировать в один и углифицировать. Очередность конкатенации определяется в `gulpfile.js` вручную.
+
+**ВНИМАНИЕ!** По умолчанию из этой папки в сборку берется только `global-script.js`.
+
+
+
+## Если нужно добавить какие-то JS-файлы
+
+Создайте [Блок](https://github.com/nicothin/NTH-start-project#Блоки) и подключите less-файл этого блока в диспетчере подключений. Очередность подключения js-файлов блоков определяется очередностью подключений less-файлов блоков. 

src/less/style.less

@@ -11,6 +11,7 @@
 @import './src/less/global/global-forms.less';
 @import './src/less/global/global-tables.less';
 
+// @import './src/blocks/demo-block/demo-block.less';
 @import './src/blocks/page-header/page-header.less';
 @import './src/blocks/page-footer/page-footer.less';
 @import './src/blocks/navbar/navbar.less';