LESS Компилятор для Bitrix
Простой и удобный компонент, реализующий компиляцию LESS файлов.
Преимущества
- Быстрая работа.
- Автоматическая компиляция только изменённых файлов.
- Генерация SourceMap.
- Минификация CSS-кода.
- Управление доступом к компиляции.
Установка
Шаг 1
a)
Компонент очень удобно устанавливать через composer:
composer require pafnuty/less-for-bitrix
b)
Но можно и вручную, для этого нужно положить файлы и папаки из репозитория в папку /bitrix/modules/cn.less
.
Шаг 2
В админке перейти в раздел /bitrix/admin/partner_modules.php
и выполнить установку решения LESS Компилятор (cn.less).
Использование
В нужном месте шаблона прописать вызов компонента:
<?$APPLICATION->IncludeComponent(
"codenails:cn.less",
"",
array(),
false
);?>
Так же можно выбрать нужный компонент при редактировании страницы:
При необходимости можно настроить параметры.
По умолчанию компонент будет искать файл SITE_TEMPLATE_PATH/less/template_styles.less
и положит скомпилированный template_styles.css
в папку с текущим шаблоном сайта.
Не забывайте прописать в шаблон подключение CSS-файла, если настройки отличаются от стандартных:
<?\Bitrix\Main\Page\Asset::getInstance()->addCss('/local/assets/css/compiled_file.css');?>
Известные ошибки и недоработки
- При изменении параметров компонента нужно либо удалять папку
less_cache
и скомпилированные файлы (.css
и.map
), либо пересохранить один из less файлов, чтобы произошла перекомпляция. - Для корректной работы SourseMap необходимо отключать минификацию CSS файла.
Вопросы и поддержка
Если у вас возник вопрос, или есть пожелания к улучшению компонента — воспользуйтесь формой
Куда делась старая "примочка"?
- Живёт в ветке old и её развитие не планируется.