Versions Compared

Old Version 3

changes.mady.by.user Tim Donohue

Saved on

compared with

New Version Current

changes.mady.by.user Mark H. Wood

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

You can also easily edit the text that appears on each JSP page by editing the Messages.properties file. However, note that unless you change the entry in all of the different language message files, users of other languages will still see the default text for their language. See Internationalization in Application Layer.

Note that the data (attributes) passed from an underlying Servlet to the JSP may change between versions, so you may have to modify your customized JSP to deal with the new data.

...

The JSPs are available in one of two places:

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

Wiki MarkupIf you wish to modify a particular JSP, place your edited version in the *_\[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="f5a6bee5-9322-4a1b-8a39-679d5d799a98"><ac:plain-text-body><![CDATA[

[jsp.dir]/community-list.jsp

[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="6c02da5c-2c4f-46e4-9afe-2d52c355a92f"><ac:plain-text-body><![CDATA[

[jsp.dir]/mydspace/main.jsp

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

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

Wiki MarkupHeavy use is made of a style sheet, _styles.css_. If you make edits, copy the local version to _\[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.

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.unmigrated-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 _\[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. Rebuild the DSpace installation package by running the following command from your _\[dspace-source\]/dspace/_ directory: unmigrated-wiki-markup
    Code Block
    mvn package
  2. Update   all   DSpace   webapps   to  _\[dspace\]/webapps_  by   running   the   following   command   from   your  _\[dspace-source\]/dspace/target/dspace-\[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.