Bibliography
From Open Siddur Project Development Wiki
|
The global bibliography is a support file whose URI is http://jewishliturgy.org/base/text/bibliography . It contains a header and a support section, tei:div[@type='bibliography']. The division contains a single tei:listBibl element, which, in turn, contains a series of tei:biblStruct elements, which contain the bibliographic information of all the sources we copy or reference.
The contents of the tei:biblStruct elements are described in detail in a section of the TEI Guidelines, and no new extension elements are defined.
JLPTEI policy requires that each tei:biblStruct have a file-unique @xml:id that is used to reference the work.
Contents |
Forms of author/editor lists
Author and editor lists are stored as sequential tei:author or tei:editor elements, listed in the same order as the source. Each tei:author or tei:editor element contains exactly one name. The name should be separated under tei:forename, tei:surname, and tei:genName elements, if possible. If the same author's name is given in multiple languages, or a translation or transliteration of the name is required, use @xml:lang to indicate the languages of all versions of the author list. Assign the first an @xml:id. Each subsequent tei:author element must use @corresp pointed to the xml:id of the first tei:author. If multiple spellings are available in the source, the first one listed should be given priority, although there may be good reasons for exceptions.
Where a responsibility other than author or editor is required (such as "translator"), attribution lists may also include tei:respStmt elements of the form:
<tei:respStmt> <tei:resp>Special responsibility by</tei:resp> <tei:name>Person's name</tei:name> </tei:respStmt>
with similar qualifications on the form of the name.
Examples
Multiple author list:
<tei:author><tei:forname>Azriel</tei:forename> <tei:surname>Fasten</tei:surname></tei:author> <tei:author><tei:forname>Aharon</tei:forename> <tei:surname>Varady</tei:surname></tei:author>
Same author with translation:
<tei:author xml:lang="en" xml:id="auth1"><tei:forename>Efraim</tei:forename> <tei:surname>Feinstein</tei:surname></tei:author> <tei:author xml:lang="he" corresp="#auth1"><tei:forename>אפרים</tei:forename> <tei:surname>פיינשטיין</tei:surname></tei:author>
For editor lists, the same principles hold.
Forms of book titles
Titles are stored under the appropriate level. Article/chapter titles are stored as tei:analytic/tei:title, book titles under tei:monogr/tei:title, and series titles under tei:series/tei:title. Only two attribute values are supported for tei:title/@type, "main" (default) and "subtitle". Each title part may only contain one main title and one subtitle.
Translated and transliterated titles are handled exactly as transliterated and translated author and editor names.
tei:biblStruct forms for specific types of sources
Any irrelevant or nonexistent information may be omitted. Required information is marked "(REQ)", required where applicable is marked (RWA), recommended is marked (REC). All other information is optional. If the information is not available, the tag must be omitted. CAPITAL LETTERS and <!-- comments --> indicate sections to be filled in.
Whole Book
<tei:biblStruct xml:id="BOOK_ID"> <tei:monogr> <tei:author><!-- AUTHOR NAME (REQ), set to "Anonymous" or "Unknown" where applicable --></tei:author> <tei:editor><!-- EDITOR NAME (RWA) --></tei:editor> <tei:title><!-- TITLE (REQ) --></tei:title> <tei:edition><!-- EDITION (RWA) --></tei:edition> <tei:idno type="URL|ISSN|DOI|..."><!-- OPTIONAL IDENTIFIERS --></tei:idno> <tei:imprint> <tei:publisher><!-- REQ --></tei:publisher> <tei:pubPlace><!-- RWA --></tei:pubPlace> <tei:date><!-- REQ --></date> <tei:distributor><!-- DISTRIBUTOR IS REQUIRED FOR INTERNET SOURCES --> <tei:ref type="url" target="URL_OF_RESOURCE"><!-- NAME OF PROVIDER (RWA) --></tei:ref> <tei:date type="access"><!-- Access date for Internet resource (REC) --></tei:date> </tei:distributor> </tei:imprint> </tei:monogr> <tei:note type="copyright"> <!-- RWA ANNOTATION ABOUT SOURCES COPIED FROM UNDER LICENSE. MUST CONTAIN ALL COPYRIGHT INFORMATION AND NECESSARY LICENSE STATEMENTS --> </tei:note> <tei:note><!-- OPTIONAL ANNOTATION ABOUT THE USE OF THE RESOURCE --></tei:note> </tei:biblStruct>
The copyright notice is only required for sources from which we copy (and must indicate that the work is either in the public domain or is licensed for our use!). Bibliographic sources do not require the copyright note.
Named part of a book
If only part of the book will ever be used, the part should be included in the global bibliography. If a citation is made to part of a larger work in a specific place, the additions to the citation may be placed as additional elements inside a tei:bibl element at the point of reference. These additions may include tei:biblScope.
<tei:biblStruct xml:id="BOOK_ID"> <tei:analytic> <tei:author><!-- AUTHOR LIST FOR ARTICLE/CHAPTER, AS ABOVE (RWA) --></tei:author> <tei:editor><!-- EDITOR LIST FOR ARTICLE/CHAPTER, AS ABOVE (RWA) --></tei:editor> <tei:title><!-- TITLE(S) OF THE SECTION --></tei:title> </tei:analytic> <tei:monogr> <tei:author><!-- AUTHOR NAME (REQ), set to "Anonymous" or "Unknown" where applicable --></tei:author> <tei:editor><!-- EDITOR NAME (RWA) --></tei:editor> <tei:title><!-- TITLE (REQ) --></tei:title> <tei:edition><!-- EDITION (RWA) --></tei:edition> <tei:idno type="URL|ISSN|DOI|..."><!-- OPTIONAL IDENTIFIERS --></tei:idno> <tei:imprint> <tei:publisher><!-- REQ --></tei:publisher> <tei:pubPlace><!-- RWA --></tei:pubPlace> <tei:date><!-- REQ --></date> <tei:distributor><!-- DISTRIBUTOR IS REQUIRED FOR INTERNET SOURCES --> <tei:ref type="url" target="URL_OF_RESOURCE"><!-- NAME OF PROVIDER (RWA) --></tei:ref> <tei:date type="access"><!-- Access date for Internet resource (REC) --></tei:date> </tei:distributor> </tei:imprint> </tei:monogr> <tei:note type="copyright"> <!-- RWA ANNOTATION ABOUT SOURCES COPIED FROM UNDER LICENSE. MUST CONTAIN ALL COPYRIGHT INFORMATION AND NECESSARY LICENSE STATEMENTS --> </tei:note> <tei:note><!-- OPTIONAL ANNOTATION ABOUT THE USE OF THE RESOURCE --></tei:note> </tei:biblStruct>