README

Простой и удобный компонент, реализующий компиляцию LESS файлов.

❗ Компонент не подключает CSS к шаблону, а только компилирует LESS файлы. Это сделано специально для более гибкого управления подключением css-файлов.

Преимущества

Быстрая работа.
Автоматическая компиляция только изменённых файлов.
Генерация 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 и её развитие не планируется.

pafnuty / less-for-bitrix

Maintainers

Details