Editing Repository configuration (section)

==citations-''languageid''.xml==
The ciations file describes how to render an item (eprint/user/whatever) into a short piece of XHTML. Each citation has a "type". There are 3 kinds of citation:

; default citation : This is a very short description of the item. Usually "the title or failing that, the id". The type id is just the name of the dataset. eg. "eprint"
; type citation : These are richer descriptions which vary between type of eprint, user or document. The type id is dataset_type eg. eprint_preprint.
; other citation : Used by custom browse views. Any name you like.

The citation file contains a list of citation elements:


<code><nowiki>
 <ep:citation type="...">
</nowiki></code>
Each one may contain text and tags. The text may also include the names of fields in the record being rendered. These names should be between @ symbols. eg. @authors@ or @title@. These will be replaced with a rendered version of the value in that field. (if you need an actual @ symbol for some reason two @@ with nothing inside will be rendered as a single @).

Note. The @title@ style was introduced in EPrints 2.2. Before that this file used XML entities such as &title; but this caused problems and didn't solve any. Use of entities is still supported, but deprecated.

In addition you may use XHTML elements and the following elements in the eprints namespace. These elements are always removed but they control if their contents is kept or not. Conditional elements may be placed inside each other since v2.2.

; <tt> <ep:linkhere> </tt> : This element is replaced with an XHTML anchor linking to the item. If this citation is being rendered without a link then it is just removed (but not the contents).
; <tt> <ep:iflink> </tt> : The contents of this element are only preserved if we are rendering this citation as a link. Maybe an icon which you don't want if it's not a link.
; <tt> <ep:ifnotlink> </tt> : The opposite of iflink.
; <tt> <ep:ifset ref="fieldname"> </tt> : The contents of this element are only preserved if the field "fieldname" has a value.
; <tt> <ep:ifnotset ref="fieldname"> </tt> : The contents of this element are only preserved if the field "fieldname" does not have a value.
; <tt> <ep:ifmatch name="fieldname(s)" value="searchparam"> </tt> : This is the swiss army knife of the world of conditional rendering. It is also a bit complicated, and few people will need to use it. This actually works like a single search element. The attributes are:
;; name : This is the name of one or more fields, specified as in the search fields configuration. eg. "title/abstract"
;; value : This is a value to search for. Treated like the value entered in a search field.
;; merge (optional) : Can be ANY or ALL. Works like the match all? in a search form.
;; match (optional) : Can be IN, EQ, or EX. In, Equal or Exact. Exact on subjects means that subject, but not any below it in the heirarchy.
For example:

<code><nowiki>
 @year@<ep:ifmatch name="year" value="-1949"> 
 (approx)</ep:ifmatch>
</nowiki></code>

This will render (approx) after years before 1950. Neat eh?
; <tt><ep:ifnotmatch name="fieldname(s)" value="searchparam"> </tt> : Like ifmatch but only includes the values inside if the search does not match.