Quickstart:Customise EPrints

This page assumes you have completed the previous pages in the Quickstart Guide.

What does Customise Mean in EPrints?

There are lots of ways you may want to customise EPrints, this page aims to help you understand what those ways are, and direct you to resources to help you achieve those changes.

Concepts

When changing your EPrints system, there are a few concepts its helpful to be aware of before you begin.

Archive

Your Archive is the directory created in /opt/eprints3/archives/. This holds your configuration and files that override default functionality as well as the physical location of content stored in the repository.

Phrases

Text in EPrints is designed to be customisable by admin users. To achieve this, placeholder references are included in templates which then load the content entered by an admin.

Phrases have various purposes. One is to ensure consistent use of terminology throughout the archive. It also essential for supporting multi-language archives. They are used for defining all metadata field names and their help texts.

A prominent example of a phrase is an archive's name which is appears in the archive directory's cfg/lang/en/phrases/archive_name.xml, as follows:

<epp:phrase id="archive_name">Example Archive</epp:phrase>

Citations

In EPrints repository software, a citation means something slightly different from what it means in research publication.

EPrints has files which describe how to generate the text string, not just for eprints records but also other data objects, which we refer to as 'Citation Style Files' (Citations). A data object may have different citation files for different purposes and each object may have different citation files. These files can be found under lib/citations/, flavours/pub_lib/citations/ and the archive's cfg/citations/ directory.

See here for more information about the citation formats.

Site Look and Feel

To make an EPrints Repository feel like your own, you will want to change the look and feel of different parts of the site, below we detail where different parts are controlled and link out to more in depth guides on how to achieve these customisations.

Templates

Site Templates

EPrints has 'Global' templates used to wrap page content, generally these contain your header and footer and little else (you can of course add anything you want!). There is one used for public facing pages, and one for back end pages giving the option for a different interface for admin actions. Often these two templates are identical, even symlinking one to the other.

Both templates can be found here:

/opt/eprints3/archives/ARCHIVE_ID/cfg/lang/en/templates/

(make sure to replace ARCHIVE_ID with your archive name, the name of the directory you created in /opt/eprints3/archives/)

(if they're not, copy them from /opt/eprints3/lib/templates/ into the directory above (which you may need to create))

File Names

The public template is default.xml.

The back end template is default_internal.xml.

Find Out More

You can find out more in our templating guide, Branding with Confidence