Dear Wiki user, You have subscribed to a wiki page or wiki category on "Rave Wiki" for change notification.
The "ArchitectureTopics/FrontendCustomization/BootstrapCustomization" page has been changed by StanDrozdetski: http://wiki.apache.org/rave/ArchitectureTopics/FrontendCustomization/BootstrapCustomization?action=diff&rev1=2&rev2=3 + Rave uses [[http://twitter.github.com/bootstrap/|Bootstrap]], a front-end framework. Bootstrap is assembled from its component files using [[http://lesscss.org/|LESS]]. - This proposal addresses customizing [[http://twitter.github.com/bootstrap/|Bootstrap]] for Rave so that: - - * Rave is insulated from changes in future Bootstrap versions (or, at least has a sensible upgrade path) - * Changes to Bootstrap definitions are easy to do === LESS setup === - The proposal is to create a rave.less file that contains: + rave.less aggregates three files: + * bootstrap.less ("stock" Bootstrap definitions) + * rave-css.less (generic Rave styles) + * rave-customizations.less (installation-specific UI adjustments) + To keep customizations separate from the core, Rave integrators are encouraged to tweak rave-customizations.less, leaving the other files untouched. - * reference to /v2.03/bootstrap.less (@include, using LESS syntax) - * bootstrap.less pulls in the "stock" Bootstrap definitions - * versioning Bootstrap files in a separate folder lets you swap in a new version with ease - * Rave-specific customizations - - A Rave integrator would then modify/append LESS definitions in rave.less to get their version looking the way they want. === LESS compilation === - The plan is to have server-side complication of the LESS files; as far as your Rave instance is concerned, it will be consuming a single (minified) CSS file – rave.css in the diagram above. + When Rave compiles, LESS files are processed with [[http://code.google.com/p/wro4j/|wro4j]] to produce a single CSS file – rave.css. - The ability to do client-side compilation (for quick troubleshooting on a development server) can be easily added. + The ability to perform client-side compilation (for quick troubleshooting on a development server) is upcoming. Once that's in place, rave.css can be minified during wro4j processing.
