Final release for 1.7

git-svn-id: http://scm.dspace.org/svn/repo/dspace/trunk@5980 9c30dcfa-912a-0410-8fc2-9e0234be79fd
This commit is contained in:
Jeffrey Trimble
2010-12-16 16:59:42 +00:00
parent c8856f7b76
commit b72097b6a6

View File

@@ -16,17 +16,27 @@
</span>
</div>
<div class="pagesubheading">
This page last changed on Nov 06, 2010 by <font color="#0050B2">jtrimble</font>.
This page last changed on Dec 14, 2010 by <font color="#0050B2">tdonohue</font>.
</div>
<h1><a name="JSPUIConfigurationandCustomization-DSpaceSystemDocumentation%3AJPSUIConfigurationandCustomization"></a>DSpace System Documentation: JPSUI Configuration and Customization</h1>
<p>The DSpace digital repository supports two user interfaces: one based on JavaServer Pages (JSP) technologies and one based upon the Apache Cocoon framework (XMLUI). This chapter describes those parameters which are specific to the JPSUI interface.</p>
<p>The DSpace digital repository supports two user interfaces: one based on JavaServer Pages (JSP) technologies and one based upon the Apache Cocoon framework. This chapter describes those parameters which are specific to the JPSUI interface.</p>
<style type='text/css'>/*<![CDATA[*/
div.rbtoc1292368302632 {margin-left: 0px;padding: 0px;}
div.rbtoc1292368302632 ul {list-style: none;margin-left: 0px;}
div.rbtoc1292368302632 li {margin-left: 0px;padding-left: 0px;}
/*]]>*/</style><div class='rbtoc1292368302632'>
<ul>
<li><span class='TOCOutline'>1</span> <a href='#JSPUIConfigurationandCustomization-Configuration'>Configuration</a></li>
<li><span class='TOCOutline'>2</span> <a href='#JSPUIConfigurationandCustomization-CustomizingtheJSPpages'>Customizing the JSP pages</a></li>
</ul></div>
<h2><a name="JSPUIConfigurationandCustomization-Configuration"></a>Configuration</h2>
<p>The user will need to refer to the extensive WebUI/JSPUI configurations that are contained in 5.2.36 JSP Web Interface Settings.</p>
<p>The user will need to refer to the extensive <a href="Configuration.html" title="Configuration">WebUI/JSPUI configurations</a> that are contained in JSP Web Interface Settings.</p>
<h2><a name="JSPUIConfigurationandCustomization-CustomizingtheJSPpages"></a>Customizing the JSP pages</h2>
@@ -45,8 +55,11 @@
<ul>
<li><em>[dspace-source]/dspace-jspui/dspace-jspui-webapp/src/main/webapp/</em> &#45; Only exists if you downloaded the full Source Release of DSpace</li>
<li><em>[dspace-source]/dspace/target/dspace-[version].dir/webapps/dspace-jspui-webapp/</em> &#45; The location where they are copied after first building DSpace.<br/>
If you wish to modify a particular JSP, place your edited version in the <b><em>[dspace-source]/dspace/modules/jspui/src/main/webapp/</em></b> directory (<em>this is the replacement for the pre-1.5 &#95;/jsp/local</em> directory_), with the same path as the original. If they exist, these will be used in preference to the default JSPs. For example:
<li><em>[dspace-source]/dspace/target/dspace-[version].dir/webapps/dspace-jspui-webapp/</em> &#45; The location where they are copied after first building DSpace.</li>
</ul>
<p>If you wish to modify a particular JSP, place your edited version in the <b><em>[dspace-source]/dspace/modules/jspui/src/main/webapp/</em></b> directory (<em>this is the replacement for the pre-1.5 /jsp/local directory</em>), with the same path as the original. If they exist, these will be used in preference to the default JSPs. For example:</p>
<div class='table-wrap'>
<table class='confluenceTable'><tbody>
<tr>
@@ -63,15 +76,13 @@ If you wish to modify a particular JSP, place your edited version in the <b><em>
</tr>
</tbody></table>
</div>
</li>
</ul>
<p>Heavy use is made of a style sheet, <em>styles.css</em>. If you make edits, copy the local version to <em>[jsp.custom-dir]/dspace/modules/jspui/src/main/webapp/styles.css</em>, and it will be used automatically in preference to the default, as described above.</p>
<p>Fonts and colors can be easily changed using the stylesheet. The stylesheet is a JSP so that the user's browser version can be detected and the stylesheet tweaked accordingly.</p>
<p>The 'layout' of each page, that is, the top and bottom banners and the navigation bar, are determined by the JSPs <em>/layout/header&#45;</em><b><em>.jsp</em></b> <b>and</b> <b><em>/layout/footer&#45;</em></b><em>.jsp</em>. You can provide modified versions of these (in <em>[jsp.custom-dir]/dspace/modules/jspui/src/main/webapp/layout</em>), or define more styles and apply them to pages by using the "style" attribute of the <em>dspace:layout</em> tag.</p>
<p>The 'layout' of each page, that is, the top and bottom banners and the navigation bar, are determined by the JSPs <em>/layout/header&#45;&#42;.jsp</em> and <em>/layout/footer&#45;&#42;.jsp</em>. You can provide modified versions of these (in <em>[jsp.custom-dir]/dspace/modules/jspui/src/main/webapp/layout</em>), or define more styles and apply them to pages by using the "style" attribute of the <em>dspace:layout</em> tag.</p>
<ol>
<li>Rebuild the DSpace installation package by running the following command from your <em>[dspace-source]/dspace/</em> directory:
@@ -86,7 +97,7 @@ If you wish to modify a particular JSP, place your edited version in the <b><em>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">cp -R /[dspace]/webapps/* /[tomcat]/webapps</pre>
</div></div></li>
<li>Restart Tomcat <br/>
<li>Restart Tomcat<br/>
When you restart the web server you should see your customized JSPs.</li>
</ol>
@@ -100,7 +111,7 @@ When you restart the web server you should see your customized JSPs.</li>
<td height="12" background="https://wiki.duraspace.org/images/border/border_bottom.gif"><img src="images/border/spacer.gif" width="1" height="1" border="0"/></td>
</tr>
<tr>
<td align="center"><font color="grey">Document generated by Confluence on Nov 06, 2010 19:27</font></td>
<td align="center"><font color="grey">Document generated by Confluence on Dec 16, 2010 16:47</font></td>
</tr>
</table>
</body>