Contributor list
From the Open Siddur Project Development Wiki
|
A single file is used to track the names and handles of contributors. The contributor list is a special support file. Its base URI is guaranteed to be http://jewishliturgy.org/base/text/contributors . The file has a header and must be permissively licensed. It also has a special support division, a tei:div[@type='contributors']. This section includes a single tei:list, containing tei:item elements.
The contributor list is considered public data. Please consider that when submitting information to the project.
Each tei:item element referring to an individual contributor:
- MUST be identified by an @xml:id attribute that is used in order to reference the contributor in all responsibility declarations.
- MUST contain as many tei:roleName, tei:forename, tei:surname, and tei:genName elements as are required to fully specify the contributor's name. If the name does not fit a roleName, forename+, surname, genName pattern, then the generic tei:name MAY be used instead.
- MAY contain a single tei:ptr[@type='openid'] element, whose @target attribute refers to the URI of the contributor's OpenID. The OpenID uniquely identifies each contributor, and it is an error for two contributors to have the same OpenID.
- MAY contain one or more tei:affiliation elements, each containing a tei:ptr to a single organization in the contributor list.
- MAY contain additional elements that help contact or identify the contributor and that are allowed in a tei:item context. Any use of these elements is optional.
Each tei:item element referring to an organizational contributor:
- MUST contain a tei:orgName element, identifying the name of the organization
- SHOULD contain a tei:email element, specifying a contact address for the organization, especially if the organization has contributed its collective works.
- MAY contain one tei:ptr[@type='url'] to the organization's website.
- MAY contain a tei:address element, specifying a physical contact address for the organization
- MAY contain additional elements that help contact or identify the contributor and that are allowed in a tei:item context. Any use of these elements is optional.
- Organizational contributors are separately linked to individuals (via tei:affiliation/tei:ptr), and SHOULD NOT be the targets of responsibility pointers UNLESS the contributed work is a collective work of the organization.
A new individual contributor is added to the list at his/her first contribution. A new organizational contributor is added upon the organization's first contribution or an associated individual's first contribution.
It is recommended that email contact addresses be kept for each contributor. Despamming may be applied to the addresses with the following substitutions: " DOT " yields ".". " AT " yields "@".
Example
The example is a list with a single individual contributor and a single organizational contributor:
<tei:div type="contributors"> <tei:list> <tei:item xml:id="efraim.feinstein"> <tei:forename>Efraim</tei:forename> <tei:surname>Feinstein</tei:surname> <tei:email>efraim DOT feinstein AT gmail DOT com</tei:email> <tei:affiliation><tei:ptr target="#university.of.hard.knocks"/></tei:affiliation> </tei:item> <tei:item xml:id="university.of.hard.knocks"> <tei:orgName>University of Hard Knocks</tei:orgName> <tei:email>admin@hardknocks.edu</tei:email> <tei:ptr type='url' target="http://hardknocks.edu" /> </tei:item> </tei:list> </tei:div>
