svewap/ws_less

此包已废弃,不再维护。作者建议使用 wapplersystems/ws_less 包。

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

安装次数: 3,683

依赖项: 0

建议者: 0

安全性: 0

星标: 7

关注者: 4

分支: 23

开放问题: 7

类型:typo3-cms-extension

12.0.1 2023-10-25 13:53 UTC

This package is auto-updated.

Last update: 2023-10-25 13:54:35 UTC


README

ext_icon.png

许可证: 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 缓存的情况下看到更改的结果。

致谢