diff --git a/README.md b/README.md index 96956d0..009f2b8 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ enb-bem-techs * [levelsToBemdecl](docs/api.ru.md#levelstobemdecl) — формирует BEMDECL-файл из БЭМ-сущностей с указанных уровней. * [bemjsonToBemdecl](docs/api.ru.md#bemjsontobemdecl) — формирует BEMDECL-файл из BEMJSON-файла. * [deps](docs/api.ru.md#deps) — дополняет декларацию БЭМ-сущностей необходимыми зависимостями. -* [depsOld](docs/api.ru.md#depsold) — дополняет декларацию БЭМ-сущностей необходимыми зависимостями. Использует алгоритм, заимствованный из [bem-tools](https://ru.bem.info/tools/bem/bem-tools/). +* [depsOld](docs/api.ru.md#depsold) — дополняет декларацию БЭМ-сущностей необходимыми зависимостями. Использует алгоритм, заимствованный из [bem-tools](https://github.com/bem/bem-tools/tree/support/0.10.x). * [depsByTechToBemdecl](docs/api.ru.md#depsbytechtobemdecl) — формирует BEMDECL-файл на основе зависимостей по технологиям. * [files](docs/api.ru.md#files) — собирает список исходных файлов и директорий для сборки. * [provideBemdecl](docs/api.ru.md#providebemdecl) — копирует BEMDECL-файл из указанной ноды (node) в текущую. @@ -39,7 +39,7 @@ $ npm install --save-dev enb-bem-techs ------------ * [API технологий](docs/api.ru.md) -* [Как устроены БЭМ-проекты](docs/bem-project.md) +* [Организация файловой структуры](https://ru.bem.info/methodology/filesystem/) * [Сборка бандла](docs/build-bundle.md) * [Сборка страницы](docs/build-page.md) * [Сборка merged-бандла](docs/build-merged-bundle.md) diff --git a/docs/bem-project.md b/docs/bem-project.md deleted file mode 100644 index d797f04..0000000 --- a/docs/bem-project.md +++ /dev/null @@ -1,61 +0,0 @@ -Как устроены БЭМ-проекты -======================== - -БЭМ-методология предполагает разделение интерфейса на независимые блоки. - -```sh -blocks/ -├── head/ -├── footer/ -├── logo/ -├── button/ -└── link/ -``` - -Каждый блок может быть реализован в одной или нескольких технологиях. - -```sh -button/ -├── button.css -└── button.js -``` - -Элементы и модификаторы можно выносить в отдельные файлы. Например, это позволяет не собирать неиспользуемые сущности. - -```sh -button/ -├── __text/ -│   ├── button__text.css -│   └── button__text.js -├── _focused/ -│   ├── button_focused.css -│   └── button_focused.js -├── _type/ -│   ├── button_type_link.css -│   ├── button_type_link.css -│   ├── button_type_submit.css -│   └── button_type_submit.js -├── button.css -└── button.js -``` - -В проекте может быть несколько уровней с блоками, например, для разделения кода по платформам. - -```sh -src/ -├── common.blocks/ -│ ├── button/ -│ └── link/ -├── desktop.blocks/ -│ └── button/ -└── touch.blocks/ - └── link/ -``` - -Примеры из жизни ----------------- - -* [bem-core](https://ru.bem.info/libs/bem-core/) -* [bem-components](https://ru.bem.info/libs/bem-components/) - -Подробнее об организации БЭМ-проектов в файловой системе читайте в разделе [методология](https://ru.bem.info/method/filesystem/) на сайте [bem.info](https://ru.bem.info/). diff --git a/docs/build-bundle.md b/docs/build-bundle.md index 1fef338..1d6e4bf 100644 --- a/docs/build-bundle.md +++ b/docs/build-bundle.md @@ -1,7 +1,7 @@ Сборка бандла ============= -Для сборки бандла понадобится список БЭМ-сущностей и уровни с исходным кодом блоков. О том, как устроены уровни переопределения, читайте в разделе «[Как устроены БЭМ-проекты](bem-project.md)». +Для сборки бандла понадобится список БЭМ-сущностей и уровни с исходным кодом блоков. О том, как устроены уровни переопределения, читайте в [БЭМ-методологии](https://ru.bem.info/methodology/filesystem/). Обычно список БЭМ-сущностей принято описывают в формате BEMDECL, например: