svewap / ws_less
Requires
- typo3/cms-core: ^12.4
- wikimedia/less.php: ^3.1.0
This package is auto-updated.
Last update: 2023-10-25 13:54:35 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) 为优化扩展做出贡献