From a9d85fda04f20ae74f651bc84cdee6ae0b56b3a7 Mon Sep 17 00:00:00 2001 From: Tim Donohue Date: Thu, 7 Feb 2008 19:30:35 +0000 Subject: [PATCH] Updated configuration instructions to detail how to now customize JSPs. git-svn-id: http://scm.dspace.org/svn/repo/branches/dspace-1_5_x@2606 9c30dcfa-912a-0410-8fc2-9e0234be79fd --- dspace/docs/configure.html | 31 +++++++++++++++++-------------- 1 file changed, 17 insertions(+), 14 deletions(-) diff --git a/dspace/docs/configure.html b/dspace/docs/configure.html index 05f41ca8d6..e5eeeb18a9 100644 --- a/dspace/docs/configure.html +++ b/dspace/docs/configure.html @@ -1228,7 +1228,7 @@ The following vocabularies are currently available by default:

Thus, if possible, it is recommeded you limit your changes to the 'layout' JSPs and the stylesheet.

-

The JSPs are stored in [dspace-source]/jsp. Place your edited version of a JSP in the [dspace-source]/jsp/local directory, with the same path as the original. If they exist, these will be used in preference to the distributed versions in [dspace-source]/jsp. For example:

+

The JSPs are stored in [dspace-source]/jsp. Place your edited version of a JSP in the [dspace-source]/modules/dspace-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 distributed versions in [dspace-source]/jsp. For example:

@@ -1241,18 +1241,18 @@ The following vocabularies are currently available by default: - + - +
[dspace-source]/jsp/community-list.jsp[dspace-source]/jsp/local/community-list.jsp[dspace-source]/modules/dspace-jspui/src/main/webapp/community-list.jsp
[dspace-source]/jsp/mydspace/main.jsp[dspace-source]/jsp/local/mydspace/main.jsp[dspace-source]/modules/dspace-jspui/src/main/webapp/mydspace/main.jsp
-

Heavy use is made of a style sheet, in [dspace-source]/jsp/styles.css.jsp. If you make edits, call the local version [dspace-source]/jsp/local/styles.css.jsp, and it will be used automatically in preference to the default, as described above.

+

Heavy use is made of a style sheet, in [dspace-source]/jsp/styles.css.jsp. If you make edits, call the local version [dspace-source]/modules/dspace-jspui/src/main/webapp/styles.css.jsp, 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.

@@ -1262,21 +1262,24 @@ The following vocabularies are currently available by default:
  1. -

    Rebuild the dspace.war file by running the following command from your [dspace-source] directory:

    +

    Rebuild the DSpace installation package by running the following command from your [dspace-source] directory:

    +
    mvn package
    +
  2. +
  3. +

    Re-install the DSpace WAR(s) to [dspace]/webapps by running the following command from your [dspace-source]/target/dspace-[version].dir directory:

    -ant -Dconfig=[dspace]/config/dspace.cfg build_wars
    +ant -Dconfig=[dspace]/config/dspace.cfg update
     
  4. -

    Shut down Tomcat, and delete the existing [tomcat]/webapps/dspace directory.

    -
  5. - -
  6. -

    Copy the new .war file to the Tomcat webapps directory:

    -
    -cp [dspace-source]/build/dspace.war [tomcat]/webapps
    -
    +

    Depending on your setup with Tomcat, you may also need to do the following: +

      +
    • Shut down Tomcat, and delete any existing [tomcat]/webapps/dspace directories.
    • +
    • Copy the new .war file(s) to the Tomcat webapps directory:
    • +
    • Restart Tomcat.
    • +
    +