Common Knowledge

Awards

Contents and Purpose

This is a feed of awards information for works.

Example

<commonknowledge>
	<item>
		<key>4-41004604-eng</key>
		<language>English</language>
		<type>bookaward</type>
		<text>Australian Prime Minister's Literary Award</text>
		<status>1</status>
		<descriptionlist>
			<description>
				<language>eng</language>
				<text>
					The Australian Prime Minister's Literary Awards 
					(PMLA) were announced at the end of 2007 by the
					incoming Rudd Ministry following the 2007 election.
					They are administered by the Minister for the 
					Arts. The awards were designed as "a new initiative
					celebrating the contribution of Australian 
					literature to the nation's cultural and intellectual 
					life." The awards are held annually and provide a
					tax-free prize of A$100,000 in each category, making
					it Australia's richest literary award in total, and 
					among the richest literary prizes in the world. The 
					award is given in the four categories of fiction, 
					non-fiction, young adult and children's fiction, as 
					selected by three judging panels. "The awards are 
					open to works written by Australian citizens and 
					permanent residents. Authors, publishers and 
					literary agents are eligible to enter works, first
					published in the calendar year prior to the awards."
				</text>
			</description>
		</descriptionlist>
		<worklist>
			<work order="2012">
				<workcode>11833546</workcode>
				<text>
				Australian Prime Minister's Literary Award (Australian History, 2012)
				</text>
				<displaytext>
				Australian Prime Minister's Literary Award<br>
				</displaytext>
				<position>
				Australian History, 2012
				</position>
				<position_simple>2012</position_simple>
				<order>2012</order>
			</work>
			...
		</worklist>
	</item>
</commonknowledge>

Elements and Attributes

Note

How members work the position and order elements deserves some exploration.

All ordering is done with the material in the parentheses. Usually that's simple, like

<text>A Sleuthing Sisters Mystery (Book 1)</text>

which becomes

<displaytext>A Sleuthing Sisters Mystery</displaytext></p>
<position>Book 1</position></p>
<position_simple>1</position_simple></p>

Other times members use a pipe to separate the "displayed" or "human readable" position from the way it should be ordered. In the case of

<text>A Sleuthing Sisters Mystery (9|Omnibus 1 - 3)</text>

members have decided to sort the omnibus to the end of the list, position 9.

<displaytext>A Sleuthing Sisters Mystery</displaytext></p>
<position>Omnibus 1 - 3</position></p>
<position_simple>Omnibus 1 - 3</position_simple></p>
<order>0009</order></p>

There are too many possible series positions and relationships to make a hard rule, but members generally sort series by their order, with omnibuses and box sets at the end.

Characters

Contents and Purpose

This is a feed of character information for works.

The format of the characters feed is identical to that of the "Award" feed.

Example

<commonknowledge>
	<item>
		<key>3-6832160-eng</key>
		<language>English</language>
		<type>characters</type>
		<text>"Bird Eye" Bob</text>
		<status>0</status>
		<worklist>
			<work order="0001">
				<workcode>5645151</workcode>
				<text>"Bird Eye" Bob</text>
				<displaytext>"Bird Eye" Bob</displaytext>
				<order>0001</order>
			</work>
		</worklist>
	</item>
</commonknowledge>

Places

Contents and Purpose

This is a feed of place information for works.

The format of the places feed is identical to that of the "Award" feed, except that places never have descriptions.

Example

<commonknowledge>
	<item>
		<key>2-16962475-eng</key>
		<language>English</language>
		<type>places</type>
		<text>Avonlea</text>
		<status>0</status>
		<worklist>
			<work order="0001">
				<workcode>8182</workcode>
				<text>Avonlea</text>
				<displaytext>Avonlea</displaytext>
				<order>0001</order>
			</work>
			...
		</worklist>
	</item>
</commonknowledge>

Quotes

Contents and Purpose

Contains all quotes from works entered by users/members. Each <work> contains one or more <quote> tags.

Quotes are of three types—first words, last words or "words from somewhere in the middle." All three types may repeat—even first and last words—as members will sometimes provide first words from both the introduction and the main text, etc.

Example

<worktoquotes>
	<work workcode="39">
		<quote>
			<type>firstwords</type>
			<langcode>eng</langcode>
			<language>English</language>
			<text>
				<![CDATA[
				There was once a Velveteen Rabbit, and in the beginning 
				he was really splendid.
				]]>
			</text>
		</quote>
		<quote>
			<type>quotation</type>
			<langcode>eng</langcode>
			<language>English</language>
			<text>
				<![CDATA[
				When a child loves you for a long, long time, not just 
				to play with, but REALLY loves you, then you become Real.
				]]>
			</text>
		</quote>
		<quote>
			<type>lastwords</type>
			<langcode>eng</langcode>
			<language>English</language>
			<text>
				<![CDATA[
				But he never knew that it really was his own Bunny, 
				come back to look at the child who had first helped him 
				to be Real.
				]]>
			</text>
		</quote>
	</work>
</worktoquotes>

Elements and Attributes