citation-strawman-01 - Revision history

TobyInk: MFO, clarifications, allow pub to be an adr.

2008-08-14T07:43:41Z

MFO, clarifications, allow pub to be an adr.

TobyInk: /* Common Properties */ Add 'format' (part of the DC KEV) instead of 'genre'. Better than 'genre' because it can be a common property.

2008-08-13T13:40:26Z

Common Properties: Add 'format' (part of the DC KEV) instead of 'genre'. Better than 'genre' because it can be a common property.

← Older revision		Revision as of 13:40, 13 August 2008
Line 97:		Line 97:
	** ''date'' ? (ISO 8601) — date published		** ''date'' ? (ISO 8601) — date published
	** ''description'' ? — a description of the item being cited, or the reason it is being cited		** ''description'' ? — a description of the item being cited, or the reason it is being cited
			** ''format'' ? — the type of resource being cited. (e.g. 'book', 'article', 'discussion')
	** ''identifier'' * — an identifier for the item being cited		** ''identifier'' * — an identifier for the item being cited
	** ''language'' ? (ISO 639-1 or ISO 639-2) — the language of the item being cited. (Not to be confused with the language of the citation itself, which should be indicated using standard markup — <code>lang</code> or <code>xml:lang</code>)		** ''language'' ? (ISO 639-1 or ISO 639-2) — the language of the item being cited. (Not to be confused with the language of the citation itself, which should be indicated using standard markup — <code>lang</code> or <code>xml:lang</code>)

TobyInk: /* References */ Add KEV documents which I've been using lately

2008-08-13T13:25:34Z

References: Add KEV documents which I've been using lately

← Older revision		Revision as of 13:25, 13 August 2008
Line 310:		Line 310:
	= References =		= References =

	* <cite class="h3988" id="~~ocoins~~-journal"><span class="jtitle">OCOinS.info</span>: <span class="atitle">[http://ocoins.info/cobg.html Brief guide to Implementing OpenURL 1.0 Context Object for Journal Articles]</span></cite>		* <cite class="h3988" id="ref_kev-book"><span class="jtitle">OpenURL Framework Repository</span>: <span class="atitle">[http://alcme.oclc.org/openurl/servlet/OAIHandler/extension?verb=GetMetadata&metadataPrefix=mtx&identifier=info:ofi/fmt:kev:mtx:book KEV Format: Book]</span></cite>
	* <cite class="h3988" id="~~ocoins~~-book"><span class="jtitle">OCOinS.info</span>: <span class="atitle">[http://ocoins.info/cobgbook.html Brief guide to Implementing OpenURL 1.0 Context Object for Books]</span></cite>		* <cite class="h3988" id="ref_kev-journal"><span class="jtitle">OpenURL Framework Repository</span>: <span class="atitle">[http://alcme.oclc.org/openurl/servlet/OAIHandler/extension?verb=GetMetadata&metadataPrefix=mtx&identifier=info:ofi/fmt:kev:mtx:journal KEV Format: Journal]</span></cite>
			* <cite class="h3988" id="ref_kev-dissertation"><span class="jtitle">OpenURL Framework Repository</span>: <span class="atitle">[http://alcme.oclc.org/openurl/servlet/OAIHandler/extension?verb=GetMetadata&metadataPrefix=mtx&identifier=info:ofi/fmt:kev:mtx:dissertation KEV Format: Dissertation]</span></cite>
			* <cite class="h3988" id="ref_kev-patent"><span class="jtitle">OpenURL Framework Repository</span>: <span class="atitle">[http://alcme.oclc.org/openurl/servlet/OAIHandler/extension?verb=GetMetadata&metadataPrefix=mtx&identifier=info:ofi/fmt:kev:mtx:patent KEV Format: Patent]</span></cite>
			* <cite class="h3988" id="ref_kev-dc"><span class="jtitle">OpenURL Framework Repository</span>: <span class="atitle">[http://alcme.oclc.org/openurl/servlet/OAIHandler/extension?verb=GetMetadata&metadataPrefix=mtx&identifier=info:ofi/fmt:kev:mtx:dc KEV Format: Dublin Core]</span></cite>
			* <cite class="h3988" id="ref_ocoins-journal"><span class="jtitle">OCOinS.info</span>: <span class="atitle">[http://ocoins.info/cobg.html Brief guide to Implementing OpenURL 1.0 Context Object for Journal Articles]</span></cite>
			* <cite class="h3988" id="ref_ocoins-book"><span class="jtitle">OCOinS.info</span>: <span class="atitle">[http://ocoins.info/cobgbook.html Brief guide to Implementing OpenURL 1.0 Context Object for Books]</span></cite>

	= Related Pages =		= Related Pages =

	{{citation-related-pages}}		{{citation-related-pages}}

TobyInk: /* A Book in a Bibliography */ use the new identifier property to mark up an author-specified identifier

2008-08-13T12:39:25Z

A Book in a Bibliography: use the new identifier property to mark up an author-specified identifier

← Older revision		Revision as of 12:39, 13 August 2008
Line 282:		Line 282:
	<ul>		<ul>
	<li>		<li>
	~~<dfn>[FPC]</dfn>:~~
	<cite class="h3988" id="ref-fpc">		<cite class="h3988" id="ref-fpc">
			[<span class="identifier">FPC</span>]:
	<i class="btitle">French Provincial Cooking</i>,		<i class="btitle">French Provincial Cooking</i>,
	<span class="au vcard">		<span class="au vcard">

TobyInk: /* `identifier` and `url` */ basly nested code

2008-08-13T11:26:00Z

<code>identifier</code> and <code>url</code>: basly nested code

← Older revision		Revision as of 11:26, 13 August 2008
Line 189:		Line 189:
	<span class="value">12345</span>		<span class="value">12345</span>
	</span>]		</span>]
	</~~pre~~></nowiki>		</cite></nowiki></pre>

	As an optimisation, the type and value can both be implied when the identifier is a link matching one of the following patterns:		As an optimisation, the type and value can both be implied when the identifier is a link matching one of the following patterns:

TobyInk: /* `identifier` and `url` */ identifier type == stitle semantic

2008-08-13T11:25:12Z

<code>identifier</code> and <code>url</code>: identifier type == stitle semantic

← Older revision		Revision as of 11:25, 13 August 2008
Line 180:		Line 180:
	* [http://en.wikipedia.org/wiki/Serial_Item_and_Contribution_Identifier SICI]		* [http://en.wikipedia.org/wiki/Serial_Item_and_Contribution_Identifier SICI]

	The <code>identifier</code> property may be used with a null type to indicate an author-defined identifier or an identifier from a scheme not included in this specification.		The <code>identifier</code> property may be used with a null type to indicate an author-defined identifier or an identifier from a scheme not included in this specification. Lastly, if a journal citation has an <code>stitle</code> property ''and'' identifier type match's the citation's short title, then the identifier is assumed to be from a scheme specific to that journal. (If the value is also numeric, then this is an equivalent semantic to OpenURL's "artnum".) For example:

			<pre><nowiki><cite class="h3988">
			<span class="jtitle">Journal of Rat Studies</span>:
			<span class="atitle">Rats and their Bretheren</span>.
			[<span class="identifier">
			<span class="stitle type">JRat</span>
			<span class="value">12345</span>
			</span>]
			</pre></nowiki>

	As an optimisation, the type and value can both be implied when the identifier is a link matching one of the following patterns:		As an optimisation, the type and value can both be implied when the identifier is a link matching one of the following patterns:

TobyInk: Ditch genre (for now). Most of the time it can be guessed. But it might make an appearance, as some people do seem to (usually through an icon) differentiate between books, journals, etc.

2008-08-13T10:26:31Z

Ditch genre (for now). Most of the time it can be guessed. But it might make an appearance, as some people do seem to (usually through an icon) differentiate between books, journals, etc.

← Older revision		Revision as of 10:26, 13 August 2008
Line 58:		Line 58:
	** '''btitle''' {1} — book title		** '''btitle''' {1} — book title
	** ''edition'' ?		** ''edition'' ?
	** ''genre'' ? [book\|bookitem\|proceeding\|conference\|report\|document\|unknown] — "book" is the default, but "bookitem" is implied if 'atitle' or 'pages' is present.
	** ''pub'' ? (hCard\|text) — publisher		** ''pub'' ? (hCard\|text) — publisher
	** ''series'' ? — title of the series in which the book was published		** ''series'' ? — title of the series in which the book was published
Line 68:		Line 67:

	* '''h3988''' {1}		* '''h3988''' {1}
	** ''genre'' ? [issue\|article\|proceeding\|conference\|preprint\|unknown] — "issue" is the default, but "article" is implied if 'atitle' or 'pages' is present.
	** ''issue'' ? — issue of the journal, often numeric		** ''issue'' ? — issue of the journal, often numeric
	** ''jtitle'' ? — journal title		** ''jtitle'' ? — journal title

TobyInk: /* A Book in a Bibliography */ use rel=cite and votelinks

2008-08-13T10:19:25Z

A Book in a Bibliography: use rel=cite and votelinks

← Older revision		Revision as of 10:19, 13 August 2008
Line 298:		Line 298:
	<pre><nowiki><p>		<pre><nowiki><p>
	To cook Filets de Macquereaux a la Tomate, you need to first coat the mackeral		To cook Filets de Macquereaux a la Tomate, you need to first coat the mackeral
	with flour [<a rel="~~footnote~~" id="#ref-fpc">FPC</a>].		with flour [<a rel="cite" id="#ref-fpc" rev="vote-for">FPC</a>].
	</p></nowiki></pre>		</p></nowiki></pre>

TobyInk: /* Footnotes */ ugly, ugly link

2008-08-13T10:18:20Z

Footnotes: ugly, ugly link

← Older revision		Revision as of 10:18, 13 August 2008
Line 108:		Line 108:
	== Footnotes ==		== Footnotes ==

	Additionally, this strawman microformat uses the existing (see [http://www.w3.org/TR/rdfa-syntax/#relValues RDFa], [http://www.w3.org/TR/xhtml2/mod-metaAttributes.html#adef_metaAttributes_rel XHTML 2.0], [[distributed-conversation-brainstorming#rel.3D.22cite.22_.2F_rev.3D.22cite.22]], etc) [[rel]] value of "cite" for linking from article text to an h3988 citation elsewhere on the page. (e.g. in footnotes or a bibliography section).		Additionally, this strawman microformat uses the existing (see [http://www.w3.org/TR/rdfa-syntax/#relValues RDFa], [http://www.w3.org/TR/xhtml2/mod-metaAttributes.html#adef_metaAttributes_rel XHTML 2.0], [[distributed-conversation-brainstorming#rel.3D.22cite.22_.2F_rev.3D.22cite.22\|distributed conversation brainstorming]], etc) [[rel]] value of "cite" for linking from article text to an h3988 citation elsewhere on the page. (e.g. in footnotes or a bibliography section).

	Parsers {{may}} follow rel=cite links to other pages, but are not required to. Authors should be aware that parsers might not follow off-page footnote links. On-page references are generally preferred.		Parsers {{may}} follow rel=cite links to other pages, but are not required to. Authors should be aware that parsers might not follow off-page footnote links. On-page references are generally preferred.

TobyInk: /* Footnotes */ rel=cite instead of rel=footnote. Footnote is presentational.

2008-08-13T10:17:33Z

Footnotes: rel=cite instead of rel=footnote. Footnote is presentational.

← Older revision		Revision as of 10:17, 13 August 2008
Line 108:		Line 108:
	== Footnotes ==		== Footnotes ==

	Additionally, this strawman microformat ~~defines a~~ [[rel]] value of "~~footnote~~" for linking from article text to an h3988 citation elsewhere on the page. (e.g. in footnotes or a bibliography section).		Additionally, this strawman microformat uses the existing (see [http://www.w3.org/TR/rdfa-syntax/#relValues RDFa], [http://www.w3.org/TR/xhtml2/mod-metaAttributes.html#adef_metaAttributes_rel XHTML 2.0], [[distributed-conversation-brainstorming#rel.3D.22cite.22_.2F_rev.3D.22cite.22]], etc) [[rel]] value of "cite" for linking from article text to an h3988 citation elsewhere on the page. (e.g. in footnotes or a bibliography section).

	Parsers {{may}} follow rel=~~footnote~~ links to other pages, but are not required to. Authors should be aware that parsers might not follow off-page footnote links. On-page references are generally preferred.		Parsers {{may}} follow rel=cite links to other pages, but are not required to. Authors should be aware that parsers might not follow off-page footnote links. On-page references are generally preferred.

	When linking to a citation by ID attribute, the ID attribute should be on the h3988 citation itself, and not on a parent or ancestor node. e.g.:		When linking to a citation by ID attribute, the ID attribute should be on the h3988 citation itself, and not on a parent or ancestor node. e.g.: