SUNScholar/Media Filters/4.X
Back to Media Filters
Please note: This is an untested procedure. It is a work in progress.
Contents
Step 1 - Login to the server
http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu/S01
Step 2 - Install the Ubuntu software packages
Type the following:
sudo apt-get install xpdf poppler-utils libjai-core-java libjai-imageio-core-java
Step 3 - Configuration
Step 3A
First, be sure there is a value for thumbnail.maxwidth and that it corresponds to the size you want for preview images for the UI.
Edit the "dspace.cfg" file.
nano /home/dspace/source/config/dspace.cfg
Search for the following and modify.
# maximum width and height of generated thumbnails thumbnail.maxwidth = 80 thumbnail.maxheight = 80
Step 3B
Now, add the absolute paths to the XPDF tools you installed.
See example below.
xpdf.path.pdftotext = /usr/bin/pdftotext xpdf.path.pdftoppm = /usr/bin/pdftoppm xpdf.path.pdfinfo = /usr/bin/pdfinfo
Step 3C
Add the filter plugins.
filter.plugins = \
PDF Text Extractor, \
PDF Thumbnail, \
HTML Text Extractor, \
Word Text Extractor, \
JPEG Thumbnail, \
Branded Preview JPEG
Step 3D
Change the MediaFilter plugin configuration to remove the old "org.dspace.app.mediafilter.PDFFilter" and add the new filters "org.dspace.app.mediafilter.XPDF2Text = PDF Text Extractor" and "org.dspace.app.mediafilter.XPDF2Thumbnail = PDF Thumbnail".
plugin.named.org.dspace.app.mediafilter.FormatFilter = \ org.dspace.app.mediafilter.XPDF2Text = PDF Text Extractor, \ org.dspace.app.mediafilter.XPDF2Thumbnail = PDF Thumbnail, \ org.dspace.app.mediafilter.HTMLFilter = HTML Text Extractor, \ org.dspace.app.mediafilter.WordFilter = Word Text Extractor, \ org.dspace.app.mediafilter.JPEGFilter = JPEG Thumbnail, \ org.dspace.app.mediafilter.BrandedPreviewJPEGFilter = Branded Preview JPEG
Step 3E
Then replace "filter.org.dspace.app.mediafilter.PDFFilter.inputFormats = Adobe PDF" with the following:
filter.org.dspace.app.mediafilter.XPDF2Thumbnail.inputFormats = Adobe PDF filter.org.dspace.app.mediafilter.XPDF2Text.inputFormats = Adobe PDF
Step 4 - Build and Install
Perform the following as the "dspace" user.
To build, type the following:
cd /home/dspace/source
mvn -Pxpdf-mediafilter-support package
To install, type the following: (Replace XXX with your DSpace version number)
cd /home/dspace/source/dspace/target/dspace-XXX-build
ant update
ant clean_backups