external-generation

Purpose

MCS will generate external style sheets where possible when this element is present. Some protocol/device combinations may not allow this, in which case the style sheet will be generated inline within the page.

Note:

In MCS 3.5 and later the cache related attributes cache and flush-on-restart for this element no longer have any effect and are deprecated. For reasons of backward compatibility the base-directory attribute is still required.

Contained by

Attributes

Attribute Description Type Default Options Use
base-directory The absolute path to the directory into where stylesheets are cached. The directory must exist and contain a subdirectory named 'cssFileCache'. xs:string none    required 
base-url The path to access the MCS servlet that serves the generated CSS files. This must take into account any URL mapping which may be done by servers between the browser and the application server on which the servlet is running. It must not end in '/'. xs:anyURI [context path]/MCSCSS    optional 
cache Controls whether stylesheet caching is enabled or not xs:string disabled  disabled, enabled  deprecated 
flush-on-restart If true the contents of the cache in base-directory are deleted when the MCS restarts. xs:boolean true    deprecated 
session Enables session identifier generation in the URL. Only one value is supported. xs:string none  include-id-in-url  optional 

Example

<style-sheets>
  <external-generation
    base-directory="${MCS_HOME}/mcs/css"
    base-url="[context_root]/MCSCSS"/>
</style-sheets>

Related topics