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

From Libopedia
Jump to navigation Jump to search
Line 40: Line 40:
 
To synchronise the live webapp styles folder with the source folder, type the following:
 
To synchronise the live webapp styles folder with the source folder, type the following:
 
  rsync -av $HOME/webapps/xmlui/themes/Mirage2/styles/ $HOME/{{Source}}/dspace-xmlui-mirage2/src/main/webapp/styles/
 
  rsync -av $HOME/webapps/xmlui/themes/Mirage2/styles/ $HOME/{{Source}}/dspace-xmlui-mirage2/src/main/webapp/styles/
 +
 +
To synchronise the live webapp stylesheet folder with the source folder, type the following:
 +
rsync -av $HOME/webapps/xmlui/themes/Mirage2/xsl/ $HOME/{{Source}}/dspace-xmlui-mirage2/src/main/webapp/xsl/
  
 
===Screenshot===
 
===Screenshot===

Revision as of 15:15, 10 June 2015

Back to Mirage 2 Theme

Introduction

These wiki pages will assist you in customising the Mirage 2 theme that was introduced with DSpace 5.X.

Please read the requirements first, to gain an understanding of the "bootstrap" framework, then proceed with the rest of the customisation.

This customisation is very basic and is intended for those who have basic web 2.0 design skills.

It is assumed that the Mirage 2 theme was installed according to: http://wiki.lib.sun.ac.za/index.php/SUNScholar/XMLUI_Theme/M2.

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

After you have completed your customisation, you will have to rebuild DSpace.

Procedures

  1. Requirements
  2. Introduction Text
  3. Institutional Branding
  4. Document Structure
  5. Banner Logo
  6. Palette (colours)
  7. Typography (fonts)
  8. Footer Design
  9. Multiple Themes
  10. Extra Customisation (Optional)

Tips

Live Webapp Quick Changes

This saves you from having to recompile the whole DSpace webapp just to see what effect a few SASS CSS changes will make.

Type the following: 

cd $HOME/webapp/xmlui/themes/Mirage2

compass watch

Now using another login session, you can modify the SASS CSS stylesheets in the styles folders and the main.css file will compile instantly.

Just remember to make the same changes to the source SASS CSS files, so that your changes will be applied after the next DSpace rebuild:

To synchronise the live webapp styles folder with the source folder, type the following: 

rsync -av $HOME/webapps/xmlui/themes/Mirage2/styles/ $HOME/source/dspace-xmlui-mirage2/src/main/webapp/styles/

To synchronise the live webapp stylesheet folder with the source folder, type the following: 

rsync -av $HOME/webapps/xmlui/themes/Mirage2/xsl/ $HOME/source/dspace-xmlui-mirage2/src/main/webapp/xsl/

Screenshot

M2.png

Help Links

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