Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Excerpt
hiddentrue

@mire contribution of new theme to support easier development and branding.Provides the following: (1) Mirage, a basic theme that contains the templates that need customization most often in the UI. (2) A Restructured dri2xhtml base templates for easing locating specific XSLT templates.

Mirage XMLUI Theme and Restructured dri2xhtml for DSpace 1.7

@mire contribution of new theme to support easier development and branding.Provides the following:

  1. Mirage, a new basic theme for the Manakin XML User Interface that contains the templates that need customization most often in the UI.
  2. A Restructured dri2xhtml base templates for easing locating specific XSLT templates.

Mirage XMLUI Theme

Overall Benefits

  • Clean new look and feel.
  • Increased browser compatibility. The whole theme renders perfectly in today's modern browsers (Internet Explorer 7 and higher, Firefox, Safari, Chrome, ...)
  • Easier to customize.
  • Enhanced Performance

Technical Features

Look & Feel

Structural enhancements for easier customization.

  • Based on the new restructured dri2xhtml base templates. Templates in the theme, overriding the new base templates, are located in the same folder hierarchy to ensure full transparancy.
  • Automated browser feature detection for improved browser compatibility.
    • In other themes, user agent detection is used to identify which browser version your user is using. Based on the result of this detection, the theme would use a different cascaded style sheet (CSS) to render a compatible page for the visitor. This approach has 2 major issues:
      • User agent detection isn't very reliable
      • Maintaining these different CSS files is a maintenance nightmare for developers, especially when using features from newer browsers.
    • Mirage applies two novel techniques to resolve these issues
  • CSS files are now split up according to function instead of browser. style.css will now fit most needs for customization. Following additional CSS files are included, but will rarely need to be changed:
    • reset.css ensures that browser-specific initializations are being reset.
    • base.css contains a few base styles
    • helper.css contains helper classes to deal with specific functionality.
    • handheld.css and print.css enable you to define styles for handheld devices and printing of pages.
  • jQuery and jQueryUI are included by default. To avoid conflicts the authority control javascript has been rewritten to use jQuery instead of Prototype and Script.aculo.us.

Enhanced Performance

  • Concatenation and Minification techniques for css and js files.
    • The IncludePageMeta has been extended to generate URL's to the concatenated version of all css files using the same media tag.
    • The ConcatenationReader has been created to return concatenated and minified versions of the css and js files.
    • Once js and css files have been minified and concatenated, they are being properly cached. As a result, the minification and concatenation operations only need to happen once, and do not include performance overhead.
    • Caution: when minification is enabled, all code-comments will be removed. This could be a problem for comments containing copyright notices, so for files with those comments you should disable minification by adding '?nominify' after the url e.g.
      <map:parameter name="javascript" value="lib/js/jquery-ui-1.8.5.custom.min.js?nominify"/>
    • Disabled by default, these features need to be enabled in the configuration using the properties 'xmlui.theme.enableConcatenation' and 'xmlui.theme.enableMinification'
    • These features can be enabled for other themes as well, but will require an alteration of the theme's sitemap.
  • Javascript references are included at the bottom of the page instead of the top. This optimizes page load times in general.

Screenshots



dri2xhtml-alt

See committed source for dri2xhtml-alt here: http://scm.dspace.org/svn/repo/dspace/trunk/dspace-xmlui/dspace-xmlui-webapp/src/main/webapp/themes/dri2xhtml-alt/

Configuration and Installation

The alternative basic templates has been committed, and is currently dubbed "dri2xhtml-alt".
Any of the existing themes can be updated to reference this new set of templates by replacing in your theme.xsl:

...