branding-css-links will output html link elements for css usage.

The contract includes css files which are passed in parameter with the following syntax :

• url attribute indicates the name of the css file, the dispatcher searches for this file in the following order :
  • Does the css file exists in the following directory - if yes, use this one : $PROJECT_HOME/src/documentation/resources/themes/yourtheme/css/
  • Otherwise, does the css file exists in the following directory - if yes, use this one : $FORREST_HOME/whiteboard/plugins/org.apache.forrest.themes.core/resources/themes/yourtheme/css/
  • Otherwise, does the css file exists in the following directory - if yes, use this one : $FORREST_HOME/whiteboard/plugins/org.apache.forrest.themes.core/resources/themes/common/css/
  The url attribute is required.
• media attribute indicates to the browser the stylesheets to use depending on the detination media :
  • screen : the stylesheet is used with the browser displaying the page on the screen,
  • print : the stylesheet is used while printing the document - or print preview...
  • othervalues can also be managed by browsers.cf. W3C Media Types.
  Firefox has a bug !

  There is a bug with firefox which does not manage media attribute while printing, the bug is already declared twice in bugzilla, so we are waiting...

• theme attribute indicates to the browser for which theme this stylesheet should be used, letting you add several css files corresponding to different themes of the same page.
  If omitted, the theme attribute take the value of the dispatcher.theme property that you should have defined in your forrest.properties.xml file.