Warning: This page has not been updated in over over a year and may be outdated or deprecated.
development:architecture:less
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
development:architecture:less [2022/10/21 15:37] – demiankatz | development:architecture:less [2023/04/20 15:50] (current) – [Backup PHP Command Line Compiler (OBSOLETE/NOT RECOMMENDED)] demiankatz | ||
---|---|---|---|
Line 5: | Line 5: | ||
===== LESS vs. SASS ===== | ===== LESS vs. SASS ===== | ||
- | As of this writing, all VuFind® style development is done using LESS; SASS files are programmatically derived from the LESS files using the lessToSass [[development: | + | As of this writing, all VuFind® style development is done using LESS; SASS files are programmatically derived from the LESS files using the lessToSass [[development: |
===== Command Line Compilation ===== | ===== Command Line Compilation ===== | ||
- | Both Less and Sass use [[development: | + | Both Less and Sass use [[development: |
- | + | ||
- | ===== Active Compilation ===== | + | |
- | + | ||
- | :!: This feature was removed in VuFind® 9.0, and its use is strongly discouraged -- the built-in PHP-based LESS compiler did not generate output consistent with the command-line Grunt-driven LESS compiler, and this had a high potential for causing problems. | + | |
- | + | ||
- | Active compilation can be used to automatically compile from Less to CSS when a page loads. This is very useful for development. | + | |
- | + | ||
- | Write permission needs to be given to a new folder for LESS to work: [theme]/ | + | |
- | + | ||
- | Configure in theme.config.php: | + | |
- | " | + | |
- | " | + | |
- | " | + | |
- | ), | + | |
- | + | ||
- | For now, every LESS theme needs a compiled.less which " | + | |
===== LESS Theme Inheritance ==== | ===== LESS Theme Inheritance ==== | ||
Line 55: | Line 39: | ||
Make sure you have a compiled.less in your theme, as the LESS compiler may have trouble pulling from parent themes. Also, doing so will prevent multiple Bootstrap instances from being compiled into your final CSS. | Make sure you have a compiled.less in your theme, as the LESS compiler may have trouble pulling from parent themes. Also, doing so will prevent multiple Bootstrap instances from being compiled into your final CSS. | ||
- | ===== Backup PHP Command Line Compiler ===== | + | ===== Active Compilation (OBSOLETE/ |
+ | |||
+ | :!: This feature was removed in VuFind® 9.0, and its use is strongly discouraged -- the built-in PHP-based LESS compiler did not generate output consistent with the Node.js LESS compiler, and this had a high potential for causing problems. | ||
+ | |||
+ | Active compilation can be used to automatically compile from Less to CSS when a page loads. This is very useful for development. | ||
+ | |||
+ | Write permission needs to be given to a new folder for LESS to work: [theme]/ | ||
+ | |||
+ | Configure in theme.config.php: | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | ), | ||
+ | |||
+ | For now, every LESS theme needs a compiled.less which " | ||
+ | |||
+ | ===== Backup PHP Command Line Compiler | ||
- | :!: Note that the "grunt less" task is the preferred means of compiling LESS files for VuFind®, and the older PHP compiler may produce inconsistent results in some situations. The PHP compiler is deprecated as of VuFind® 8.0 and was removed in VuFind® 9.0. | + | :!: Note that the [[development: |
php util/ | php util/ |
development/architecture/less.1666366669.txt.gz · Last modified: 2022/10/21 15:37 by demiankatz