Encoding of files conforming to the bibliolist template
General
The bibliolist template is used to create bibliographic references. In its normal use it holds references to the articles and books that the editors refer to in their annotation. It may also hold references to e.g. books or journals that are mentioned in the edited text.
Bibliolist files start with a header:
<?xml version="1.0" encoding="UTF-8"?>
<?editem template="bibliolist"?>
<?xml-model href="https://xmlschema.huygens.knaw.nl/editem-bibliolist.rng" type="application/xml" schematypens="http://relaxng.org/ns/structure/1.0"?>
<?xml-model href="https://xmlschema.huygens.knaw.nl/editem-bibliolist.rng" type="application/xml" schematypens="http://purl.oclc.org/dsdl/schematron"?>
The first line is the so-called XML declaration, used in all editem XML files. The second line declares that the file conforms to the editem bibliolist template. The third and fourth line declare that the file should conform to the editem-bibliolist.rng schema, interpreted both as a RNG schema (third line) and as a Schematron schema (fourth line).
Metadata
The teiHeader
must contain a teiHeader/fileDesc/titleStmt/title
element.
Other content is ignored.
Structure
The text/body
must consist of a head
, a number of optional paragraphs, and one or more listBibl
elements. The initial paragraphs can be used for explanatory remarks. The listBibl
elements may be nested. They contain bibl
elements that hold the individual bibliograhical descriptions.
Individual bibliographic references
The bibl
elements carry an xml:id
attribute that must be unique within the file. Projects are free in assigning those attributes. A common convention is someting along the line of Janssen2014
.
The bibl
elements must contain a label
element, to be used as heading in the online bibliography. Projects are free in chosing what to use for a label. A common convention is someting along the line of Janssen2014
.
The actual bibliographic description is in plain text, except for title
s and possibly some highlights (hi
) and ref
s.
The title
element carries the level
atribute to indicate the type of the publication. Its values are:
- a: for articles (there is no need for quotation marks round article titles. These are created by the publication software)
- j: for journals
- m: for monographs (books)
- s: for series
hi
is only used for special renderings, not for italicizing titles. ( That is handled by the publication software). Presently, the only supported value for the rend
attribute is ss
(superscript).
bibl
elements can refer to other bibl
elements using the ref
element. See the examples.
Examples
A book
<bibl xml:id="Adrichem1993">
<label>Adrichem-Ammerlaan 1993</label>
C.R.M. van Adrichem-Ammerlaan, <title level="m">Aan Hare
Majesteit de Koningin-Regentes der Nederlanden, enz. enz. enz.</title>
Amersfoort 1993.</bibl>
An article in a journal
<bibl xml:id="Blotkamp1990">
<label>Blotkamp 1990</label>
Carel Blotkamp, <title level="a">Charley Toorop over De Stijl</title>,
in <title level="j">Jong Holland</title> 6 (1990) 2, pp. 14-15.</bibl>
An article in a book
<bibl xml:id="Coppes2015">
<label>Coppes 2015</label>
Wietse Coppes, <title level="a">"I'm the Same Just
a Bit More Balanced, If I Don't Deceive Myself". A biographical sketch of Piet
Mondrian in the period 1909-12, based on the letters send to Aletta de
Iongh</title>, in <ref target="biblio.xml#Rooij2015">Rooij 2015</ref>, pp.
8-14.</bibl>
Notice how the reference to the volume in which the article is was published, uses a ref
element.