Date: Fri, 29 Mar 2024 02:00:39 -0400 (EDT) Message-ID: <223961461.29808.1711692039513@lyrasis1-roc-mp1> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_29807_1352183991.1711692039512" ------=_Part_29807_1352183991.1711692039512 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
This is a quick and rough guide to making a new theme under Mana= kin.
There is a theme tutorial.pdf at the Manakin homepage @ Texas A&M
*NOTE I am new to this - so please be aware there may be errors. You are= welcome to fix any you find. The configuration files (sitemap.xmap, xmlui.= xconf, etc.) all have useful comments, and the real documentation is coming= soon. *
Note 2: Unlike editing dspace JSP pages to change the look of your site,= it seems you can edit all these files 'in place' in your tomcat/webapps/ma= nakin/themes folder without redoing ant to build the *.war= files. You still need to restart tomcat. (I assume cocoon 'compiles' the s= tylesheets or something)
Install Manakin.
Have the basics of reading XML - identify tags, comments, etc.
Understand paths/realtive paths - ../ etc.
Understand HTML.
In t{{omcat/webapps/manakin/themes/}} make a new folder for your new the= me.
I just copied the 'Reference' theme into my folder
cp -r = Reference MyNewTheme
My changes to 'MyNewTheme' were;
In your theme change sitemap.xmap thus:
= <map:component-configurations> <global-variables> especially this line> <theme-path>MyNewTheme</theme-= path> > <theme-name>My Collection Theme&l= t;/theme-name>
reference and changing my /dspace/config/xmlui.conf with a line
specifying a theme and collection handle.
&l= t;theme name=3D"TerritoryImages" handle=3D"123456789/3" path=3D"MyNewTheme/= "/>
This has to go before the exitsing global theme declaration or it will b= e overidden.
eg
<= ;themes> <theme name=3D"MyNewTheme" handle=3D"123456789/3" path=3D"MyNewThe= me/"/> =20 <theme name=3D"Default Theme" regex=3D".*" path=3D"Reference/"/>= ; </themes>
Finally you should shutdown/restart TOMCAT.
Note: Once you configured your sitemap and xmlui.xconf you can modify th= e css and the xsl of your site and changes take effect in real time (workin= g with the themes inside tomcat/webapps) (thanks to Paulo Jobim for this ti= p)
That's it for now - I hope to add more as I learn.