TYPO3 的 LESS 编译器。将 LESS 文件编译成 CSS 文件。

安装量:3,042

依赖者: 0

建议者: 0

安全性: 0

星标: 7

关注者: 4

分支: 24

开放问题: 12

类型:typo3-cms-extension

12.0.1 2023-10-25 13:53 UTC

This package is auto-updated.

Last update: 2024-08-25 15:25:44 UTC


README

许可证:GNU GPL,版本 2

仓库:https://github.com/svewap/ws_less

请在此处报告错误:https://github.com/svewap/ws_less/issues

TYPO3 版本:>8.7

关于

ws_less 是一个 TYPO3 LESS 编译器,用于将 LESS 文件编译成 CSS 文件。此扩展使用 LessPHP 编译器。

扩展包含缓存功能。这意味着只有在必要时才会编译 LESS 文件。

您可以通过 TypoScript 将值传递给 LESS 文件。

用法

要包含您的 LESS 文件,您可以使用与往常一样使用 page.includeCSS TypoScript 命令。

page.includeCSS {
  bootstrap = fileadmin/bootstrap/less/bootstrap.less
  bootstrap.outputdir = fileadmin/bootstrap/css/

  responsive = fileadmin/bootstrap/less/responsive.less
  responsive.outputdir = fileadmin/bootstrap/css/

  rte = fileadmin/bootstrap/less/rte.less
  rte.outputdir = fileadmin/rte/css/
  rte.doNotHash = 1 # Disable file name hashing when using LESS variables via TypoScript
}

您也可以省略 outputdir 参数。扩展将 CSS 文件写入 typo3temp/ws_less 目录。

变量

您可以在模板的模板设置部分中设置 LESS 变量。

plugin.tx_wsless.variables {
  var1 = #000
  var2 = #666
}

禁用文件名哈希

对于在您的 ckeditor YAML 配置文件中包含生成的 CSS 文件,建议使用 doNotHash = 1 参数。当使用 LESS 变量时,生成的文件将是 fileadmin/rte/css/rte.css 而不是 fileadmin/rte/css/rte_468e20047a2589981edd540b083f26c4.css,这样您就可以轻松地在 RTE YAML 配置中使用 "contentsCss: "fileadmin/rte/css/rte.css"

开发通知

为了开发,建议在您的后端用户的 UserTS 配置中使用 admPanel.override.tsdebug.forceTemplateParsing = 1 强制渲染模板(关闭 TYPO3 模板缓存)。在以后端用户身份登录时,LESS 文件将在每次页面加载时编译,这样您可以在不重复清除 TYPO3 FE 缓存的情况下看到更改的结果。

鸣谢