bem/bem-tools
-
f86bda1883be176026f835a5fc750c300d8db226
f86bda1883be176026f835a5fc750c300d8db226
Для всех подкоманд `bem decl` в качестве входных деклараций (ключ `-d`) могут выступать
файлы как в формате `bemdecl.json`, так и файлы в формате `deps.js`. -
166f651c03e4603dfcbf4fbb9b3dd4db12ca11b1
166f651c03e4603dfcbf4fbb9b3dd4db12ca11b1
На выходе (ключ `-o`) всегда получается файл в формате `deps.js`. -
6d83df6a963a01dc5f71fe0d57f361db5901b437
6d83df6a963a01dc5f71fe0d57f361db5901b437
##### bem decl merge -
52c42f6ce13c3c0cb606390ee0a1cbbacf2c3a8d
52c42f6ce13c3c0cb606390ee0a1cbbacf2c3a8d
`bem decl merge` объединяет несколько деклараций в одну. Она бывает полезна в ситуациях,
когда, например, вам нужно собрать общую сборку для нескольких страниц. -
622d2b06804e97052e58d561b6422516e1717865
622d2b06804e97052e58d561b6422516e1717865
###### Создание декларации для всех страниц -
ede24c92972d66d22829794862532146cd3b2f33
ede24c92972d66d22829794862532146cd3b2f33
bem decl merge \
-d pages/index/index.deps.js \
-d pages/about/about.deps.js \
-d pages/search/search.deps.js \
-o pages/common/common.deps.js -
cd9e3b422a9ab148fcfa982ca667c4f98c6d1fae
cd9e3b422a9ab148fcfa982ca667c4f98c6d1fae
##### bem decl subtract -
23828d3dd6bc31ee7aa2e3b7a2a9953245b5f5c1
23828d3dd6bc31ee7aa2e3b7a2a9953245b5f5c1
`bem decl subtract` «вычитает» из первой указанной декларации все остальные. Она полезна
в ситуациях, когда, например, вам нужно сделать бандл, которые будет догружатся на страницу
по требованию. -
8e2466e8a8fe8e53b2cf5a077222e6c4d363ef69
8e2466e8a8fe8e53b2cf5a077222e6c4d363ef69
###### Создание декларации для подгружаемого по требованию «тяжёлого» блока -
045dfc244f01ba0b51f0c1f3cb076742c1bc3cd1
045dfc244f01ba0b51f0c1f3cb076742c1bc3cd1
bem decl subtract \
-d bundles/heavy-block/heavy-block.deps.js \
-d pages/common/common.deps.js \
-o bundles/heavy-block/heavy-block.bundle.js -
ac65ade6985c6e46a1a64cfe65234c23815ad89f
ac65ade6985c6e46a1a64cfe65234c23815ad89f
##### bem make
В команде `make` реализована сборка БЭМ проектов. Узнать больше о системах сборки можно из доклада Сергея Белова http://clubs.ya.ru/yasubbotnik/replies.xml?item_no=406. -
0981a62948ce2250b6ab496a9c2e58637e6943d9
0981a62948ce2250b6ab496a9c2e58637e6943d9
`bem make` собирает проект -
cbe1aeae26fec4c4e669b476ff1b8cc6323c27f2
cbe1aeae26fec4c4e669b476ff1b8cc6323c27f2
* подключает библиотеки блоков
* выполняет сборку в уровнях переопределения
* выполняет сборку бандлов
* собирает шаблоны (`bemhtml`)
* собирает `html` из `bemjson.js`
* собирает статические файлы (`js`, `css`)
* раскрывает `@import` в `css` файлах (`borschik`)
* раскрывает `borschik:link:include` в `js` файлах (`borschik`)
* сжимает `css` файлы при помощи `csso`
* сжимает `js` файлы при помощи `uglifyjs` -
2efc3934856d11f8c029d28b29e0b32b9c260214
2efc3934856d11f8c029d28b29e0b32b9c260214
##### bem server -
23cd7e58acdf4fe40e01b2e62469b5efec770fa2
23cd7e58acdf4fe40e01b2e62469b5efec770fa2
`bem server` веб-сервер разработчика, который делает доступными по http протоколу файлы, собранные на лету bem make. bem server может быть вам полезен для разработки статических страниц по bem методу. Вы просто вносите изменения в файлы проекта, обновляете страницу в браузере и видите новый результат — файлы, которые затронули ваши изменения, будут автоматически пересобраны. Если же в вашем проекте нет статических страниц, вы можете настроить бэкенд и окружение таким образом, чтобы он обращался к bem server за файлами стилей и скриптов. bem server позволяет общаться с ним через привычный TCP socket или через UNIX domain socket. -
94b14073ebc4694bb788e1f01c8404aba7000cd0
94b14073ebc4694bb788e1f01c8404aba7000cd0
По умолчанию корневым каталогом веб-сервера считается текущая директория. Вы можете указать нужный каталог с помощью
ключа --project (-r). Таким образом, если в корне есть файл pages/about/main.css, то он будет доступен из браузера
по адресу http://localhost:8080/pages/about/main.css. -
305f394264a4f16a47e223213ac14001d0845688
305f394264a4f16a47e223213ac14001d0845688
TCP порт по умолчанию, который слушает сервер - 8080. Вы можете указать другой порт, используя ключ --port (-p). -
31f528f7a11e6df1bd47ce7b16c8240afe83b05c
31f528f7a11e6df1bd47ce7b16c8240afe83b05c
Когда запрашиваемый URL соответствует директории, сервер проверит, возможно ли собрать для запрошенной директории файл
`index.html`. Если это так, то страница будет собрана и отдана браузеру. Иначе браузер получит листинг файлов в директории. -
5ff02907a17ec15e4cbca26de725a81c8fa7104c
5ff02907a17ec15e4cbca26de725a81c8fa7104c
#### Конфигурирование сборки -
36f840360671f8cdf113e23f26a5665e449b8380
36f840360671f8cdf113e23f26a5665e449b8380
В системе сборки предусмотрено некоторое поведение по умолчанию. С помощью файлов конфигурации можно как немного изменить
его, так и кардинально переделать. Необходимым минимумом для работы bem make являются конфиги `.bem/level.js` на уровнях
переопределения с функцией `getTechs()`, возвращающей массив технологий, задействованных на уровне. И функцией `getConfig()`: