Authority files (keywords)

To each <category> in the taxonomy corresponds a file in the authority-files repository.

In the Authority-Files repository, there are currently a series of files mainly generated from lists which have nothing but a title and an ID. Each of them refers to one value.

For example, the taxonomy contains the following category of keywords describing persons:


                <category>
                    <desc>Person Types</desc>
                    <category>
                        <catDesc>saint</catDesc>
                    </category>
                    <category>
                        <catDesc>biblical</catDesc>
                    </category>
                    <category>
                        <catDesc>prophet</catDesc>
                    </category>
                    <category>
                        <catDesc>angel</catDesc>
                    </category>
                    <category>
                        <catDesc>martyr</catDesc>
                    </category>
                </category>
            

Example 1

For each of the values listed in children <category>s of the first "Person Types" <category>, there should be therefore a corresponding record in the Authority-Files repository, see, for example, saint.

Despite their usual brevity, these records are complete records which can be edited and developed and whose IDs can be used in all places in which the IDs of records of other entities are used, for example, in relations and <ref>.

Please remember to use the same name used in the taxonomy.xml file also for the filename and the ID.

An example of a more developed description inside an authority file from AT1003Arrest:


                <abstract>
                    <p>A miniature showing <persName ref="PRS5684JesusCh">Jesus</persName> being arrested by the guards of the Temple,
                        (<ref cRef="urn:cts:greekLit:tlg0031.tlg001.perseus-grc1:26.50">Mt 26:50</ref>;
                        <ref cRef="urn:cts:greekLit:tlg0031.tlg002.perseus-grc1:14.43"> Mk 14:43</ref>;
                        <ref cRef="urn:cts:greekLit:tlg0031.tlg003.perseus-grc1:22.52">Lk 22:52</ref>;
                        <ref cRef="urn:cts:greekLit:tlg0031.tlg004.perseus-grc1:18.3">Jn 18:3</ref>),
                        the scene may feature additional details such as The Kiss of Judas, or
                        <persName ref="PRS7805Peter">Peter</persName> cutting off the ear of  Malchus
                        (<ref cRef="urn:cts:greekLit:tlg0031.tlg001.perseus-grc1:26.50">Mt 26:51</ref>;
                        <ref cRef="urn:cts:greekLit:tlg0031.tlg002.perseus-grc1:14.47"> Mk 14:47</ref>;
                        <ref cRef="urn:cts:greekLit:tlg0031.tlg003.perseus-grc1:22.50">Lk 22:50</ref>
                        <ref cRef="urn:cts:greekLit:tlg0031.tlg004.perseus-grc1:18.10">Jn 18:10</ref>).
                    </p>
                </abstract>
            

Example 2

These authority files for each keyword can also receive keywords and any further content, similarly to all other records. A special use case is, for example, that of Art Themes.

To create a new authority file, see the general new entry creation page and remember that each authority file needs to have a corresponding entry in the corresponding <category> in the taxonomy, which you will have to add manually if you create a new authority file.

This page is referred to in the following pages

Revisions of this page

  • Pietro Maria Liuzzo on 2018-04-30: first version of guidelines from Wiki
  • Dorothea Reule on 2019-06-24: Added examples and developed