Difference between revisions of "SUNScholar/XMLUI Theme/M1/Creation"
m |
|||
| Line 2: | Line 2: | ||
'''[[SUNScholar/XMLUI_Theme/M1|Back to Mirage 1]]''' | '''[[SUNScholar/XMLUI_Theme/M1|Back to Mirage 1]]''' | ||
</center> | </center> | ||
| − | ==Requirements== | + | ===Requirements=== |
Please see: http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace/S03 | Please see: http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace/S03 | ||
| Line 13: | Line 13: | ||
You can replace "SUNScholar" with a theme name of your choice for all of the following instructions. | 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"== | + | ===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. | Type the following to create your own custom theme folder and files using the reference "Mirage" theme. | ||
| Line 28: | Line 28: | ||
mv Mirage SUNScholar | mv Mirage SUNScholar | ||
| − | ==Step 2 - Modify the "xmlui.xconf" file to use "SUNScholar"== | + | ===Step 2 - Modify the "xmlui.xconf" file to use "SUNScholar"=== |
Edit the following file: | Edit the following file: | ||
nano $HOME/<u>[[SUNScholar/Install_DSpace/S03#Step_3.2|source]]</u>/dspace/config/xmlui.xconf | nano $HOME/<u>[[SUNScholar/Install_DSpace/S03#Step_3.2|source]]</u>/dspace/config/xmlui.xconf | ||
| Line 41: | Line 41: | ||
{{NANO}} | {{NANO}} | ||
| − | ==Step 3 - Modify the "sitemap.xmap" file to use "SUNScholar"== | + | ===Step 3 - Modify the "sitemap.xmap" file to use "SUNScholar"=== |
Type the following to change directory to the "SUNScholar" folder. | Type the following to change directory to the "SUNScholar" folder. | ||
| Line 49: | Line 49: | ||
nano sitemap.xmap | nano sitemap.xmap | ||
| − | ===Step 3.1=== | + | ====Step 3.1==== |
Change all the values of <tt>'''{global:theme-path}'''</tt> to <tt>'''SUNScholar'''</tt>. | Change all the values of <tt>'''{global:theme-path}'''</tt> to <tt>'''SUNScholar'''</tt>. | ||
| − | ===Step 3.2=== | + | ====Step 3.2==== |
Change the "theme-path" and "theme-name" parameters to <tt>'''SUNScholar'''</tt>. | Change the "theme-path" and "theme-name" parameters to <tt>'''SUNScholar'''</tt>. | ||
<pre> | <pre> | ||
| Line 62: | Line 62: | ||
</pre> | </pre> | ||
| − | ==Step 4 - Rename the "Mirage.xsl" file to "SUNScholar.xsl"== | + | ===Step 4 - Rename the "Mirage.xsl" file to "SUNScholar.xsl"=== |
Type the following. | Type the following. | ||
cd $HOME/<u>[[SUNScholar/Install_DSpace/S03#Step_3.2|source]]</u>/dspace/modules/xmlui/src/main/webapp/themes/SUNScholar | cd $HOME/<u>[[SUNScholar/Install_DSpace/S03#Step_3.2|source]]</u>/dspace/modules/xmlui/src/main/webapp/themes/SUNScholar | ||
Rename the "Mirage.xsl" file to "SUNScholar.xsl" by typing the following. | Rename the "Mirage.xsl" file to "SUNScholar.xsl" by typing the following. | ||
mv Mirage.xsl SUNScholar.xsl | mv Mirage.xsl SUNScholar.xsl | ||
Revision as of 15:17, 27 May 2015
Back to Mirage 1
Contents
Requirements
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.
The default folder is:
$HOME/source/dspace/modules/xmlui/src/main/webapp/themes/[custom-theme-dir]
- 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
mkdir $HOME/source/dspace/modules/xmlui/src/main/webapp/themes/SUNScholar
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 "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)
Step 3 - 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 3.1
Change all the values of {global:theme-path} to SUNScholar.
Step 3.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 4 - 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
