bem/bem-tools
-
f0a23d6bb118725f123267d5b54d481577330149
f0a23d6bb118725f123267d5b54d481577330149
```js
var extend = require('bem/lib/util').extend; -
caa77c0e122bee553af4296601ec9708ca13f893
caa77c0e122bee553af4296601ec9708ca13f893
exports.getTechs = function() {
return {
'bemjson.js': '',
'js': 'js-i',
'bemhtml.js': '../../bem-bl/blocks-common/i-bem/bem/techs/bemhtml.js',
'priv.js': '../../.bem/techs/priv.js',
'html': '../../bem-bl/blocks-common/i-bem/bem/techs/html'
};
}; -
7b86e280e3b9e78e268d9fb86d480f4c4690bf16
7b86e280e3b9e78e268d9fb86d480f4c4690bf16
exports.getConfig = function() { -
8d0daaf7e4ed99ac4ff49391be4dade9c2f20340
8d0daaf7e4ed99ac4ff49391be4dade9c2f20340
return extend({}, this.__base() || {}, { -
10f78c4cf9da24fb36a1e809f91f2e2a456088a5
10f78c4cf9da24fb36a1e809f91f2e2a456088a5
bundleBuildLevels: this.resolvePaths([
'../../bem-bl/blocks-common',
'../../bem-bl/blocks-desktop',
'../../blocks'
]) -
716ce942c4e0ef8c56d3b039f18b9cdd8e6afae4
716ce942c4e0ef8c56d3b039f18b9cdd8e6afae4
}); -
6491cbead47faf1d0be6e680ed4cb3d14bf599fc
6491cbead47faf1d0be6e680ed4cb3d14bf599fc
};
``` -
cb49eddf884eddfdb2954772eb1aa76d8928ec21
cb49eddf884eddfdb2954772eb1aa76d8928ec21
`getTechs()` возвращает массив подключаемых технологий: ключ (например `'bemjson.js'`, `'js'`, `'bemhtml.js'`) указывает
имя, под котором технологию можно будет использовать, значение (`''`, `'js-i'`, `'../../bem-bl/blocks-common/i-bem/bem/techs/bemhtml.js'`) -
где взять сам файл технологии. В качестве этого значения может быть указан абсолютный или относительный путь к файлу,
пустая строка или просто имя файла. В последнем случае подразумевается, что технология стандартная (входит в состав
bem-tools) и ее поиск будет произведен в директории `[bem]/lib/techs`. -
de829c8d0f1f3f1240b5c0edfd5a1584483c3543
de829c8d0f1f3f1240b5c0edfd5a1584483c3543
Функция `getConfig()` возвращает объект со свойстовом `bundleBuildLevels`, содержащим массив подключаемых уровней блоков. -
5a50569f6475403acdf1fa01bd560e3ff12325d3
5a50569f6475403acdf1fa01bd560e3ff12325d3
Второй (опциональный) компонент конфигурации - это файл `.bem/make.js` в корне проекта. Основой сборки является граф
узлов, каждый из которых отвечает за выполнение своей части всего процесса. В `make.js` можно изменять поведение узлов
и построение дерева. Существует несколько типов стандартных узлов:
* `Node` - базовый узел, от которого наследуются все остальные
* `LibraryNode` - отвечает за подключение внешних библиотек
* `LevelNode` - анализирует содержимое уровня переопределения и достраивает дерево для сборки этого уровня
* `BundlesLevelNode` - доопределяет `LevelNode` для сборки уровней бандлов
* `BundleNode` - достраивает дерево для сборки бандла
* `MergedBundleNode` - отвечает за сборку merged бандла (называемого так же common)
* `BorschikNode` - прогоняет файлы через утилиту `borschik`, которая разворачивает инклюды
* `Arch` - строит исходное дерево, состоящее главным образом из узлов `LibraryNode`, `BundlesLevelNode`, `LevelNode` -
fc9a8dce3f207ea500438722a300af9263083022
fc9a8dce3f207ea500438722a300af9263083022
Чтобы сконфигурировать сборку своего проекта, необходимо переопределить поведение тех или иных узлов. Это делается в
конфигурационном файле `.bem/make.js` в корне проекта с помощью хелпера `MAKE.decl()`. Первым аргументом ему передается
название узла, который будет переопределен. Вторым - объект с переопределяющими методами. -
5c27929c0234de4532f6c79c6488eb69aea49f9c
5c27929c0234de4532f6c79c6488eb69aea49f9c
```js
MAKE.decl('BundleNode', { -
1d36e5f8b736d59520da7e92d0cb19688991502b
1d36e5f8b736d59520da7e92d0cb19688991502b
});
``` -
981d2d0aec79c64826618e324cc2e63b975cce99
981d2d0aec79c64826618e324cc2e63b975cce99
У узлов есть несколько основных методов, отвечающих за процесс сборки:
* `isValid()` - проверяет, есть ли необходимость в запуске сборки данного узла. Если артефакты сборки узла уже были получены ранее и узлы, от которых зависит данный, не пересобирались в текущей сборке - то будет считаться, что узел не нужно пересобирать. Иными словами, если после первой сборки вы поменяли один файл, то при последующей сборке будут пересобраны только зависящие от этого файла узлы. Для остальных isValid вернет true и они не будут пересобираться.
* `make()` - осуществляет непосредственно сборку узла.
* `run()` - точка входа в узел. В реализации по умолчанию выполняет метод `isValid()` и в случае если он возвращает `false`, запускает `make()`.
* `clean()` - удаляет артефакты сборки данного узла. -
ce5fe2905d682fa1914ca02ecb0869045ad42fce
ce5fe2905d682fa1914ca02ecb0869045ad42fce
##### Примеры конфигурационных файлов для типовых задач -
53bacef9ed6d32e3bfa789794a1754234da98d25
53bacef9ed6d32e3bfa789794a1754234da98d25
###### Сборка статического html, css, js, bemhtml шаблонов из bemjson для уровня страниц pages. Подключаются уровень переопределения блоков blocks, а так же blocks-common и blocks-desktop из bem-bl -
55db1067b197e69a251f41f280a52a0c87c18336
55db1067b197e69a251f41f280a52a0c87c18336
`pages/.bem/level.js`
```js
var extend = require('bem/lib/util').extend; -
6c5d0c27402ae2189ad606839b6c8f71cec213ce
6c5d0c27402ae2189ad606839b6c8f71cec213ce
exports.getTechs = function() { -
0130b4c94d66fb460a729dcecc16158ae701ad6e
0130b4c94d66fb460a729dcecc16158ae701ad6e
return {
'bemjson.js': '',
'bemdecl.js': 'bemdecl.js',
'deps.js': 'deps.js',
'js': 'js-i',
'css': 'css',
'bemhtml.js': '../../bem-bl/blocks-common/i-bem/bem/techs/bemhtml.js',
'html': '../../bem-bl/blocks-common/i-bem/bem/techs/html.js'
}; -
479fc7c06b96a0acf32bee5c77ee38370a6414c9
479fc7c06b96a0acf32bee5c77ee38370a6414c9
};