Page History

...

1. First determine a directory name for your new theme inside the dspace-src/dspace/modules/xmlui/src/main/webapp

   Code Block
   /themes/

   directory; this name will be referenced as theme-dir in these instructions.
2. Instead of starting your new theme completely from scratch, make a new copy of the standard theme template in a new directory, theme-dir.
   • First, build DSpace (

     Code Block
     mvn package

     ) if you haven't already

   • Code Block
     cd

     dspace-src

     Code Block
     /dspace/target/dspace-[version]-build.dir/webapps/xmlui/themes/

   • Code Block
     cp -R template

     theme-dir
3. Next customize the theme's sitemap by specifying the theme's directory and name. Open, dspace-src/dspace/modules/xmlui/src/main/webapp/themes/theme-dir/sitemap.xmap, and edit the global variables shown below:

   • Code Block
     <map:component-configurations>

   • Code Block
     <global-variables>

   • Code Block
     <theme-path>

     theme-dir

     Code Block
     </theme-path>

   • Code Block
     <theme-name>

     the name of your theme

     Code Block
     </theme-name>

   • Code Block
     </global-variables>

   • Code Block
     </map:component-configurations>

4. Next customize the theme's CSS stylesheets, by default there are two style sheets used – a base version for all browsers and then a supplemental version just for Internet explorer.
   • dspace-src/dspace/modules/xmlui/src/main/webapp/themes/theme-dir/lib/style.css
   • dspace-src/dspace/modules/xmlui/src/main/webapp/themes/theme-dir/lib/style-ie6.css
5. Perform the steps in Install + a + theme (Manakin)
6. Perform the steps in Rebuild + DSpace  

Hints on Customizing XSLT in a theme:

...