Editing Files/Coverpage / CoverLatex plugins (section)

== Coverpage / CoverLatex plugins ==

This is a plugin that prepends coverpages to documents. It uses a
convert plugin to generate the actual pages.

The shipped implementation (<tt>CoverLatex</tt>) uses a citation XML template
to generate LaTeX source, compiles that into a PDF coverpage and
prepends it using <tt>pdftk</tt>.

Coverpage versions of the documents are updated and saved when
documents are requested: The plugin uses the new
<tt>EP_TRIGGER_DOC_URL_REWRITE</tt> trigger introduced in EPrints
3.2.1. Coverpage documents are refreshed when the corresponding
document or when the associated eprint metadata changes.

The plugin also integrates into the upload workflow: If a PDF is
encrypted and thus prepending a coverpage isn't possible, a warning is
printed. Besides the "coverpage" metafield of the document is set to
<tt>FALSE</tt> to indicate that future attempts to generate a coverpage are
unnecessary.

It uses document relations (<tt>isCoverPageVersionOf</tt>, <tt>hasCoverPageVersion</tt>)
to connect the original document to its coverpage version.  Discovery
of an appropriate conversion plugin is done via the "<tt>can_convert</tt>"
method of the Convert module.