Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The JSPs are available in one of two places:

  • Wiki Markup
    _\[DSDOC:dspace-source\]/dspace-jspui/dspace-jspui-webapp/src/main/webapp/_ \- Only exists if you downloaded the full Source Release of DSpace
  • Wiki Markup
    _\[DSDOC:dspace-source\]/dspace/target/dspace-\[DSDOC:version\].dir/webapps/dspace-jspui-webapp/_ \- The location where they are copied after first building DSpace.

Wiki Markup
If you wish to modify a particular JSP, place your edited version in the *_\[DSDOC:dspace-source\]/dspace/modules/jspui/src/main/webapp/_* directory (_this is the replacement for the pre-1.5 /jsp/local directory_), with the same path as the original. If they exist, these will be used in preference to the default JSPs. For example:

DSpace default

Locally-modified version

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="de4a2ce3a847adc8-210e21f8-40544bd1-8a07955d-b8d7b9878c89095a163f4d4f"><ac:plain-text-body><![CDATA[

[DSDOC:jsp.dir]/community-list.jsp

[DSDOC:jsp.custom-dir]/dspace/modules/jspui/src/main/webapp/community-list.jsp

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="1163a33968b0e1e6-9c2c55cf-426d4e2a-bb48b861-ca78b09654517c61c823e2bd"><ac:plain-text-body><![CDATA[

[DSDOC:jsp.dir]/mydspace/main.jsp

[DSDOC:jsp.custom-dir]/dspace/modules/jspui/src/main/webapp/mydspace/main.jsp

]]></ac:plain-text-body></ac:structured-macro>

Wiki Markup
Heavy use is made of a style sheet, _styles.css_. If you make edits, copy the local version to _\[DSDOC:jsp.custom-dir\]/dspace/modules/jspui/src/main/webapp/styles.css_, and it will be used automatically in preference to the default, as described above.

...

Wiki Markup
The 'layout' of each page, that is, the top and bottom banners and the navigation bar, are determined by the JSPs _/layout/header\-\*.jsp_ and _/layout/footer\-\*.jsp_. You can provide modified versions of these (in _\[DSDOC:jsp.custom-dir\]/dspace/modules/jspui/src/main/webapp/layout_), or define more styles and apply them to pages by using the "style" attribute of the _dspace:layout_ tag.

  1. Wiki Markup
    Rebuild the DSpace installation package by running the following command from your _\[DSDOC:dspace-source\]/dspace/_ directory:
    Code Block
    mvn package
  2. Wiki Markup
    Update all DSpace webapps to _\[DSDOC:dspace\]/webapps_ by running the following command from your _\[DSDOC:dspace-source\]/dspace/target/dspace-\[DSDOC:version\]-build.dir_ directory:
    Code Block
    ant -Dconfig=[dspace]/config/dspace.cfg update 
  3. Deploy the the new webapps:
    Code Block
    cp -R /[dspace]/webapps/* /[tomcat]/webapps
  4. Restart Tomcat
    When you restart the web server you should see your customized JSPs.