wapplersystems / ws_less
TYPO3 的 LESS 编译器。将 LESS 文件编译成 CSS 文件。
Requires
- typo3/cms-core: ^12.4
- wikimedia/less.php: ^3.1.0
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 缓存的情况下看到更改的结果。
鸣谢
- Sven Wappler (TYPO3 代理 Aachen)
- Jozef Spisiak (www.pixelant.net) 为优化扩展做出了贡献