This documentation relates to an old version of DSpace, version 3.x. Looking for another version? See all documentation.
Two options for base templates to use
There are two main base templates you can use when creating an XMLUI Theme:
- dri2xhtml - used in the generation of default Reference, Classic and Kubrick themes
- dri2xhtml-alt - used in the generation of default Mirage theme
You only should use one of these two templates, based on which seems easier to you.
The dri2xhtml base template is the original template for creating XMLUI themes. It attempts to provide generic XSLT templates which are then applied across the entire DSpace site, thus making it easier to make site-wide changes.
The dri2xhtml base template is used in the following Themes:
- Reference - the default XMLUI theme
- Classic - an XMLUI theme which looks similar to JSPUI
The dri2xhtml base template consists of five main XSLTs:
dri2xhtml/structural.xsl- this XSLT is in charge of creating the main layout/page structure of every page within DSpace
dri2xhtml/General-Handler.xsl- this XSLT is in charge of displaying File download links throughout DSpace (it matches the METS <fileSec> element).
dri2xhtml/DIM-Handler.xsl- this XSLT is in charge of displaying all DIM (DSpace Intermediate Metadata) metadata throughout DSpace (it matches any DIM metadata in the METS). By default, this is the template used to display all metadata.
dri2xhtml/MODS-Handler.xsl- this XSLT is in charge of displaying all MODS metadata throughout DSpace (it matches any MODS metadata in the METS). By default, this template is not used, as MODS metadata is not generated by XMLUI by default.
dri2xhtml/QDC-Handler.xsl- this XSLT is in charge of displaying all Qualified Dublin Core (QDC) metadata throughout DSpace (it matches any QDC metadata in the METS). By default, this template is not used, as QDC metadata is not generated by XMLUI by default.
The dri2xhtml-alt base template is an alternative template for creating XMLUI themes. It contains the same XSLT templates from dri2xhtml, but they are divided into multiple files and folders. Each file attempts to group XSLT templates together based on their function, in order to make it easier to find the templates related to the feature you're trying to modify.
The dri2xhtml-alt base template is used in the following Themes:
Configuration and Installation
The alternative basic templates is called "dri2xhtml-alt".
Any of the existing themes can be updated to reference this new set of templates by replacing in your theme.xsl:
Because the contents of dri2xhtml-alt is identical to the current dri2xhtml.xsl and its derivatives, updating any of the existing themes to reference the new dri2xhtml-alt should not impose any changes in the rendering of the pages.
- No changes to existing templates found in legacy dri2xhtml
- Drops inclusion of Handlers other than DIM and Default
- Templates divided out into files so they can be more easily located, divided by Aspect, Page and Functionality