Extensions for DSpace XMLUI
This repository contains extension code for https://github.com/DSpace/DSpace specific to XMLUI.
How to use this
There are three steps to using XMLUI-Extras in your DSpace repository.
Obtain, build and install the API-Extras code
The XMLUI-Extras code depends on another DSpace extension module published by the IRR Team at the University of Waikato, API-Extras. Follow the instructions for obtaining, building and installing the API-Extras code, choosing the version of API-Extras required by your selected version of XMLUI-Extras.
Obtain, build and install the code
Then you will need to download, build and install the XMLUI-Extras maven module on the computer where you're intending to build DSpace. Take care to download a version of XMLUI-Extras that is compatible with your DSpace version (look at the version of the dspace-api dependency in this project's pom.xml file). You will typically want to check out one of the tags (released versions) of XMLUI-Extras rather than just master. At the top level of this project's source tree, run
mvn package install. This will place the xmlui-extras-VERSION.jar file in your local maven cache.
Pull XMLUI-Extras into DSpace
Then you will need to pull the XMLUI-Extras module into DSpace. In your DSpace source tree, edit the
dspace/modules/xmlui/pom.xml file. At the top of the existing dependencies section, you will need to insert a new dependency block.
<dependency> <groupId>nz.ac.waikato.its</groupId> <artifactId>xmlui-extras</artifactId> <version>VERSION</version> </dependency>
Instead of VERSION, put in the version of XMLUI-Extras you built in the first step. Make any other changes to actually use the features in XMLUI-Extras (eg, add aspect configuration to
dspace/config/xmlui.xconf). Finally, rebuild DSpace.