DSpace/DSpace — pull request #678 by peterdietz (2014-10-05 03:56:47+00:00)
Title: DS-2175 PDF Citation Coverpage

https://jira.duraspace.org/browse/DS-2175 - Generate citation PDF with cover page

Adds the ability to generate a cover page for a PDF, which has information about your institution / repository, as well as choosing metadata fields to be added to the cover page. For UI connection, I've built this for XMLUI.

This work was sponsored by [The Ohio State University Libraries](http://library.osu.edu/)
![osu-universitylibraries](https://cloud.githubusercontent.com/assets/58014/4421119/ca6f5c9a-4580-11e4-92b9-88c48fe0550e.png)

I had built this feature when I was at Ohio State, see wiki: (https://github.com/osulibraries/DSpace/wiki/Citation-Cover-Page), the primary changes with this version is that this version allows for configurable text and metadata fields on the cover page. Additionally, the OSU version used iTextPDF which is licensed AGPL (incompatible with DSpace license), so I have built this page generator using Apache PDFBox, so there will be some minor appearance differences.

Here's a screenshot
![screen shot 2014-10-04 at 11 28 21 pm](https://cloud.githubusercontent.com/assets/58014/4517553/775035c0-4c42-11e4-9425-bc07a75f416d.png)

In a new config file config/modules/disseminate-citation.cfg, you can enable this PDF Coverpage feature globally, to specific collections or specific communities. You can also choose whether the citation page goes on as the first page, or the last page of the PDF. Also, if you are logged in as the admin, you will not get the citation page, you get the original PDF.

The configs for choosing which metadata fields appear has a the ability to include a horizontal line, use `_line_` to specify where the line goes.

fields=dc.date.issued,dc.title,dc.creator,dc.contributor.author,dc.publisher,_line_,dc.identifier.citation,dc.identifier.uri

One minor sidenote: On my OSX development machine, when I ran this new feature, the Java app / org.apache.catalina.startup.Bootstrap shows up in my dock/application tray. I've changed my tomcat bin/setenv.sh to be headless, and it no longer appears.

CATALINA_OPTS=-Djava.awt.headless=true

Also, this previously had been checked against the Google / Google Scholar indexing guidelines for what should appear on a PDF, for them to scoop/sniff/auto-detect. i.e. Item Title is largest font size, Author is next lower size.