bem/bem-tools
-
c221a92395bd6c648967ded1425ffa1291222337
c221a92395bd6c648967ded1425ffa1291222337
Режимом по умолчанию является development. Установка `YENV` в значение production переключит его соответственно. -
4f26faa8fda83fb9abf0ea8e311c3c3a4c9d15dd
4f26faa8fda83fb9abf0ea8e311c3c3a4c9d15dd
Значения переменных окружения можно выставлять в `.bem/make.js`, например -
d1408a24a67fb393a3269198763f926de3310158
d1408a24a67fb393a3269198763f926de3310158
```js
process.env.YENV = 'production';
``` -
86fa69924857ee95796732137086bd4d99b37a35
86fa69924857ee95796732137086bd4d99b37a35
### Файлы конфигурации -
f5ea98656a5b53c961b0e4c38eee9eecf6cf34f5
f5ea98656a5b53c961b0e4c38eee9eecf6cf34f5
#### Уровень переопределения (`.bem/level.js`) -
194a541ad338ab372bfd03ed9433a426fbd61480
194a541ad338ab372bfd03ed9433a426fbd61480
На уровне переопределения должен быть файл конфигурации `.bem/level.js`, который содержит в себе мета-информацию
об устройстве уровня, а именно: -
589d823bdf8a900da296c0d355902129ff3f6bf3
589d823bdf8a900da296c0d355902129ff3f6bf3
- правила маппинга БЭМ-сущностей в файловую систему
- технологии, определённые для уровня
- мета-информация для системы сборки -
c72defcab3c960524574ddbcbfe400339d235022
c72defcab3c960524574ddbcbfe400339d235022
При создании уровня командой `bem create level` файл `.bem/level.js` создаётся пустым, что означает, что уровень —
«стандартный». Поведение стандартного уровня описано в классе `Level` в файле
(lib/level.js)[https://github.com/bem/bem-tools/blob/master/lib/level.js]. -
ddba0defb44beb19e73c91acd87800bc43ea8dde
ddba0defb44beb19e73c91acd87800bc43ea8dde
Перекрыть поведение уроня просто. Файл `.bem/level.js` (как и практически любой файл конфигурации) является CommonJS
модулем. `bem-tools` при обнаружении такого файла создаёт класс-наследник стандартного класса `Level`, используя экспорт
этого модуля в качестве расширения класса (внутри используется модуль [inherit](https://github.com/dfilatov/node-inherit)). -
1169535954577e1af5d762d82d8a5d9066761e43
1169535954577e1af5d762d82d8a5d9066761e43
В примере ниже перекрывается метод `getTechs()`. -
2ca80939cb99210de90e61282896097a3ba47876
2ca80939cb99210de90e61282896097a3ba47876
```js
exports.getTechs = function() { -
5ee5c50a2bb9bf21073fdd58a75f90237a0dfd0a
5ee5c50a2bb9bf21073fdd58a75f90237a0dfd0a
return {
'bemjson.js': ''
'css': 'path/to/my/css-tech-module.js'
} -
34b377a0ecb9a1336d7c5265900f8e4119a374d5
34b377a0ecb9a1336d7c5265900f8e4119a374d5
##### Наследование уровней -
85c3b2c56293d9eac3b426d406e12ca7442357bb
85c3b2c56293d9eac3b426d406e12ca7442357bb
Чтобы не копировать код из одного конфига уровней в другой, вы можете выносить общие части в самостоятельные модули
и наследоваться от них. Таким образом можно выстаивать целые иерархии уровней. -
4825160099cae9d6fc56d466f587fc464cd3e581
4825160099cae9d6fc56d466f587fc464cd3e581
Для задания базового уровня нужно экспортировать из модуля свойство `baseLevelPath`, например -
6414786a18f7934709067c27a222bb6a2809556f
6414786a18f7934709067c27a222bb6a2809556f
```js
exports.baseLevelPath = require.resolve('path/to/base/level.js');
``` -
3ad292ad5424d8424ad5762c3551c54f50c4dceb
3ad292ad5424d8424ad5762c3551c54f50c4dceb
Уровни-наследники также можно создавать командой -
47009c906666bd91cf691df7590ea6e90699beb7
47009c906666bd91cf691df7590ea6e90699beb7
bem create level<your-level-name>--level path/to/base/level.js -
84d0fe6d5a086ea1cea85db058e2dd29d2cdcbbc
84d0fe6d5a086ea1cea85db058e2dd29d2cdcbbc
##### Правила маппинга БЭМ-сущностей в файловую систему -
c26fa4f9777805fa1ca2afa07cab95fa227706b4
c26fa4f9777805fa1ca2afa07cab95fa227706b4
По умолчанию на уровне переопределения используется следующая схема маппинга (на примере технологии `css`):