- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 06 May 2009 23:07:33 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv27662
Modified Files:
Overview.html
Log Message:
Add cite='' attribute to <section> and <article>. (whatwg r3069)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2227
retrieving revision 1.2228
diff -u -d -r1.2227 -r1.2228
--- Overview.html 4 May 2009 06:10:36 -0000 1.2227
+++ Overview.html 6 May 2009 23:07:30 -0000 1.2228
@@ -148,7 +148,7 @@
<h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
<!--ZZZ:-->
<!--<h2 class="no-num no-toc">W3C Working Draft 23 April 2009</h2>-->
- <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 4 May 2009</h2>
+ <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 6 May 2009</h2>
<!--:ZZZ-->
<dl><!-- ZZZ: update the month/day (twice), (un)comment out
<dt>This Version:</dt>
@@ -241,7 +241,7 @@
track.
<!--ZZZ:-->
<!--This specification is the 23 April 2009 Working Draft.-->
- This specification is the 4 May 2009 Editor's Draft.
+ This specification is the 6 May 2009 Editor's Draft.
<!--:ZZZ-->
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href="http://www.whatwg.org/">WHATWG</a>. The two specifications are
identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -4237,8 +4237,10 @@
</dd>
- <dt>If the element is a <code><a href="#the-blockquote-element">blockquote</a></code>, <code><a href="#the-q-element">q</a></code>,
- <code><a href="#the-ins-element">ins</a></code>, or <code><a href="#the-del-element">del</a></code> element with a <code title="">cite</code> attribute</dt>
+ <dt>If the element is a <code><a href="#the-q-element">q</a></code>, <code><a href="#the-blockquote-element">blockquote</a></code>,
+ <code><a href="#the-section-element">section</a></code>, <code><a href="#the-article-element">article</a></code>, <code><a href="#the-ins-element">ins</a></code>, or
+ <code><a href="#the-del-element">del</a></code> element with a <code title="">cite</code>
+ attribute</dt>
<dd>
@@ -10769,15 +10771,33 @@
<dd><a href="#flow-content-0">Flow content</a>.</dd>
<dt>Content attributes:</dt>
<dd><a href="#global-attributes">Global attributes</a></dd>
+ <dd><code title="attr-section-cite"><a href="#attr-section-cite">cite</a></code></dd>
<dt>DOM interface:</dt>
- <dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd>
+ <dd>
+<pre class="idl">interface <dfn id="htmlsectionelement">HTMLSectionElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
+ attribute DOMString <a href="#dom-section-cite" title="dom-section-cite">cite</a>;
+};</pre>
+ </dd>
</dl><p>The <code><a href="#the-section-element">section</a></code> element <a href="#represents">represents</a> a
generic document or application section. A section, in this context,
is a thematic grouping of content, typically with a heading, possibly
with a footer.<p class="example">Examples of sections would be chapters, the
various tabbed pages in a tabbed dialog box, or the numbered
sections of a thesis. A Web site's home page could be split into
- sections for an introduction, news items, contact information.<div class="example">
+ sections for an introduction, news items, contact information.<p>The <dfn id="attr-section-cite" title="attr-section-cite"><code>cite</code></dfn>
+ attribute may be used if the content of the section was taken from
+ another page (e.g. syndicating content from multiple sources on one
+ page). The attribute, if present, must contain a <a href="#valid-url">valid
+ URL</a> referencing the original source. <span class="impl">To
+ obtain the corresponding citation link, the value of the attribute
+ must be <a href="#resolve-a-url" title="resolve a url">resolved</a> relative to the
+ element. User agents should allow users to follow such citation
+ links.</span><div class="impl">
+
+ <p>The <dfn id="dom-section-cite" title="dom-section-cite"><code>cite</code></dfn> DOM
+ attribute must <a href="#reflect">reflect</a> the element's <code title="attr-section-cite"><a href="#attr-section-cite">cite</a></code> content attribute.</p>
+
+ </div><div class="example">
<p>In the following example, we see an article (part of a larger
Web page) about apples, containing two short sections.</p>
@@ -10865,11 +10885,14 @@
<dd><a href="#flow-content-0">Flow content</a>.</dd>
<dt>Content attributes:</dt>
<dd><a href="#global-attributes">Global attributes</a></dd>
-<!--
-XXX attributes to give the date authored, date published
--->
+ <dd><code title="attr-article-cite"><a href="#attr-article-cite">cite</a></code></dd>
+ <!-- v2 attributes to give the date authored, date published, name of author, etc -->
<dt>DOM interface:</dt>
- <dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd>
+ <dd>
+<pre class="idl">interface <dfn id="htmlarticleelement">HTMLArticleElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
+ attribute DOMString <a href="#dom-article-cite" title="dom-article-cite">cite</a>;
+};</pre>
+ </dd>
</dl><p>The <code><a href="#the-article-element">article</a></code> element <a href="#represents">represents</a> a
section of a page that consists of a composition that forms an
independent part of a document, page, or site. This could be a forum
@@ -10879,9 +10902,7 @@
that its contents could stand alone, for example in syndication.
However, the element is still associated with its ancestors; for
instance, contact information that <a href="#applyToSection">applies</a> to a parent <code><a href="#the-body-element">body</a></code>
- element still covers the <code><a href="#the-article-element">article</a></code> as well.</p><!-- XXX
- or should we apply the rules in the last paragraph to all articles?
- --><p>When <code><a href="#the-article-element">article</a></code> elements are nested, the inner
+ element still covers the <code><a href="#the-article-element">article</a></code> as well.<p>When <code><a href="#the-article-element">article</a></code> elements are nested, the inner
<code><a href="#the-article-element">article</a></code> elements represent articles that are in
principle related to the contents of the outer article. For
instance, a Web log entry on a site that accepts user-submitted
@@ -10889,7 +10910,20 @@
elements nested within the <code><a href="#the-article-element">article</a></code> element for the Web
log entry.<p>Author information associated with an <code><a href="#the-article-element">article</a></code>
element (q.v. the <code><a href="#the-address-element">address</a></code> element) does not apply to
- nested <code><a href="#the-article-element">article</a></code> elements.<h4 id="the-aside-element"><span class="secno">4.4.5 </span>The <dfn><code>aside</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
+ nested <code><a href="#the-article-element">article</a></code> elements.<p>The <dfn id="attr-article-cite" title="attr-article-cite"><code>cite</code></dfn>
+ attribute may be used if the content of the article was taken from
+ another page (e.g. syndicating content from multiple sources on one
+ page). The attribute, if present, must contain a <a href="#valid-url">valid
+ URL</a> referencing the original source. <span class="impl">To
+ obtain the corresponding citation link, the value of the attribute
+ must be <a href="#resolve-a-url" title="resolve a url">resolved</a> relative to the
+ element. User agents should allow users to follow such citation
+ links.</span><div class="impl">
+
+ <p>The <dfn id="dom-article-cite" title="dom-article-cite"><code>cite</code></dfn> DOM
+ attribute must <a href="#reflect">reflect</a> the element's <code title="attr-article-cite"><a href="#attr-article-cite">cite</a></code> content attribute.</p>
+
+ </div><h4 id="the-aside-element"><span class="secno">4.4.5 </span>The <dfn><code>aside</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd><a href="#flow-content-0">Flow content</a>.</dd>
<dd><a href="#sectioning-content-0">Sectioning content</a>.</dd>
<dt>Contexts in which this element may be used:</dt>
@@ -14483,16 +14517,12 @@
change. When that document is long, for instance the minutes of a
meeting, authors are encouraged to include a fragment identifier
pointing to the specific part of that document that discusses the
- change.<div class="impl">
-
- <p>If the <code title="attr-mod-cite"><a href="#attr-mod-cite">cite</a></code> attribute is
+ change.<p>If the <code title="attr-mod-cite"><a href="#attr-mod-cite">cite</a></code> attribute is
present, it must be a <a href="#valid-url">valid URL</a> that explains the
- change. To obtain the corresponding citation link, the value of the
- attribute must be <a href="#resolve-a-url" title="resolve a url">resolved</a>
- relative to the element. User agents should allow users to follow
- such citation links.</p>
-
- </div><p>The <dfn id="attr-mod-datetime" title="attr-mod-datetime"><code>datetime</code></dfn>
+ change. <span class="impl">To obtain the corresponding citation
+ link, the value of the attribute must be <a href="#resolve-a-url" title="resolve a
+ url">resolved</a> relative to the element. User agents should
+ allow users to follow such citation links.</span><p>The <dfn id="attr-mod-datetime" title="attr-mod-datetime"><code>datetime</code></dfn>
attribute may be used to specify the time and date of the change.<p>If present, the <code title="attr-mod-datetime"><a href="#attr-mod-datetime">datetime</a></code>
attribute must be a <a href="#valid-global-date-and-time-string">valid global date and time string</a>
value.<div class="impl">
@@ -58596,8 +58626,8 @@
<p>User agents are expected to allow users to <a href="#navigate">navigate</a>
<a href="#browsing-context" title="browsing context">browsing contexts</a> to the
resources <a href="#resolve-a-url" title="resolve a url">indicated</a> by the <code title="">cite</code> attributes on <code><a href="#the-q-element">q</a></code>,
- <code><a href="#the-blockquote-element">blockquote</a></code>, <code><a href="#the-ins-element">ins</a></code>, and <code><a href="#the-del-element">del</a></code>
- elements.</p>
+ <code><a href="#the-blockquote-element">blockquote</a></code>, <code><a href="#the-section-element">section</a></code>, <code><a href="#the-article-element">article</a></code>,
+ <code><a href="#the-ins-element">ins</a></code>, and <code><a href="#the-del-element">del</a></code> elements.</p>
<p>User agents are expected to surface <a href="#hyperlink" title="hyperlink">hyperlinks</a> created by <code><a href="#the-link-element">link</a></code>
elements in their user interface.</p>
Received on Wednesday, 6 May 2009 23:07:42 UTC