Difference between revisions of "SUNScholar/XMLUI Theme/M2"

From Libopedia
Jump to navigation Jump to search
Line 3: Line 3:
 
</center>
 
</center>
 
===<font color="red">'''PLEASE NOTE''':</font>===
 
===<font color="red">'''PLEASE NOTE''':</font>===
−
#'''<u>Please make sure that the server is able to download dependencies from the internet during the maven build process.</u>'''
+
#<font color="red">'''<u>Please make sure that the server is able to download dependencies from the internet during the maven build process.</u>'''</font>
 
#''Mirage 2 with DSpace => 5.X requires Ubuntu 14.04''.
 
#''Mirage 2 with DSpace => 5.X requires Ubuntu 14.04''.
 
#''If you want to upgrade to 14.04 LTS, then check:''<br><tt>http://wiki.lib.sun.ac.za/index.php/SUNScholar/Upgrading/Server_Software</tt>''
 
#''If you want to upgrade to 14.04 LTS, then check:''<br><tt>http://wiki.lib.sun.ac.za/index.php/SUNScholar/Upgrading/Server_Software</tt>''

Revision as of 10:25, 27 May 2015

Back to XMLUI Theme

PLEASE NOTE:

  1. Please make sure that the server is able to download dependencies from the internet during the maven build process.
  2. Mirage 2 with DSpace => 5.X requires Ubuntu 14.04.
  3. If you want to upgrade to 14.04 LTS, then check:
    http://wiki.lib.sun.ac.za/index.php/SUNScholar/Upgrading/Server_Software

Introduction

This is a very brief installation guide for the new Mirage2 theme released with DSpace version 5.

It is assumed that you installed DSpace according to: http://wiki.lib.sun.ac.za/index.php/SUNScholar/DSpace.

Requirements

Install Ubuntu Software

  • After logging in as the "dspace" user, install the required Ubuntu software, by typing the following:
sudo apt-get install git curl maven default-jdk default-jre

Source Code Symlink

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

Make sure you have correctly "symlinked" to the DSpace => 5.X source code, see step 3.2 in the link above.

Step 1 - Install Non-Ubuntu Software

  • Install the "node.js" software, by typing the following and following the instructions:
sudo curl -sL https://deb.nodesource.com/setup | sudo bash -
  • Install the node version manager (nvm) software, by typing the following and following the instructions:
sudo curl https://raw.githubusercontent.com/creationix/nvm/v0.24.0/install.sh | bash
  • Install the ruby version manager (rvm) software, by typing the following and following the instructions:
sudo curl -sSL https://get.rvm.io | bash -s stable

Step 2 - Install Theme Build Software

  • When the above software above has been installed correctly, then logout and login again as the "dspace" user.
  • Type the following to install the software required to customise and build the theme:
sudo -i

npm install --no-check-certificate -g bower

npm install --no-check-certificate -g grunt

npm install --no-check-certificate -g grunt-cli

npm install --no-check-certificate -g less2sass

exit

Step 3 - Build Theme

Full Build With Dependency Downloads

  • Rebuild DSpace by adding the following switch, "-Dmirage2.on=true", to the Maven build instruction.
  • For example;
mvn -U clean package -Dmirage2.on=true

See example build report below. 

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] 
[INFO] DSpace Parent Project ............................. SUCCESS [5.717s]
[INFO] DSpace Services Framework :: API and Implementation  SUCCESS [1.557s]
[INFO] DSpace Kernel :: API and Implementation ........... SUCCESS [5.619s]
[INFO] DSpace Addon Modules .............................. SUCCESS [0.048s]
[INFO] DSpace Kernel :: Additions and Local Customizations  SUCCESS [3.098s]
[INFO] DSpace XML-UI (Manakin) ........................... SUCCESS [2.737s]
[INFO] DSpace XML-UI Mirage2 Theme ....................... SUCCESS [0.209s]
[INFO] DSpace XML-UI Mirage2 Theme :: Local Customisations  SUCCESS [3:32.133s]
[INFO] DSpace XML-UI (Manakin) :: Local Customizations ... SUCCESS [13.554s]
[INFO] DSpace JSP-UI ..................................... SUCCESS [2.898s]
[INFO] DSpace JSP-UI :: Local Customizations ............. SUCCESS [4.898s]
[INFO] DSpace RDF ........................................ SUCCESS [3.811s]
[INFO] DSpace RDF :: Local Customizations ................ SUCCESS [5.349s]
[INFO] DSpace REST :: API and Implementation ............. SUCCESS [4.596s]
[INFO] DSpace REST :: Local Customizations ............... SUCCESS [5.610s]
[INFO] DSpace SWORD ...................................... SUCCESS [2.005s]
[INFO] DSpace SWORD :: Local Customizations .............. SUCCESS [4.508s]
[INFO] DSpace SWORD v2 ................................... SUCCESS [4.027s]
[INFO] DSpace SWORD v2 :: Local Customizations ........... SUCCESS [3.948s]
[INFO] Apache Solr Webapp ................................ SUCCESS [16.859s]
[INFO] DSpace SOLR :: Local Customizations ............... SUCCESS [6.708s]
[INFO] DSpace OAI-PMH .................................... SUCCESS [5.272s]
[INFO] DSpace OAI-PMH :: Local Customizations ............ SUCCESS [4.985s]
[INFO] DSpace Assembly and Configuration ................. SUCCESS [40.124s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 6:00.947s
[INFO] Finished at: Thu Apr 02 10:27:29 SAST 2015
[INFO] Final Memory: 78M/392M
[INFO] ------------------------------------------------------------------------

Quick Rebuild Without Dependency Downloads

Try the following to rebuild the theme without having to download dependencies again: 

 mvn -U clean package -Dmirage2.on=true -Dmirage2.deps.included=false
Please Note: https://jira.duraspace.org/browse/DS-2368.

This error appears when adding -Dmirage2.deps.included=false to the build.

Update Regular Rebuild DSpace Script

If you want to use the Mirage2 theme permanently, then make sure to add the Mirage2 build switch to your DSpace rebuild script.

  • For example;
mvn -U clean package -Dmirage2.on=true

Step 4 - Activate Theme

  • Type the following:
nano $HOME/source/dspace/config/xmlui.xconf

Check that the "Mirage2" theme is the ONLY active theme and not enclosed with <!-- .... -->. See below for an example. 

<theme name="Mirage 2" regex=".*" path="Mirage2/" />

See: https://github.com/DSpace/DSpace/blob/dspace-5_x/dspace/config/xmlui.xconf#L185

Step 5 - Customise Theme

Click on the heading above.

Build Issues Troubleshooting

References

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