SUNScholar/XMLUI Theme/M1/Creation

Back to Mirage 1

Requirements
Please see: http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace/S03

Make sure you have correctly "symlinked" to the source code, see step 3.2 in the link above.

Overlay Method
We will be using the "modules" overlay method to create a custom theme.

''' You can replace "SUNScholar" with a theme name of your choice for all of the following instructions. '''

Step 1 - Copy the "Mirage" reference theme to a custom "SUNScholar"
Type the following to create your own custom theme folder and files using the reference "Mirage" theme. mkdir $HOME//dspace/modules/xmlui/src/main/webapp/themes

cd $HOME//dspace-xmlui/src/main/webapp/themes

cp -R Mirage $HOME//dspace/modules/xmlui/src/main/webapp/themes/

cd $HOME//dspace/modules/xmlui/src/main/webapp/themes

mv Mirage SUNScholar

Step 2 - Modify the "sitemap.xmap" file to use "SUNScholar"
Type the following to change directory to the "SUNScholar" folder.

cd $HOME//dspace/modules/xmlui/src/main/webapp/themes/SUNScholar

Modify the sitemap.xmap config file for your new theme by typing the following. nano sitemap.xmap

Step 2.1
Change all the values of {global:theme-path} to SUNScholar.

Step 2.2
Change the "theme-path" and "theme-name" parameters to SUNScholar.   SUNScholar SUNScholar  

Step 3 - Rename the "Mirage.xsl" file to "SUNScholar.xsl"
Type the following. cd $HOME//dspace/modules/xmlui/src/main/webapp/themes/SUNScholar Rename the "Mirage.xsl" file to "SUNScholar.xsl" by typing the following. mv Mirage.xsl SUNScholar.xsl

Step 4 - Modify the "xmlui.xconf" file to use "SUNScholar"
Edit the following file: nano $HOME//dspace/config/xmlui.xconf

Add the following to "xmlui.xconf" file in the themes section using copy and paste with firefox and nano.

Make sure to comment out all other theme references !! 