pafnuty/less-for-bitrix

LESS Компилятор для Bitrix

LESS Компилятор для Bitrix

, _(*1)

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

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

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

• Быстрая работа.
• Автоматическая компиляция только изменённых файлов.
• Генерация SourceMap.
• Минификация CSS-кода.
• Управление доступом к компиляции.

Установка

Шаг 1

a)

Компонент очень удобно устанавливать через composer:, _(*4)

composer require pafnuty/less-for-bitrix

b)

Но можно и вручную, для этого нужно положить файлы и папаки из репозитория в папку /bitrix/modules/cn.less., _(*5)

Шаг 2

В админке перейти в раздел /bitrix/admin/partner_modules.php и выполнить установку решения LESS Компилятор (cn.less)., _(*6)

Использование

В нужном месте шаблона прописать вызов компонента:, _(*7)

<?$APPLICATION->IncludeComponent(
    "codenails:cn.less", 
    "", 
    array(),
    false
);?>

Так же можно выбрать нужный компонент при редактировании страницы:, _(*8)

, _(*9)

При необходимости можно настроить параметры., _(*10)

По умолчанию компонент будет искать файл SITE_TEMPLATE_PATH/less/template_styles.less и положит скомпилированный template_styles.css в папку с текущим шаблоном сайта., _(*11)

Не забывайте прописать в шаблон подключение CSS-файла, если настройки отличаются от стандартных:, _(*12)

<?\Bitrix\Main\Page\Asset::getInstance()->addCss('/local/assets/css/compiled_file.css');?>

Известные ошибки и недоработки

• При изменении параметров компонента нужно либо удалять папку less_cache и скомпилированные файлы (.css и .map), либо пересохранить один из less файлов, чтобы произошла перекомпляция.
• Для корректной работы SourseMap необходимо отключать минификацию CSS файла.

Вопросы и поддержка

Если у вас возник вопрос, или есть пожелания к улучшению компонента — воспользуйтесь формой, _(*13)

Куда делась старая "примочка"?

• Живёт в ветке old и её развитие не планируется.