citation-examples: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
Line 151: Line 151:


== W3C XHTML Spec Example ==
== W3C XHTML Spec Example ==
<pre><nowiki>
<h1><a name="refs" id="refs">E.</a> References</h1>


<p><strong>This appendix is informative.</strong></p>
* refID
* URL
* title
* subtitle
* part (1 of X)
* journal
* authors
* pubdate
* language
* ISO/IEC ID
* RFC ID


<dl>
<dt><a name="ref-css2" id="ref-css2"><strong>[CSS2]</strong></a></dt>
<dd>"<cite><a href="http://www.w3.org/TR/1998/REC-CSS2-19980512">Cascading Style Sheets, level 2 (CSS2) Specification</a></cite>", B. Bos, H. W. Lie, C. Lilley, I. Jacobs, 12 May 1998.<br />
<a href="http://www.w3.org/TR/REC-CSS2">Latest version</a> available at: http://www.w3.org/TR/REC-CSS2</dd>
<dt><a name="ref-dom" id="ref-dom"><strong>[DOM]</strong></a></dt>
<dd>"<cite><a href="http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001">Document Object Model (DOM) Level 1 Specification</a></cite>", Lauren Wood <em lang="lt" xml:lang="lt">et al.</em>, 1 October
1998.<br />
<a href="http://www.w3.org/TR/REC-DOM-Level-1">Latest version</a> available at: http://www.w3.org/TR/REC-DOM-Level-1</dd>
<dt><a name="ref-dom2" id="ref-dom2"><strong>[DOM2]</strong></a></dt>
<dd>"<cite><a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113">Document Object Model (DOM) Level 2 Core Specification</a></cite>", A. Le&#160;Hors, <em lang="lt" xml:lang="lt">et
al.</em>, 13 November 2000.<br />
<a href="http://www.w3.org/TR/DOM-Level-2-Core">Latest version</a> available at: http://www.w3.org/TR/DOM-Level-2-Core</dd>
<dt><a name="ref-html4" id="ref-html4"><strong>[HTML]</strong></a></dt>
<dd>"<cite><a href="http://www.w3.org/TR/1999/REC-html401-19991224">HTML 4.01 Specification</a></cite>", D. Raggett, A. Le&#160;Hors, I. Jacobs, 24 December 1999.<br />
<a href="http://www.w3.org/TR/html401">Latest version</a> available at: http://www.w3.org/TR/html401</dd>
<dt><a name="ref-posix.1" id="ref-posix.1"><strong>[POSIX.1]</strong></a></dt>
<dd>"<cite>ISO/IEC 9945-1:1990 Information Technology - Portable Operating System Interface (POSIX) - Part 1: System Application Program Interface (API) [C Language]</cite>", Institute of Electrical
and Electronics Engineers, Inc, 1990.</dd>
<dt><a id="ref-rfc2045" name="ref-rfc2045"><strong>[RFC2045]</strong></a></dt>
<dd>"<cite><a href="http://www.ietf.org/rfc/rfc2045.txt">Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies</a></cite>", N. Freed and N. Borenstein, November
1996. Note that this RFC obsoletes RFC1521, RFC1522, and RFC1590.</dd>
<dt><a name="ref-rfc2046" id="ref-rfc2046"><strong>[RFC2046]</strong></a></dt>
<dd>"<cite><a href="http://www.ietf.org/rfc/rfc2046.txt">RFC2046: Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types</a></cite>", N. Freed and N. Borenstein, November 1996.<br />
Available at <a href="http://www.ietf.org/rfc/rfc2046.txt">http://www.ietf.org/rfc/rfc2046.txt</a>. Note that this RFC obsoletes RFC1521, RFC1522, and RFC1590.</dd>
<dt><a name="ref-rfc2119" id="ref-rfc2119"><strong>[RFC2119]</strong></a></dt>
<dd>"<cite><a href="http://www.ietf.org/rfc/rfc2119.txt">RFC2119: Key words for use in RFCs to Indicate Requirement Levels</a></cite>", S. Bradner, March 1997.<br />
Available at: http://www.ietf.org/rfc/rfc2119.txt</dd>
<dt><a name="ref-rfc2376" id="ref-rfc2376"><strong>[RFC2376]</strong></a></dt>
<dd>"<cite><a href="http://www.ietf.org/rfc/rfc2376.txt">RFC2376: XML Media Types</a></cite>", E. Whitehead, M. Murata, July 1998.<br />
This document is obsoleted by [<a href="#ref-rfc3023">RFC3023</a>].<br />
Available at: http://www.ietf.org/rfc/rfc2376.txt</dd>
<dt><a name="ref-rfc2396" id="ref-rfc2396"><strong>[RFC2396]</strong></a></dt>
<dd>"<cite><a href="http://www.ietf.org/rfc/rfc2396.txt">RFC2396: Uniform Resource Identifiers (URI): Generic Syntax</a></cite>", T. Berners-Lee, R. Fielding, L. Masinter, August 1998.<br />
This document updates RFC1738 and RFC1808.<br />
Available at: http://www.ietf.org/rfc/rfc2396.txt</dd>
<dt><a name="ref-rfc2854" id="ref-rfc2854"><strong>[RFC2854]</strong></a></dt>
<dd>"<cite><a href="http://www.ietf.org/rfc/rfc2854.txt">RFC2854: The text/html Media Type</a></cite>", D. Conolly, L. Masinter, June 2000.<br />
Available at: http://www.ietf.org/rfc/rfc2854.txt</dd>
<dt><a name="ref-rfc3023" id="ref-rfc3023"><strong>[RFC3023]</strong></a></dt>
<dd>"<cite><a href="http://www.ietf.org/rfc/rfc3023.txt">RFC3023: XML Media Types</a></cite>", M. Murata, S. St.Laurent, D. Kohn, January 2001.<br />
This document obsoletes [<a href="#ref-rfc2376">RFC2376</a>].<br />
Available at: http://www.ietf.org/rfc/rfc3023.txt</dd>
<dt><a id="ref-rfc3066" name="ref-rfc3066"><strong>[RFC3066]</strong></a></dt>
<dd>"<a href="http://www.ietf.org/rfc/rfc3066.txt">Tags for the Identification of Languages</a>", H. Alvestrand, January 2001.<br />
Available at: http://www.ietf.org/rfc/rfc3066.txt</dd>
<dt><a id="ref-rfc3236" name="ref-rfc3236"><strong>[RFC3236]</strong></a></dt>
<dd>"<a href="http://www.ietf.org/rfc/rfc3236.txt">The 'application/xhtml+xml' Media Type</a>", M. Baker, P. Stark, January 2002.<br />
Available at: http://www.ietf.org/rfc/rfc3236.txt</dd>
<dt><a id="ref-xhtml-mathml" name="ref-xhtml-mathml"><strong>[XHTML+MathML]</strong></a></dt>
<dd><cite>"<a href="http://www.w3.org/TR/MathML2/dtd/xhtml-math11-f.dtd">XHTML plus Math 1.1 <abbr title="Document Type Definition">DTD</abbr></a></cite>", "A.2 MathML as a DTD Module", Mathematical
Markup Language (MathML) Version 2.0. Available at: http://www.w3.org/TR/MathML2/dtd/xhtml-math11-f.dtd</dd>
<dt><a id="ref-xhtmlmime" name="ref-xhtmlmime"><strong>[XHTMLMIME]</strong></a></dt>
<dd>"<cite><a href="http://www.w3.org/TR/2002/NOTE-xhtml-media-types-20020801">XHTML Media Types</a></cite>", Masayasu Ishikawa, 1 August 2002.<br />
<a href="http://www.w3.org/TR/xhtml-media-types">Latest version</a> available at: http://www.w3.org/TR/xhtml-media-types</dd>
<dt><a id="ref-xhtmlmod" name="ref-xhtmlmod"><strong>[XHTMLMOD]</strong></a></dt>
<dd>"<cite><a href="http://www.w3.org/TR/2001/REC-xhtml-modularization-20010410">Modularization of XHTML</a></cite>", M. Altheim et al., 10 April 2001.<br />
<a href="http://www.w3.org/TR/xhtml-modularization">Latest version</a> available at: http://www.w3.org/TR/xhtml-modularization</dd>
<dt><a name="ref-xml" id="ref-xml"><strong>[XML]</strong></a></dt>
<dd>"<a href="http://www.w3.org/TR/2000/REC-xml-20001006">Extensible Markup Language (XML) 1.0 Specification (Second Edition)</a>", T. Bray, J. Paoli, C. M. Sperberg-McQueen, E. Maler, 6 October
2000.<br />
<a href="http://www.w3.org/TR/REC-xml">Latest version</a> available at: http://www.w3.org/TR/REC-xml</dd>
<dt><a name="ref-xmlns" id="ref-xmlns"><strong>[XMLNS]</strong></a></dt>
<dd>"<a href="http://www.w3.org/TR/1999/REC-xml-names-19990114">Namespaces in XML</a>", T. Bray, D. Hollander, A. Layman, 14 January 1999.<br />
XML namespaces provide a simple method for qualifying names used in XML documents by associating them with namespaces identified by URI.<br />
<a href="http://www.w3.org/TR/REC-xml-names">Latest version</a> available at: http://www.w3.org/TR/REC-xml-names</dd>
<dt><a name="ref-xmlc14n" id="ref-xmlc14n"><strong>[XMLC14N]</strong></a></dt>
<dd>"<a href="http://www.w3.org/TR/2001/REC-xml-c14n-20010315">Canonical XML Version 1.0</a>", J. Boyer, 15 March 2001.<br />
This document describes a method for generating a physical representation, the canonical form, of an XML document.<br />
<a href="http://www.w3.org/TR/xml-c14n">Latest version</a> available at: http://www.w3.org/TR/xml-c14n</dd>
</dl>
</nowiki></pre>
[http://www.w3.org/TR/xhtml1/#refs XHTML1.0 Spec references]
[http://www.w3.org/TR/xhtml1/#refs XHTML1.0 Spec references]



Revision as of 05:37, 10 April 2006

Citation Examples

The following examples are real world examples of citations found on the web. Please add to this list. The idea is that we get a solid sample of examples and see what commonalities there are amonst them and try to build this microformat so that it can meet 80% of typical uses.

See also:

Contributors

Citation Mark Up in the Wild

Mark up examples from reference publisher's websites (online catalogs), including ABC-CLIO, Greenwood Press, Marshall Cavendish, Oxford University Press (USA) and Thomson Gale. Examples are broken down and organized by element.

(For a cleaner version, see [1])

ABC-CLIO Product detail page

  • subtitle
  • title
  • author
  • Image
  • pubdate
  • pages
  • volumes
  • trimsize (book dimentions 8.5x11)
  • Format
  • Price
  • ISBN

Greenwood Press home page featured book

  • title
  • sub_title
  • author
  • isbn
  • price
  • bookDescription

Greenwood Press Product detail page

  • Title
  • SubTitle
  • authors
  • AuthorsNote
  • BookCode
  • Isbn
  • PageColation
  • Imprint
  • PubDate
  • ListPrice
  • Availability
  • MediaType
  • BookInformation (categories)
  • LC Card Number
  • LCC Class
  • Dewey Class:

Marshall Cavendish product page

  • ISBN Number
  • Series
  • Title
  • Imprint
  • Specifications (dimentions/weight)
  • Authors
  • Target Audience
  • Price
  • description

Oxford University Press (USA) homepage

  • title
  • subTitle
  • edition
  • byline
  • isbnNumber
  • format - hardback
  • publicationDate
  • price
  • description
  • related

Oxford University Press (USA) Product page

  • title
  • subTitle
  • edition
  • byline
  • image
  • isbnNumber
  • format - hardback
  • pages
  • publicationDate
  • availability
  • cost

Thomson Gale product detail page

  • title_main
  • excerp
  • Volume
  • Published by
  • description
  • Published/Released
  • ISBN:
  • Product number
  • Page count:
  • Shipping Weight:
  • price

Breakdown of Citation Elements

Using the above examples, various parts of the citations (titles, authors, etc.) can be grouped together for comparision:

Book titles:

Book Series Name:

Sub-title:

Author:

Publication Date:

Volumes:

ISBN:

Book Edition:

Added by Tim

RFC vCard Example

  • refID
  • title
  • publication
  • title
  • Journal
  • Volume
  • Issue
  • page
  • pubdate
  • RFC ID

W3C XHTML Spec Example

  • refID
  • URL
  • title
  • subtitle
  • part (1 of X)
  • journal
  • authors
  • pubdate
  • language
  • ISO/IEC ID
  • RFC ID

XHTML1.0 Spec references

CiteProc XHTML Output

The XHTML output for CiteProc[2] wasn't designed per se as a microformat, but is probably not a bad place to start. It is desgined to handle a wide range of content. Here is the APA output:

 <div id="bibliography">

   <h3>References</h3>

   <p id="Brenner2000a" class="bibref">
    <span class="creator">Brenner, N.</span>
    <span class="date"> (<span class="year">2000</span>) </span>
    <span class="title">The Urban Question as a Scale Question: Reflections 
    on Henri Lefebre, Urban Theory and the Politics of Scale, </span>
    <span class="container">
      <span class="title" style="font-style: italic">International Journal of 
        Urban and Regional Research, </span>
      <span class="volume">24</span>
      <span class="issue">(2)</span>
      <span class="locator">, pp. 361–78</span>
      </span>.
    </p>

   <p id="NW2000-0207" class="bibref">
     <span class="creator">Newsweek</span>
     <span class="date"> 
       (<span class="year">2000a</span>
       <span class="month">, February</span>
       <span class="day"> 7</span>) 
     </span>
     <span class="title">The Grandmas Pay a Visit, </span>
     <span class="container">
       <span class="volume">135</span>
       <span class="issue">(6)</span>
       <span class="locator">, pp. 45</span>
     </span>.
   </p>

   <p id="Veer1996a" class="bibref">
     <span class="creator">van der Veer, P.</span>
     <span class="date"><span class="year"> (1996) </span></span>
     <span class="title">Riots and Rituals: The Construction of Violence 
       and Public Space in Hindu Nationalism</span>
     <span class="container">, In Brass, P.<span class="role"> (Ed.)</span>. 
       <span class="title" style="font-style: italic">Riots and Pogroms.</span>
       <span class="origin"><span class="place">New York</span>
       <span class="publisher">: NYU Press</span></span>
       <span class="locator">, pp. 154–76</span>
     </span>.
   </p>
 </div>

ACM Digital Library Search Result Examples

The ACM Digital Library is a heavily used computer science literature database.

  • title
  • authors
  • Pages
  • format
  • Additional Information
  • abstract
  • index terms
  • journal
  • issue
  • volume
  • pubdate
  • DOI

IEEE IEEExplore Search Results Markup

  • title
  • authors
  • issue
  • Volume
  • Issue
  • pubdate
  • Page
  • Digital Object Identifier (DOI)
  • Summary

CiteSeer database search results

The CiteSeer database has been another heavily used Computer Science online resource, and it has minimal markup:

  • author
  • title
  • publication (where it was found)
  • pages
  • pubdate
  • URL

CiteULike.org citation listing

CiteULike

  • title
  • author
  • subjects
  • image
  • Vol
  • No.
  • pubdate
  • page

Links to services with the following IDs embedded in the link

  • Z3988
  • DOI
  • Pubmed
  • Hubmed

Amazon.com citation info

This is from a detail page on Amazon.com for a book.

<a name='citing' ></a><b>This book cites 10 books:</b><br />
<ul...>
  <li> 
    <a href="http://www.amazon.com/exec/obidos/tg/detail/-/1555424236/ref=sid_dp_dp/002-6751255-9290456?%5Fencoding=UTF8&v=glance">
      The New Faculty Member: Supporting and Fostering Professional Development (Jossey-Bass Higher and Adult Education Series)
    </a>
    by Robert Boice on
    <a href="/gp/reader/0780311361/ref=sib_ab_dp_pg/002-6751255-9290456?%5Fencoding=UTF8&p=S04X&checkSum=vptuDOjULIOadVNe9UFX36fnIKktwxxQOeBmFQupyrA%3D">page 156</a>, and <a href="/gp/reader/0780311361/ref=sib_ab_dp_pg/002-6751255-9290456?%5Fencoding=UTF8&p=S088&checkSum=vptuDOjULINm2bvcL37hZR%2BcnJi%2F9hhUyu1%2FlXWnOM8%3D">
      page 275
    </a>
  </li>
  <li>
    <a href="http://www.amazon.com/exec/obidos/tg/detail/-/0137947364/ref=sid_dp_dp/002-6751255-9290456?%5Fencoding=UTF8&v=glance" >Science, Technology and Society</a>
    by Robert E. McGinn on
    <a href="/gp/reader/0780311361/ref=sib_ab_dp_pg/002-6751255-9290456?%5Fencoding=UTF8&p=S023&checkSum=vptuDOjULIMgFwAeeT8gWiDHmklkxfy%2BGug%2BAS7UI2Y%3D">page 54</a></li><li>




PubMed Medical Journal Example

  • abstract
  • title
  • publisher
  • date/time published
  • Review (BOOLEAN YES/NO)
  • PubMedID

Implied schema

Many of the examples have simple citations in <p>, <div>, <td> etc with no further coding; i.e. <td>Book Title. Author. Publisher, date.</td>

The following lists the most common markup:

Book Titles:

  • id="title"
  • class="producttitle"
  • class="title"
  • id="lblTitle"
  • h1
  • h2
  • <dt></dt>
  • <cite></cite>
  • <strong></strong>
  • <i></i>

Book Series:

  • id="serieslbl"
  • class="productsubtitle"

Sub-titles:

  • id="subtitle"
  • class="productsubtitle"
  • class="sub_title"
  • id="lblSubTitle"
  • class="book_subline"
  • class="subTitle"

Author:

  • id="credit"
  • class="productauthor"
  • class="author"
  • Authors (table cell)
  • class="byline"
  • class="creator"
  • class="role"
  • Inside <dd></dd> with other elements
  • <li></li>

Publication Date:

  • id="pubdate"
  • Publication Date: (table cell)
  • id="pnlPubDate"
  • Publication Date:
  • class="publicationdate"
  • Published/Released:
  • class="date" w/ class="year", class="month", class="day"
  • Inside <dd></dd> with other elements

Publisher:

  • class="publisher"
  • class="origin" (publication location)

Volumes:

  • class="volume"

Issue Number:

  • class="issue"

Page Numbers:

  • class="locator" (inclusive page numbers)

ISBN:

  • class="isbn"
  • id="pnlIsbn"
  • id="lblIsbn"
  • class="isbnNumber"

Book Edition:

  • class="edition"
  • Inside <dd></dd> with other elements


Citeproc XHTML output

I'm the author of the citeproc project, which includes a micro-format of sorts (though I never thought of it as such) in its XHTML output mode. See here for an example. The difference compared to the bibtex-derived model is that is a) more generic and b) hierachical.

It would be possible, certainly, to do a flat model if for some reason there was a good technical reason not to go hierarchical (though is there?)

The burden of proof is on *going* hierarchical, rather than a simpler flat solution. Complexity must be justified, not simplicity.

... but then you need to think outside the BibTeX box in any case. Any model of this sort ought to be able to handle legal citations, magazine articles, patents, etc. etc.; not just a narrow range of BibTeX types.

Per the microformats process, microformats are designed to support existing practice on the Web, anything else should be omitted from at least the first version.


Styles

This does NOT define a format, but instead shows how the format should be displayed. This is something out of the direct scope of this project. CSS styles will handle the look-and-feel of the text, and the author can put it in any order they choose. These links are mentioned for two reasons, one is informative, the other is so we know at least meet the minimum properties that are used in the styles.