Editing Coversheets (section)

===PDFBox or GhostScript===
The Coversheets Bazaar package requires either '''PDFBox''' or '''GhostScript''' to attach the generated coversheet to the rest of the PDF document.  For the more recent Linux distributions (e.g. Ubuntu 14.04+, Debian 7 and RedHat/CentOS 7) PDFBox is recommended as this is more reliable and robust, (i.e. it is less likely for a coversheet task to fail or take up a lot or resources for a long period of time).  Using PDFBox or GhostScript on earlier versions of Linux may be difficult, it is likely any packages you may need to install may not be present by default or have different names because they are earlier versions.

====PDFBox====
Installing PDFBox requires Java to be installed.  As root or with sudo this can be done by running the appropriate following command:

* Debian 8 / Ubuntu 16.04 (and later):
  apt-get install openjdk-8-jdk

* Debian 7 / Ubuntu 14.04:
  apt-get install openjdk-7-jdk

* RedHat/Fedora/CentOS 7:
  yum install java-1.8.0-openjdk

Once installed download the latest pdf-app-2.x.x JAR file from https://pdfbox.apache.org/download.cgi#20x, e.g.:

 cd /opt/eprints3/archives/example/bin/tools/
 wget http://mirror.ox.ac.uk/sites/rsync.apache.org/pdfbox/2.0.24/pdfbox-app-2.0.24.jar

Now create the stitching Bash script that uses the PDFBox JAR file under the filename '''stitchPDFs''' in your archives bin/tools/ directory and add the following ''(provided by Jonathan Green / University of Nottingham)'':

 #/bin/bash
 dir=`dirname $0`
 
 if [ $# -eq 3 ]
 then
     # for compatibility with old eprints config we use the order: outputfile firstPDF secondPDF
     java -jar "$dir/pdfbox-app-2.0.2.jar" PDFMerger "$2" "$3" "$1"
 else
     echo "Usage: stitchPDFs <outputfile> <coversheet> <originalfile>"
 fi

Modify the permissions on this files so it can be executed:

 chmod a+x bin/tools/stitchPDFs


====GhostScript====
Installing GhostScript just requires a number of Linux packages.  As root or with sudo run the appropriate following command:
* Debian/Ubuntu:
  apt-get install ghostscript gsfonts gsfonts-other libgs9 libgs9-common
* RedHat/Fedora/CentOS:
  yum install ghostscript ghostscript-devel ghostscript-fonts ghostscript-gtk

If you installed EPrints using the DEB or RPM package, it is likely many if not all of these packages will already be installed.

Oracle (Sun) Java is required to make use of the Coversheets package work with Ghostcript.  By default this is not available in the standard package repositories of most Linux distributions.  Follow the instructions below (as the root user or with sudo) to install Oracle (Sun) Java on your Linux distribution:

* '''Debian/Ubuntu'''
  apt-get install python-software-properties
  add-apt-repository ppa:webupd8team/java
  apt-get update
  apt-get install oracle-java8-installer
* When prompted agree to the license agreement.


* '''RedHat/Fedora/CentOS'''
** Go to http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html and agree to the licence conditions.
** Download the appropriate .rpm package (i.e. i586 or x64) for you system architecture.
** Install the RPM from the command line, (substitute for '''<version>''' and '''<arch>''' based on the filename of the RPM you actually downloaded):
  rpm -Uvh jdk-8u<version>-linux-<arch>.rpm