Есть вопрос — задайте его в [issues](https://github.com/nicothin/NTH-start-project/issues).
## Стили
Файл-диспетчер подключений (`.src/scss/style.scss`) формируется автоматически на основании указанных в `./projectConfig.json` блоков и доп. файлов. Писать в `.src/scss/style.scss` что-либо руками бессмысленно: при старте автоматизации файл будет перезаписан.
Файл-диспетчер подключений (`.src/scss/style.scss`) формируется автоматически на основании указанных в `./projectConfig.json` блоков и доп. файлов. Писать в `.src/scss/style.scss` что-либо руками бессмысленно: при старте автоматизации файл будет перезаписан.
...
@@ -73,7 +82,7 @@
...
@@ -73,7 +82,7 @@
### Блоки
## Блоки
Каждый блок лежит в `./src/blocks/` в своей папке. Каждый блок — как минимум, папка и одноимённый scss-файл.
Каждый блок лежит в `./src/blocks/` в своей папке. Каждый блок — как минимум, папка и одноимённый scss-файл.
...
@@ -93,11 +102,11 @@ demo-block/ # Папка блока
...
@@ -93,11 +102,11 @@ demo-block/ # Папка блока
### Подключение блоков
## Подключение блоков
Список используемых блоков и дополнительных подключаемых файлов указан в `./projectConfig.json`. Список файлов и папок, взятых в обработку можно увидеть в терминале, если раскомментировать строку `console.log(lists);` в `gulpfile.js`.
Список используемых блоков и дополнительных подключаемых файлов указан в `./projectConfig.json`. Список файлов и папок, взятых в обработку можно увидеть в терминале, если раскомментировать строку `console.log(lists);` в `gulpfile.js`.
#### `blocks`
### `blocks`
Объект с блоками, используемыми на проекте. Каждый блок — отдельная папка с файлами, по умолчанию лежат в `./src/blocks/`.
Объект с блоками, используемыми на проекте. Каждый блок — отдельная папка с файлами, по умолчанию лежат в `./src/blocks/`.
...
@@ -113,7 +122,7 @@ demo-block/ # Папка блока
...
@@ -113,7 +122,7 @@ demo-block/ # Папка блока
}
}
```
```
#### `addCssBefore`
### `addCssBefore`
Массив с дополнительными стилевыми файлами, которые будут взяты в компиляцию ПЕРЕД стилевыми файлами блоков.
Массив с дополнительными стилевыми файлами, которые будут взяты в компиляцию ПЕРЕД стилевыми файлами блоков.
...
@@ -128,7 +137,7 @@ demo-block/ # Папка блока
...
@@ -128,7 +137,7 @@ demo-block/ # Папка блока
],
],
```
```
#### `addCssAfter`
### `addCssAfter`
Массив с дополнительными стилевыми файлами, которые будут взяты в компиляцию ПОСЛЕ стилевых файлов блоков.
Массив с дополнительными стилевыми файлами, которые будут взяты в компиляцию ПОСЛЕ стилевых файлов блоков.
...
@@ -138,7 +147,7 @@ demo-block/ # Папка блока
...
@@ -138,7 +147,7 @@ demo-block/ # Папка блока
],
],
```
```
#### `singleCompiled`
### `singleCompiled`
Массив стилевых файлов, которые будут скомпилированы независимо.
Массив стилевых файлов, которые будут скомпилированы независимо.
...
@@ -150,7 +159,7 @@ demo-block/ # Папка блока
...
@@ -150,7 +159,7 @@ demo-block/ # Папка блока
],
],
```
```
#### `addJsBefore`
### `addJsBefore`
Массив js-файлов, которые будут взяты в обработку (конкатенация/сжатие) ПЕРЕД js-файлами блоков.
Массив js-файлов, которые будут взяты в обработку (конкатенация/сжатие) ПЕРЕД js-файлами блоков.
...
@@ -164,7 +173,7 @@ demo-block/ # Папка блока
...
@@ -164,7 +173,7 @@ demo-block/ # Папка блока
],
],
```
```
#### `addJsAfter`
### `addJsAfter`
Массив js-файлов, которые будут взяты в обработку (конкатенация/сжатие) ПОСЛЕ js-файлов блоков.
Массив js-файлов, которые будут взяты в обработку (конкатенация/сжатие) ПОСЛЕ js-файлов блоков.
...
@@ -176,7 +185,7 @@ demo-block/ # Папка блока
...
@@ -176,7 +185,7 @@ demo-block/ # Папка блока
],
],
```
```
#### `addImages`
### `addImages`
Массив дополнительных изображений, добавляемый ПЕРЕД массивом изображений из блоков (внимание: при совпадении имен файлов, файлы из блоков имеют более высокий приоритет и затрут файлы из этого массива).
Массив дополнительных изображений, добавляемый ПЕРЕД массивом изображений из блоков (внимание: при совпадении имен файлов, файлы из блоков имеют более высокий приоритет и затрут файлы из этого массива).
...
@@ -186,17 +195,17 @@ demo-block/ # Папка блока
...
@@ -186,17 +195,17 @@ demo-block/ # Папка блока
],
],
```
```
#### `copiedCss`
### `copiedCss`
Массив css-файлов, которые копируются в папку сборки, подпапку `css/`
Массив css-файлов, которые копируются в папку сборки, подпапку `css/`
#### `copiedJs`
### `copiedJs`
Массив js-файлов, которые копируются в папку сборки, подпапку `js/`
Массив js-файлов, которые копируются в папку сборки, подпапку `js/`
**ВНИМАНИЕ!** Это JSON. Это строгий синтаксис, у последнего элемента в любом контексте не должно быть запятой в конце строки.
**ВНИМАНИЕ!** Это JSON. Это строгий синтаксис, у последнего элемента в любом контексте не должно быть запятой в конце строки.
#### Пример секции в `./projectConfig.json`
### Пример секции в `./projectConfig.json`
```json
```json
{
{
...
@@ -260,7 +269,7 @@ img:
...
@@ -260,7 +269,7 @@ img:
### Удобное создание нового блока
## Удобное создание нового блока
Предусмотрена команда для быстрого создания файловой структуры нового блока.
Предусмотрена команда для быстрого создания файловой структуры нового блока.