SUNScholar/XMLUI Theme/M2/Customisation/Multiple Themes

Back to Mirage 2 Customisation

Introduction

Any folder you create in the following folder will be interpreted as a Mirage2 based theme:

$HOME/source/dspace/modules/xmlui-mirage2/src/main/webapp/themes

Step 1 - Create folders

We have ten top level communities as faculties, therefore we need to create ten distinct themes, one per faculty.

Type the following;

cd $HOME/source/dspace/modules/xmlui-mirage2/src/main/webapp

mkdir -p themes/{01/styles,02/styles,03/styles,04/styles,05/styles,06/styles,07/styles,08/styles,09/styles,10/styles}

Step 2 - Create files

Now we have the style folders, the next step is to create the style file in styles folder.

First, we create styles template file;

cd /tmp

nano _styles.scss

Copy and paste the following into the file

/**
* Faculty branding
**/

$brand-primary:          #76273c;

Now we copy the style template to each of the styles folders;

cd $HOME/source/dspace/modules/xmlui-mirage2/src/main/webapp/themes

for x in 01 02 03 04 05 06 07 08 09 10; do cp /tmp/_styles.scss $x/styles; done

Step 3 - Modify color

Now there is a style file in each style folder.

Go to each style folder, in each of the top level folders and edit the color variable "$brand-primary" in the style file, to match the color per faculty.

See: http://wiki.lib.sun.ac.za/index.php/SUNScholar/Theme/Color_Palette for an example of a faculty palette.

Step 4 - Map themes

Now we need to map the themes to the relevant top level communities in the DSpace XMLUI.

First we record the handle per top level community manually on a piece of paper.

Then we do the mapping;

cd $HOME/dspace/config

nano xmlui.xconf

Copy and paste the following into the <themes> section as the first theme definitions;

        <theme name="M-F01" handle="99999.1/168" path="M-F01/" />
        <theme name="M-F02" handle="99999.1/169" path="M-F02/" />
        <theme name="M-F03" handle="99999.1/170" path="M-F03/" />
        <theme name="M-F04" handle="99999.1/171" path="M-F04/" />
        <theme name="M-F05" handle="99999.1/172" path="M-F05/" />
        <theme name="M-F06" handle="99999.1/173" path="M-F06/" />
        <theme name="M-F07" handle="99999.1/174" path="M-F07/" />
        <theme name="M-F08" handle="99999.1/175" path="M-F08/" />
        <theme name="M-F09" handle="99999.1/176" path="M-F09/" />
        <theme name="M-F10" handle="99999.1/177" path="M-F10/" />