Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[avt] (1) Respond to feedback on <cite> and cite='' -- titles of work…
…s, citations, and examples thereon

git-svn-id: http://svn.whatwg.org/webapps@1234 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Feb 20, 2008
1 parent 1d4c4ca commit 813b44f
Show file tree
Hide file tree
Showing 2 changed files with 235 additions and 47 deletions.
130 changes: 105 additions & 25 deletions index
Expand Up @@ -24,7 +24,7 @@

<h1 id=html-5>HTML 5</h1>

<h2 class="no-num no-toc" id=working>Working Draft &mdash; 19 February
<h2 class="no-num no-toc" id=working>Working Draft &mdash; 20 February
2008</h2>

<p>You can take part in this work. <a
Expand Down Expand Up @@ -8418,14 +8418,14 @@ XXX attributes to give the date authored, date published
users to follow such citation links.

<p>If a <code><a href="#blockquote">blockquote</a></code> element is <a
href="#preceded">preceded or followed</a> by a <a
href="#preceded">preceded or followed</a> by a single <a
href="#paragraph">paragraph</a> that contains a single <code><a
href="#cite2">cite</a></code> element and is itself not <a
href="#cite2">cite</a></code> element and that is itself not <a
href="#preceded">preceded or followed</a> by another <code><a
href="#blockquote">blockquote</a></code> element and does not itself have
a <code><a href="#q">q</a></code> element descendant, then, the citation
given by that <code><a href="#cite2">cite</a></code> element gives the
source of the quotation contained in the <code><a
a <code><a href="#q">q</a></code> element descendant, then, the title of
the work given by that <code><a href="#cite2">cite</a></code> element
gives the source of the quotation contained in the <code><a
href="#blockquote">blockquote</a></code> element.

<p>The <dfn id=cite0 title=dom-quote-cite><code>cite</code></dfn> DOM
Expand Down Expand Up @@ -9497,7 +9497,7 @@ Address: &lt;input name="address"&gt;&lt;/p&gt;</pre>
or <code><a href="#blockquote">blockquote</a></code> elements in this
markup. Indeed, a <code><a href="#q">q</a></code> element inside a
<code><a href="#dd">dd</a></code> element in a conversation would actually
imply the people talking were themselves quoting someone else. See the
imply the people talking were themselves quoting another work. See the
<code><a href="#cite2">cite</a></code>, <code><a href="#q">q</a></code>,
and <code><a href="#blockquote">blockquote</a></code> elements for other
ways to cite or quote.
Expand Down Expand Up @@ -10183,9 +10183,10 @@ a friend lost to the
<p>If a <code><a href="#q">q</a></code> element is contained (directly or
indirectly) in a <a href="#paragraph">paragraph</a> that contains a single
<code><a href="#cite2">cite</a></code> element and has no other <code><a
href="#q">q</a></code> element descendants, then, the citation given by
that <code><a href="#cite2">cite</a></code> element gives the source of
the quotation contained in the <code><a href="#q">q</a></code> element.</p>
href="#q">q</a></code> element descendants, then, the title of the work
given by that <code><a href="#cite2">cite</a></code> element gives the
source of the quotation contained in the <code><a href="#q">q</a></code>
element.</p>
<!-- XXX need examples -->

<h4 id=the-cite><span class=secno>3.12.3 </span>The <dfn
Expand Down Expand Up @@ -10215,41 +10216,104 @@ a friend lost to the
<!-- XXX should the cite element have a cite attribute? -->
</dl>

<p>The <code><a href="#cite2">cite</a></code> element represents a
citation: the source, or reference, for a quote or statement made in the
document.
<p>The <code><a href="#cite2">cite</a></code> element represents the title
of a work (e.g. a book, a paper, an essay, a poem, a score, a song, a
script, a film, a TV show, a game, a sculpture, a painting, a theatre
production, a play, an opera, a musical, an exhibition, etc). This can be
a work that is being quoted or referenced in detail (i.e. a citation), or
it can just be a work that is mentioned in passing.

<p>A person's name is not the title of a work &mdash; even if people call
that person a piece of work &mdash; and the element must therefore not be
used to mark up people's names. (In some cases, the <code><a
href="#b">b</a></code> element might be appropriate for names; e.g. in a
gossip article where the names of famous people are keywords rendered with
a different style to draw attention to them. In other cases, if an element
is <em>really</em> needed, the <code><a href="#span">span</a></code>
element can be used.)

<p>A ship is similarly not a work, and the element must not be used to mark
up ship names (the <code><a href="#i">i</a></code> element can be used for
that purpose).

<div class=example>
<p>This next example shows a typical use of the <code><a
href="#cite2">cite</a></code> element:</p>

<pre>&lt;p>My favourite book is &lt;cite>The Reality Dysfunction&lt;/cite> by
Peter F. Hamilton. My favourite comic is &lt;cite>Pearls Before
Swine&lt;/cite> by Stephan Pastis. My favourite track is &lt;cite>Jive
Samba&lt;/cite> by the Cannonball Adderley Sextet.&lt;/p></pre>
</div>

<div class=example>
<p>This is correct usage:</p>

<pre>&lt;p>According to the Wikipedia article &lt;cite>HTML&lt;/cite>, as it
stood in mid-February 2008, leaving attribute values unquoted is
unsafe. This is obviously an over-simplification.&lt;/p></pre>

<p>The following, however, is incorrect usage, as the <code><a
href="#cite2">cite</a></code> element here is containing far more than
the title of the work:</p>

<pre>&lt;p>According to &lt;cite>the Wikipedia article on HTML&lt;/cite>, as it
stood in mid-February 2008, leaving attribute values unquoted is
unsafe. This is obviously an over-simplification.&lt;/p></pre>
</div>

<div class=example>
<p>The <code><a href="#cite2">cite</a></code> element is obviously a key
part of any citation in a bibliography, but it is only used to mark the
title:</p>

<pre>&lt;p>&lt;cite>Universal Declaration of Human Rights&lt;/cite>, United Nations,
December 1948. Adopted by General Assembly resolution 217 A (III).&lt;/p></pre>
</div>

<p class=note>A <em>citation</em> is not a <em>quote</em> (for which the
<code><a href="#q">q</a></code> element is appropriate).

<div class=example>
<p>This is incorrect usage:</p>
<p>This is incorrect usage, because <code><a href="#cite2">cite</a></code>
is not for quotes:</p>

<pre>&lt;p>&lt;cite>This is wrong!&lt;/cite>, said Ian.&lt;/p></pre>

<p>This is the correct way to do it:</p>
<p>This is also incorrect usage, because a person is not a work:</p>

<pre>&lt;p>&lt;q>This is correct!&lt;/q>, said &lt;cite>Ian&lt;/cite>.&lt;/p></pre>
<pre>&lt;p>&lt;q>This is still wrong!&lt;/q>, said &lt;cite>Ian&lt;/cite>.&lt;/p></pre>

<p>This is also wrong, because the title and the name are not references
or citations:</p>
<p>The correct usage does not use a <code><a href="#cite2">cite</a></code>
element:</p>

<pre>&lt;p>My favourite book is &lt;cite>The Reality Dysfunction&lt;/cite>
by &lt;cite>Peter F. Hamilton&lt;/cite>.&lt;/p></pre>
<pre>&lt;p>&lt;q>This is correct&lt;/q>, said Ian.&lt;/p></pre>

<p>This is correct, because even though the source is not quoted, it is
cited:</p>
<p>As mentioned above, the <code><a href="#b">b</a></code> element might
be relevant for marking names as being keywords in certain kinds of
documents:</p>

<pre>&lt;p>According to &lt;cite>the Wikipedia article on
HTML&lt;/cite>, HTML is defined in formal specifications that were
developed and published throughout the 1990s.&lt;/p></pre>
<pre>&lt;p>And then &lt;b>Ian&lt;/b> said &lt;q>this might be right, in a
gossip column, maybe!&lt;/q>.&lt;/p></pre>
</div>

<p class=note>The <code><a href="#cite2">cite</a></code> element can apply
to <code><a href="#blockquote">blockquote</a></code> and <code><a
href="#q">q</a></code> elements in certain cases described in the
definitions of those elements.

<div class=example>
<p>This next example shows the use of <code><a
href="#cite2">cite</a></code> alongside <code><a
href="#blockquote">blockquote</a></code>:</p>

<pre>&lt;p>His next piece was the aptly named &lt;cite>Sonnet 130&lt;/cite>:&lt;/p>
&lt;blockquote>
&lt;p>My mistress' eyes are nothing like the sun,&lt;br>
Coral is far more red, than her lips red,
...</pre>
</div>

<h4 id=the-em><span class=secno>3.12.4 </span>The <dfn
id=em><code>em</code></dfn> element</h4>

Expand Down Expand Up @@ -10690,6 +10754,21 @@ and so Hammond ordered the iris to be opened.&lt;/p></pre>
<!-- XXX need some examples of duplicates being bad, of title
attributes being bad, etc -->
</div>
<!--
> One useful line of retreat would be to specify that in the following
> code, "the state of being happy" is unambiguously a definition of
> "happiness" and not of any other subset of the <dt>.
>
> <dl>
> <dt><dfn>happiness</dfn> /'h&aelig; p. nes/ <i><abbr>n.</abbr></i></dt>
> <dd>the state of being happy</dd>
> </dl>
>
> This could be encouraged by "dt dfn {font-weight: bold; font-style:
> normal;}" in browsers' default style sheets, which would be quite
> backward-compatible because of the rarity of <dt><dfn> up to now.
- mpt
-->

<h4 id=the-abbr><span class=secno>3.12.9 </span>The <dfn
id=abbr><code>abbr</code></dfn> element</h4>
Expand Down Expand Up @@ -45691,6 +45770,7 @@ http://lxr.mozilla.org/seamonkey/search?string=nested
link: click
mark: skip to next mark element
title attribute: tooltip
cite attribute on q, blockquote, ins, del: on hover, show link
...

Define how to determine what element is under the cursor, unless
Expand Down

0 comments on commit 813b44f

Please sign in to comment.