Camen Design

c share + remix

Me, Myself and I — or:
Abbreviations, Definitions & Citations Revisited

  1. The Abbreviation Element
    1. Rules for Using <abbr>
  2. The Definition Element
    1. Rules for Using <dfn>
  3. The Citation Element
    1. Rules for Using <cite>

In three years of writing these elements continue to confuse me. Well, it’s not that they confuse me, but that I come across so many examples of their use that I always feel like a clear definition is right on the tip of my tongue but I can never grasp it clearly.

I started How To Use <abbr> In HTML5, and In General by admitting that I had to write it because I wasn’t clear myself on the optimum use of these elements. I now have to say that that article is also wrong and it’s time once again to explore my increased understanding.

The rules presented here are my own personal best practices designed to be easy to remember, implement and to serve practical purposes rather than markup for markup’s sake. They are, in my opinion, the most elegant and clear guidelines on the use of these elements on the Internet.

The Abbreviation Element

The HTML5 spec defines <abbr> as: an abbreviation or acronym, optionally with its expansion. The title attribute may be used to provide an expansion of the abbreviation. The attribute, if specified, must contain an expansion of the abbreviation, and nothing else.

Note carefully the wording “expansion”. Expansion, not definition. That means that the abbr element is ideal for expanding written forms into spoken forms, and this is how I recommend you use it.

<abbr title="et cetera">etc.</abbr>

Here we are not defining what etc. means (“and the rest”), we are expanding it into its spoken form for readability.

Use of abbreviations should serve some practical purpose on the page, even if not visible. The biggest problem I ran into was using the abbr element for any and every initialism I came across, like “HTML”, “CSS”, “PHP” &c. This only served to benefit OCD rather than readers. When you are using “<abbr>HTML</abbr>” what exactly are you saying? It says that this is an abbreviation of some sort but initialisms are not spoken in any other way than they are written, because the letters are capitalised it is already evident that that it is an abbreviation and should be read letter-by-letter. Therefore marking this up does not help authors, screen readers, browsers or users. It’s obsessive markup and nothing else.

For the sake of sanity and to provide simplicity that can be remembered and followed <abbr> should be used for one, and only one purpose: to provide a human-speakable form of any phrase or text. Read your writing and anywhere the exact words you speak does not match what symbols appear on the page you need an abbr element.

Price <abbr title="does not equal">!=</abbr> <abbr title="total cost of ownership">TCO</abbr>

Here, the expansion of TCO is not to define it for those not in the know, it is to shape the spoken form into a more natural and flowing style that is easier on the ears than “price exclamation mark equals tee see oh” and is how I would personally read this aloud to others who didn’t have the text to hand.

What about abbreviations without titles? Where should they be used, if at all? Whilst I have told you to not use abbr for capitalised initialisms read letter by letter, there are initialisms that should be read as they are written—acronyms. “RAID” for example, despite being capitalised like “HTML” should not be read as “Arr aye eye dee”. Because HTML5 removed <acronym> this is the only instance you should use abbr without a title to indicate to users and screen readers that the initialism should be pronounced rather than spelt out.

GOOD:	<abbr>PAL</abbr>, not NTSC.

Rules for Using <abbr>

With these three rules you will save yourself writing more markup than is necessary and give your use of abbr a true purpose that encapsulates the human-spoken aspect of your writing.

The Definition Element

The dfn element is under used and abbr is commonly mistaken for it instead. abbr is not for defining what an initialism stands for. Don’t ever do this:

BAD:	I made some <abbr title="American Standard Code for Information Interchange">ASCII</abbr> art.

If you worry that a term you have used is alien to your users and you should spell it out, use <dfn> instead.

GOOD:	I made some <dfn title="American Standard Code for Information Interchange"><abbr>ASCII</abbr></dfn> art.

NB: “ASCII” is wrapped in an abbreviation element because it is an initialism that is pronounced as written, rather than spelt out (as per abbr rule 3). If we were defining “HTML” instead, this would not be the case.

You don’t have to restrict yourself to just initialisms when using dfn, any term or phrase that needs explaining is candidate for dfn. For example: (source)

"My hounds are bred out of the Spartan kind, so <dfn title="flews: pendulous or overhanging lateral parts of the upper lip of dogs, especially prominent in hounds">flew'd</dfn>" [Shakespeare].

That’s literally all there is to it!

Rules for Using <dfn>

The Citation Element

I saved the worst ’till last. The citation element encompasses a large amount of terminology in common use:

The cite 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, a legal case report, 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.

In one article I might reference various pieces of software (an electronic ‘work’) such as Flash, QuickTime, Firefox, Safari and so on almost a hundred times. This is too much to be marking up every single time a noun that falls into these categories turns up. It really doesn’t distinguish any meaning to do that.

It gets confusing very quickly as to what counts as a citation and what doesn’t especially with digital works. After tiring of writing hundreds of inane cite elements and constantly struggling to classify what falls into the category or not, I decided that in order for citations to be meaningful in your writing they should be about giving credit. This is most evident when quoting something:

		Here is Edward Bear, coming downstairs now, bump, bump, bump,
		on the back of his head, behind Christopher Robin.
	<cite>Winnie-the-Pooh<cite>, A.A.Milne

But also applies when naming the title of a book.

Buy your copy of <cite>The Lion, The Witch and The Wardrobe<cite> here.

This is easy with physical things, but what about website names, titles of blog posts, software names?

The rules I have adopted are specifically to be simple enough to remember, not full of confusing edge cases and quandaries, and to provide clarity and purpose for using <cite> in the first place.

Rules for Using <cite>

I am not an expert grammarian; these rules are personal preferences born out of the tens of thousands of lines I have written on this website over the last three years. I have tried to take all the edge cases I have come across and hone the use of these elements down to clear and concise usage. In writing this article I have gone back and used search and replace to update my site to follow these rules and have removed several thousand needless pieces of markup. From now on, these rules will guide me to use abbreviations, definitions and citations sparingly and in a meaningful way.

These rules do not represent the canon of HTML5 or the markup in general but are instead practical guidelines to their usage. Feel free to adapt these rules to your own preferences around syntax, semantics and stoicism.

If you would like to write less markup, perhaps consider using ReMarkable, my shorthand syntax for writing articles that includes markup for {abbr|abbreviations}, {{dfn|definitions}} and ~citations~ as well as much more. You can view the original markup for this article as an example.