A user account is required in order to edit this wiki, but we've had to disable public user registrations due to spam.
To request an account, ask an autoconfirmed user on Chat (such as one of these permanent autoconfirmed members).
Cite element: Difference between revisions
(58 intermediate revisions by 30 users not shown) | |||
Line 1: | Line 1: | ||
Research, data, use cases, issues, and enhancements related to the HTML5 <code>cite</code> element. | Research, data, use cases, issues, and enhancements related to the HTML5 <code>cite</code> element. | ||
== Speaker == | |||
<ins datetime="2014-11-14">Update 2014-11-14: The HTML spec has been changed to allow use of <cite> to refer to a speaker, and even includes an example of it: http://www.w3.org/html/wg/drafts/html/master/text-level-semantics.html#the-cite-element</ins> | |||
The cite element has been used (and recommended to be used) to refer to speakers in a conversation, or individuals when quoting them, thus HTML5 should explicitly permit and encourage this use. | The cite element has been used (and recommended to be used) to refer to speakers in a conversation, or individuals when quoting them, thus HTML5 should explicitly permit and encourage this use. | ||
This section serves to document both uses in the wild, and long-standing recommendations/documentations thereof. | This section serves to document both uses in the wild, and long-standing recommendations/documentations thereof. | ||
=== | === Examples in the Wild === | ||
* 2003-08-23: <cite>[http://diveintomark.org/archives/2003/08/29/semantics Won’t somebody please think of the gerbils?]</cite> by <cite>[http://diveintomark.org/ Mark Pilgrim]</cite>: <blockquote>I mark up names of people I link to (like in the list above) with the CITE tag, and I have a script that runs every night that aggregates those tags and creates posts by citation.</blockquote> | * 2003-08-23: <cite>[http://diveintomark.org/archives/2003/08/29/semantics Won’t somebody please think of the gerbils?]</cite> by <cite>[http://diveintomark.org/ Mark Pilgrim]</cite>: <blockquote>I mark up names of people I link to (like in the list above) with the CITE tag, and I have a script that runs every night that aggregates those tags and creates posts by citation.</blockquote> | ||
* [http://www.geekinthepark.co.uk/transcripts/2008/brian-cant.html transcript of the presentation “What Brian Cant Never Taught You About Metadata”, by Drew McLellen] (this is from a template I provided the transcription company; all others are similar structure. brucel) | * [http://www.geekinthepark.co.uk/transcripts/2008/brian-cant.html transcript of the presentation “What Brian Cant Never Taught You About Metadata”, by Drew McLellen] (this is from a template I provided the transcription company; all others are similar structure. brucel) | ||
* Many blog posts on [http://adactio.com/journal/ adactio.com], e.g <cite>[http://adactio.com/journal/1398/ Blame]</cite> from 2008-01-09: <blockquote>...something Bruce Sterling said at last year’s South by Southwest...</blockquote> | * Many blog posts on [http://adactio.com/journal/ adactio.com], e.g <cite>[http://adactio.com/journal/1398/ Blame]</cite> from 2008-01-09: <blockquote>...something Bruce Sterling said at last year’s South by Southwest...</blockquote> | ||
* Default WordPress theme ("Kubrick") uses cite for name of commenters. That's approx 46 bajillion instances. | * Default WordPress theme ("Kubrick") uses cite for name of commenters. That's approx 46 bajillion instances. | ||
* The transcripts for comics (#34 and onward) at [http://www.cssquirrel.com/ CSSquirrel]. The links to the transcripts are hidden from sighted users, one example is: [http://www.cssquirrel.com/comicscripts/script35.htm Transcript #35 2009-09-08] | |||
* 2005-05-16: Speakers in this <cite>[http://erikanderica.org/erik/work/lazarus/playtext/ Towneley Lazarus play]</cite> edition are identified using CITE. | |||
* [http://igofigure.com/page/testimonials/ Testimonials on the website for Go Figure Inc.] use cite to denote the names/locations of the people who provided the testimonial | |||
* [http://guineylaw.com/testimonials/ The Law Offices of Thomas G Guiney] uses cite to mark up the names of speakers for testimonial quotes. | |||
* [http://2009.dconstruct.org/podcast/makeitso/ Podcast transcript] from dConstruct 2009 ([http://2009.dconstruct.org/podcast/ more]) | |||
* Various "conversations"/transcripts at [http://peterjanes.ca/blog/ Petroglyphs], e.g. [http://peterjanes.ca/blog/2008/04/04/bang/ dialogue], and [http://peterjanes.ca/blog/wp-content/themes/petroglyphs/style.css CSS classes defined for terms, titles, etc.] ([http://peterjanes.ca/2005/citations/# XMDP]) | |||
* any article at Einfach für Alle (major german accessibility resource), e.g. [http://www.einfach-fuer-alle.de/artikel/ueberschriften-strukturen-in-html/] (see sidebar, 4th box from top labelled "mehr dazu:") uses cite to mark up authors' names | |||
* any articles on [http://www.la-grange.net/ La Grange] with a quote from a book or poem, and in addition any kind of references to a blog post. cite class="auteur" and cite class="title" for author and title respectively. | |||
* 2011-06-07: Wikipedia marks the autor inside a blockquote with the cite-Element: [http://en.wikipedia.org/wiki/Template:Quotation en Wikipedia] ([http://toolserver.org/~jarry/templatecount/index.php?lang=en&name=Template%3AQuotation#bottom 12379 uses]), [http://de.wikipedia.org/wiki/Wikipedia:Zitate#Blockzitate de Wikipedia] ([http://toolserver.org/~jarry/templatecount/index.php?lang=de&name=Zitat#bottom 24922 uses]) | |||
=== | === Documentation === | ||
* 1998-04-24 <cite>[http://www.w3.org/TR/1998/REC-html40-19980424/struct/text.html#h-9.2.1 HTML 4.0 REC]</cite> <blockquote>Contains a citation or a reference to other sources.</blockquote><blockquote><p>As <CITE>Harry S. Truman</CITE> said,<br><Q lang="en-us">The buck stops here.</Q></p><p>More information can be found in <CITE>[ISO-0000]</CITE>.</p></blockquote> | * 1998-04-24 <cite>[http://www.w3.org/TR/1998/REC-html40-19980424/struct/text.html#h-9.2.1 HTML 4.0 REC]</cite> <blockquote>Contains a citation or a reference to other sources.</blockquote><blockquote><p>As <CITE>Harry S. Truman</CITE> said,<br><Q lang="en-us">The buck stops here.</Q></p><p>More information can be found in <CITE>[ISO-0000]</CITE>.</p></blockquote> | ||
* 1999-12-24 <cite>[http://www.w3.org/TR/html401/struct/text.html#edef-CITE HTML 4.01 REC]</cite> (same definition and examples as quoted above). | * 1999-12-24 <cite>[http://www.w3.org/TR/html401/struct/text.html#edef-CITE HTML 4.01 REC]</cite> (same definition and examples as quoted above). | ||
Line 22: | Line 31: | ||
* ... | * ... | ||
=== | === Counter-arguments === | ||
==== original intent of cite element ==== | |||
* 2007-06-07 <cite>Dan Connolly</cite>, Editor of HTML 2.0, said in IRC that <blockquote cite="http://krijnhoetmer.nl/irc-logs/html-wg/20070607#l-797"><cite> was supposed to capture the chicago-manual-of-style idiom for titles of works. I have lost track of what it means these days.</blockquote> | |||
** This may have been the original intent (original theoretical purity), however, based on the example in the HTML4 spec(s) and adoption by the web community over the past 10+ years (see above examples in the wild), it makes more sense to define the <cite> element per actual usage (preferring authors), rather than original intent (theoretical purity), per the [http://www.w3.org/TR/html-design-principles/#priority-of-constituencies priority of constituencies HTML design principle]. - [[User:Tantek|Tantek]] 22:18, 13 August 2010 (UTC) | |||
* "DanC said allowing <nowiki><cite></nowiki> for speakers was a bug in HTML 4 that happened because he was asleep at the wheel." | |||
** Regardless of what DanC as a <em>specifier</em> may have intended, the authors have widely adopted the usage of cite for speakers, and thus since authors are considered over specifiers (per above-referenced design principle), we should prefer author usage over original specifier intent. | |||
==== speakers are not italicized typically ==== | |||
* "Since speakers aren't italicized typically, using <nowiki><cite></nowiki> for them doesn't really make sense. " | |||
** This sounds like either an argument from presentation, which seems backwards, as semantics should be determined first, and then authors can style semantics however they wish, or it's an argument from default presentation implementation, in which case once again per [http://www.w3.org/TR/html-design-principles/#priority-of-constituencies priority of constituencies HTML design principle], since authors are considered over implementers, we should respect author usage of cite for speakers over any particular implementer opinion of what cite should do or look like. | |||
***The Design Principles don't support the notion of determining semantics first. In fact, the Design Principles were carefully drafted not to treat semantics as having any value on their own right but only as a means to a useful end (such as Device Independence or Accessibility). As for considering authors over implementors or specifiers, we should consider whether an author who hasn't been exposed to advocacy that tries to rationalize the feature set of HTML4 would find a need to mark up speakers in a way that italicizes by default and required additional work to un-italicize as opposed to not marking up speakers at all all using the <code>b</code> element to bold speakers where required by a newspaper-like house style. That is, what authors do after having been exposed to advocacy is bad evidence for determining the needs the authors would have on their own initiative. | |||
=== Opinions === | |||
Opinions on whether HTML5 should explicitly permit and encourage use of the cite element to refer to speakers in a conversation, or individuals when quoting them: | |||
<div class="discussion"> | <div class="discussion"> | ||
* +1 [http://www.zeldman.com/superfriends/ HTML5 Super Friends], specifically [http://www.zeldman.com/superfriends/guide/#cite cite element: review of data]. | * +1 [http://www.zeldman.com/superfriends/ HTML5 Super Friends], specifically [http://www.zeldman.com/superfriends/guide/#cite cite element: review of data]. | ||
* +1 [[Tantek]] | * +1 [[User:Tantek|Tantek]] | ||
* +1 [ | * +1 [[User:Adactio|Jeremy Keith]] | ||
* Bruce Lawson, article agreeing with Tantek, July 06 [http://www.brucelawson.co.uk/2006/breaking-news-w3c-specs-are-not-word-of-god/ Breaking news: w3c specs are not the Word of God] | * +1 [[User:Brucel|Bruce Lawson]], article agreeing with Tantek, July 06 [http://www.brucelawson.co.uk/2006/breaking-news-w3c-specs-are-not-word-of-god/ Breaking news: w3c specs are not the Word of God] | ||
* +1 [[User:Cssquirrel|Kyle Weems]] | |||
* +1 [[User:Erikvorhes|Erik Vorhes]] | |||
* +1 [[User:Themattharris|Matt Harris]] | |||
* -0 [[User:EdwardOConnor|EdwardOConnor]] | |||
* +1 [[User:Xanthir|Tab Atkins Jr.]] | |||
* +1 [http://www.rachaelmoore.name/web-design/html-web-design/citing-in-html5-cite-attribute-and-cite-tag/ Citing in HTML5] by Rachael L. Moore | |||
* +1 [[User:Tcaspers|Tomas Caspers]] | |||
* +1 [[User:NickFitz|NickFitz]] | |||
* +1 [[User:Asbjornu|Asbjørn Ulsberg]] | |||
* +1 [http://statichtml.com/2009/html5-cite-element.html HTML5's <cite> element: what is it good for?] by Steve Webster | |||
* +1 [[User:Urlyman|Jonathan Schofield]] | |||
* +1 [[User:Dalizard|Dimitar Haralanov]] | |||
* +1 [[User:Pigsonthewing|Andy Mabbett]] | |||
* +1 [[User:Tjameswhite|Tim White]] | |||
* +1 [[User:Tswicegood|Travis Swicegood]] | |||
* -1 [[User:Hsivonen|Henri Sivonen]] | |||
* +1 [[User:KevinMarks|Kevin Marks]] | |||
* +1 [[User:Stefsull|Stephanie (Sullivan) Rewis]] | |||
* +1 [[User:Kroc|Kroc Camen]]—See my [http://camendesign.com/abbr_redux article on abbr/dfn/cite usage]—Cite is “for giving credit” | |||
* +1 [[User:Suit|Suit]] because examples on various sites get this wrong (see [http://www.quackit.com/html_5/tags/html_cite_tag.cfm] for example) - its just confusing. | |||
</div> | </div> | ||
== | === articles on speaker cite === | ||
* [[ | Articles supporting the use of the cite element for marking up speakers: | ||
* <cite>[http://24ways.org/2009/incite-a-riot 24 Ways: Incite A Riot]</cite>, 2009-12-11, by Jeremy Keith | |||
=== speaker cite FAQ === | |||
Frequently Asked Questions about using the cite element for marking up speakers. | |||
==== how do you connect the speaker cite to what was said ==== | |||
'''Question:''' How could we connect the speaker, CITE to what was said, Q, without nesting? Perhaps using FOR, as in form labels:<pre><nowiki><cite for="good">Andy Mabbett</cite> said <q id="good">This is good</q>.</nowiki></pre>On the other hand, if we reverse that we could have a many-to-one relationship:<pre><nowiki><cite id="andy">Andy Mabbett</cite> said <q for="andy">This is good</q></nowiki> and later said <q for="andy">This is better</q>.</nowiki></pre> | |||
'''Answer:''' The existing [http://www.w3.org/TR/html401/struct/text.html#adef-cite-Q 'cite' attribute] on the <q> and <blockquote> elements can be used for this, in HTML4 and later: | |||
<pre style="background:#efe"><nowiki> | |||
<cite id="andy">Andy Mabbett</cite> said | |||
<q cite="#andy">This is good</q> | |||
and later said | |||
<q cite="#andy">This is better</q>. | |||
</nowiki></pre> | |||
=== speaker cite related === | |||
* [https://github.com/whatwg/html/blob/master/FAQ.md#the-cite-element-should-allow-names-of-people-to-be-marked-up HTML FAQ re cite and names of people] | |||
== references == | == references == | ||
* [http://www.w3.org/TR/html401/struct/text.html#edef-CITE HTML 4.01 definition of the CITE element] | * [http://www.w3.org/TR/html401/struct/text.html#edef-CITE HTML 4.01 definition of the CITE element] | ||
[[Category:Proposals]] |
Latest revision as of 13:32, 11 August 2017
Research, data, use cases, issues, and enhancements related to the HTML5 cite
element.
Speaker
Update 2014-11-14: The HTML spec has been changed to allow use of <cite> to refer to a speaker, and even includes an example of it: http://www.w3.org/html/wg/drafts/html/master/text-level-semantics.html#the-cite-element
The cite element has been used (and recommended to be used) to refer to speakers in a conversation, or individuals when quoting them, thus HTML5 should explicitly permit and encourage this use.
This section serves to document both uses in the wild, and long-standing recommendations/documentations thereof.
Examples in the Wild
- 2003-08-23: Won’t somebody please think of the gerbils? by Mark Pilgrim:
I mark up names of people I link to (like in the list above) with the CITE tag, and I have a script that runs every night that aggregates those tags and creates posts by citation.
- transcript of the presentation “What Brian Cant Never Taught You About Metadata”, by Drew McLellen (this is from a template I provided the transcription company; all others are similar structure. brucel)
- Many blog posts on adactio.com, e.g Blame from 2008-01-09:
...something Bruce Sterling said at last year’s South by Southwest...
- Default WordPress theme ("Kubrick") uses cite for name of commenters. That's approx 46 bajillion instances.
- The transcripts for comics (#34 and onward) at CSSquirrel. The links to the transcripts are hidden from sighted users, one example is: Transcript #35 2009-09-08
- 2005-05-16: Speakers in this Towneley Lazarus play edition are identified using CITE.
- Testimonials on the website for Go Figure Inc. use cite to denote the names/locations of the people who provided the testimonial
- The Law Offices of Thomas G Guiney uses cite to mark up the names of speakers for testimonial quotes.
- Podcast transcript from dConstruct 2009 (more)
- Various "conversations"/transcripts at Petroglyphs, e.g. dialogue, and CSS classes defined for terms, titles, etc. (XMDP)
- any article at Einfach für Alle (major german accessibility resource), e.g. [1] (see sidebar, 4th box from top labelled "mehr dazu:") uses cite to mark up authors' names
- any articles on La Grange with a quote from a book or poem, and in addition any kind of references to a blog post. cite class="auteur" and cite class="title" for author and title respectively.
- 2011-06-07: Wikipedia marks the autor inside a blockquote with the cite-Element: en Wikipedia (12379 uses), de Wikipedia (24922 uses)
Documentation
- 1998-04-24 HTML 4.0 REC
Contains a citation or a reference to other sources.
As <CITE>Harry S. Truman</CITE> said,
<Q lang="en-us">The buck stops here.</Q>More information can be found in <CITE>[ISO-0000]</CITE>.
- 1999-12-24 HTML 4.01 REC (same definition and examples as quoted above).
- 2005-03-13: The Elements of Meaningful XHTML presentation (to an overflowing room at SXSW Interactive 2005 in Austin, TX) specifically, slide10 and following document blog quote markup, and slide 19 and following document conversation markup.
- 2005-09-29: update: The Elements of Meaningful XHTML presentation (to a packed room at Web Essential 05 in Sydney Australia) again slide 10 and following, and slide 34 and following respectively.
- ...
Counter-arguments
original intent of cite element
- 2007-06-07 Dan Connolly, Editor of HTML 2.0, said in IRC that
<cite> was supposed to capture the chicago-manual-of-style idiom for titles of works. I have lost track of what it means these days.
- This may have been the original intent (original theoretical purity), however, based on the example in the HTML4 spec(s) and adoption by the web community over the past 10+ years (see above examples in the wild), it makes more sense to define the <cite> element per actual usage (preferring authors), rather than original intent (theoretical purity), per the priority of constituencies HTML design principle. - Tantek 22:18, 13 August 2010 (UTC)
- "DanC said allowing <cite> for speakers was a bug in HTML 4 that happened because he was asleep at the wheel."
- Regardless of what DanC as a specifier may have intended, the authors have widely adopted the usage of cite for speakers, and thus since authors are considered over specifiers (per above-referenced design principle), we should prefer author usage over original specifier intent.
speakers are not italicized typically
- "Since speakers aren't italicized typically, using <cite> for them doesn't really make sense. "
- This sounds like either an argument from presentation, which seems backwards, as semantics should be determined first, and then authors can style semantics however they wish, or it's an argument from default presentation implementation, in which case once again per priority of constituencies HTML design principle, since authors are considered over implementers, we should respect author usage of cite for speakers over any particular implementer opinion of what cite should do or look like.
- The Design Principles don't support the notion of determining semantics first. In fact, the Design Principles were carefully drafted not to treat semantics as having any value on their own right but only as a means to a useful end (such as Device Independence or Accessibility). As for considering authors over implementors or specifiers, we should consider whether an author who hasn't been exposed to advocacy that tries to rationalize the feature set of HTML4 would find a need to mark up speakers in a way that italicizes by default and required additional work to un-italicize as opposed to not marking up speakers at all all using the
b
element to bold speakers where required by a newspaper-like house style. That is, what authors do after having been exposed to advocacy is bad evidence for determining the needs the authors would have on their own initiative.
- The Design Principles don't support the notion of determining semantics first. In fact, the Design Principles were carefully drafted not to treat semantics as having any value on their own right but only as a means to a useful end (such as Device Independence or Accessibility). As for considering authors over implementors or specifiers, we should consider whether an author who hasn't been exposed to advocacy that tries to rationalize the feature set of HTML4 would find a need to mark up speakers in a way that italicizes by default and required additional work to un-italicize as opposed to not marking up speakers at all all using the
- This sounds like either an argument from presentation, which seems backwards, as semantics should be determined first, and then authors can style semantics however they wish, or it's an argument from default presentation implementation, in which case once again per priority of constituencies HTML design principle, since authors are considered over implementers, we should respect author usage of cite for speakers over any particular implementer opinion of what cite should do or look like.
Opinions
Opinions on whether HTML5 should explicitly permit and encourage use of the cite element to refer to speakers in a conversation, or individuals when quoting them:
- +1 HTML5 Super Friends, specifically cite element: review of data.
- +1 Tantek
- +1 Jeremy Keith
- +1 Bruce Lawson, article agreeing with Tantek, July 06 Breaking news: w3c specs are not the Word of God
- +1 Kyle Weems
- +1 Erik Vorhes
- +1 Matt Harris
- -0 EdwardOConnor
- +1 Tab Atkins Jr.
- +1 Citing in HTML5 by Rachael L. Moore
- +1 Tomas Caspers
- +1 NickFitz
- +1 Asbjørn Ulsberg
- +1 HTML5's <cite> element: what is it good for? by Steve Webster
- +1 Jonathan Schofield
- +1 Dimitar Haralanov
- +1 Andy Mabbett
- +1 Tim White
- +1 Travis Swicegood
- -1 Henri Sivonen
- +1 Kevin Marks
- +1 Stephanie (Sullivan) Rewis
- +1 Kroc Camen—See my article on abbr/dfn/cite usage—Cite is “for giving credit”
- +1 Suit because examples on various sites get this wrong (see [2] for example) - its just confusing.
articles on speaker cite
Articles supporting the use of the cite element for marking up speakers:
- 24 Ways: Incite A Riot, 2009-12-11, by Jeremy Keith
speaker cite FAQ
Frequently Asked Questions about using the cite element for marking up speakers.
how do you connect the speaker cite to what was said
Question: How could we connect the speaker, CITE to what was said, Q, without nesting? Perhaps using FOR, as in form labels:
<cite for="good">Andy Mabbett</cite> said <q id="good">This is good</q>.
On the other hand, if we reverse that we could have a many-to-one relationship:
<cite id="andy">Andy Mabbett</cite> said <q for="andy">This is good</q> and later said <q for="andy">This is better</q>.</nowiki>
Answer: The existing 'cite' attribute on the <q> and <blockquote> elements can be used for this, in HTML4 and later:
<cite id="andy">Andy Mabbett</cite> said <q cite="#andy">This is good</q> and later said <q cite="#andy">This is better</q>.