Script: references-element
The purpose of a references element is to collect all (or many) references that you intend to use
in your project in a file.
It may simplify maintainance considerably, and it opens for a systematic reference policy.
You may access the individual reference by PI
Ref
and you may produce reference lists by PI
RefList
.
You may even control any URI's in a reference by PI
ReferenceTest
.
The definitions-element may contain any number of references elements.
<references location=""/>
|
location(mandatory) |
An URI which is absolute or relative to the script anchor.
|
The legal elements in a reference are (in any order):
- title
- authors
- year
- chaptertitle
- journal
- editor
- place
- publisher
- pages
- isbn
- uri (with an optional attribute: dateread)
- text
- categories
Examples:
<references location="myrefs.xml"/>
A sample reference file:
<?xml version="1.0" encoding="UTF-8"?>
<reflist version="1.0">
<ref id="As we may think">
<uri dateread="14-03-20009">http://www.theatlantic.com/doc/194507/bush</uri>
<year>1945</year>
<title>As we may think</title>
<publisher>the Atlantic</publisher>
<authors>Bush,Vannevar</authors>
<categories>tec</categories>
</ref>
<ref id="Mindstorms">
<authors>Papert,Seymour</authors>
<publisher>Harvester Press</publisher>
<title>Mindstorms, Children Computers and Powerful Ideas</title>
<year>1980</year>
<isbn>0-85527-163-9</isbn>
<categories>ped</categories>
</ref>
<ref id="web2">
<title>Web 2.0</title>
<year>2005</year>
<uri dateread="14-03-20009">http://en.wikipedia.org/wiki/Web_2.0</uri>
</ref>
</reflist>
Reference files are validated according to this schema:
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="reflist">
<xs:complexType>
<xs:choice maxOccurs="unbounded">
<xs:element ref="ref" maxOccurs="unbounded"/>
</xs:choice>
<xs:attribute name="version" type="xs:decimal" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="ref">
<xs:complexType>
<xs:all>
<xs:element ref="title" minOccurs="0" maxOccurs="1"/>
<xs:element ref="authors" minOccurs="0" maxOccurs="1"/>
<xs:element ref="year" minOccurs="0" maxOccurs="1"/>
<xs:element ref="chaptertitle" minOccurs="0" maxOccurs="1"/>
<xs:element ref="journal" minOccurs="0" maxOccurs="1"/>
<xs:element ref="editor" minOccurs="0" maxOccurs="1"/>
<xs:element ref="place" minOccurs="0" maxOccurs="1"/>
<xs:element ref="publisher" minOccurs="0" maxOccurs="1"/>
<xs:element ref="pages" minOccurs="0" maxOccurs="1"/>
<xs:element ref="isbn" minOccurs="0" maxOccurs="1"/>
<xs:element ref="uri" minOccurs="0" maxOccurs="1"/>
<xs:element ref="text" minOccurs="0" maxOccurs="1"/>
<xs:element ref="categories" minOccurs="0" maxOccurs="1"/>
</xs:all>
<xs:attribute name="id" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
<!-- this is the definitions -->
<xs:element name="title" type="xs:string"/>
<xs:element name="authors" type="xs:string"/>
<xs:element name="year" type="xs:short"/>
<xs:element name="chaptertitle" type="xs:string"/>
<xs:element name="journal" type="xs:string"/>
<xs:element name="editor" type="xs:string"/>
<xs:element name="place" type="xs:string"/>
<xs:element name="publisher" type="xs:string"/>
<xs:element name="pages" type="xs:string"/>
<xs:element name="isbn" type="xs:string"/>
<xs:element name="uri">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attribute name="dateread" type="xs:string" use="optional"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="text" type="xs:string"/>
<xs:element name="categories" type="xs:string"/>
</xs:schema>
See
References
for a full description.