SUNScholar/XMLUI Theme/M1/Creation

From Libopedia
Jump to navigation Jump to search 
Back to Mirage 1

Requirements

  1. Use port 80 and 443 as default on the Tomcat Java webapp server.
  2. Configure chosen UI as the default ROOT Java webapp.

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/source/dspace/modules/xmlui/src/main/webapp/themes

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

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

cd $HOME/source/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/source/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. 

<map:component-configurations>
    <global-variables>
       <theme-path>SUNScholar</theme-path>
       <theme-name>SUNScholar</theme-name>
    </global-variables>
</map:component-configurations>

Step 3 - Rename the "Mirage.xsl" file to "SUNScholar.xsl"

Type the following. 

cd $HOME/source/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/source/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 !! 

<theme name="SUNScholar" regex=".*" path="SUNScholar/" />
NANO Editor Help
CTL+O = Save the file and then press Enter
CTL+X = Exit "nano"
CTL+K = Delete line
CTL+U = Undelete line
CTL+W = Search for %%string%%
CTL+\ = Search for %%string%% and replace with $$string$$
CTL+C = Show line numbers

More info = http://en.wikipedia.org/wiki/Nano_(text_editor)

Retrieved from "http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/XMLUI_Theme/M1/Creation&oldid=42744"