About Features Downloads Getting Started Documentation Events Support GitHub

Love VuFind®? Consider becoming a financial supporter. Your support helps build a better VuFind®!

Site Tools


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.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
development:architecture:less [2022/10/21 15:38] demiankatzdevelopment: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:grunt|grunt]] task. While LESS and SASS files should be functionally equivalent, the LESS files are more thoroughly tested and we apologize for any problems with SASS. Please feel free to contribute back to the project if you wish to improve our support of 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:npm|NPM script]]. While LESS and SASS files should be functionally equivalent, the LESS files are more thoroughly tested and we apologize for any problems with SASS. Please feel free to contribute back to the project if you wish to improve our support of SASS.
  
 ===== Command Line Compilation ===== ===== Command Line Compilation =====
  
-Both Less and Sass use [[development:grunt|grunt]] for compilation. They both compile to css/compiled.css.+Both Less and Sass use [[development:npm|NPM scripts]] for compilation. They both compile to css/compiled.css.
  
 ===== LESS Theme Inheritance ==== ===== LESS Theme Inheritance ====
Line 41: Line 41:
 ===== Active Compilation (OBSOLETE/NOT RECOMMENDED) ===== ===== Active Compilation (OBSOLETE/NOT RECOMMENDED) =====
  
-:!: 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.+:!: 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. Active compilation can be used to automatically compile from Less to CSS when a page loads. This is very useful for development.
Line 57: Line 57:
 ===== Backup PHP Command Line Compiler (OBSOLETE/NOT RECOMMENDED) ===== ===== Backup PHP Command Line Compiler (OBSOLETE/NOT RECOMMENDED) =====
  
-:!: 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:npm|build:css NPM script]] 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.
  
   php util/cssBuilder.php   php util/cssBuilder.php
development/architecture/less.1666366716.txt.gz · Last modified: 2022/10/21 15:38 by demiankatz