Canonical format to include authors of "profound" blockquotes?

Swift Documentation
1

Not really a swift-specific question… but does anyone have anything like a good "canonical" format for adding an important or profound quotation that should include the author? I see this as sort of a subset of a blockquote… it's a blockquote along with the source:

“I, man, am regal — a German, am I!”
Alfred Matthew Yankovic

I wasn't able to find any examples along these lines in the swiftlang org… if you found any please let me know!

2

For what it’s worth, the HTML spec is quite explicit that the <blockquote> element should only contain the quoted text:

Attribution for the quotation, if any, must be placed outside the blockquote element.

blockquote itself has a cite="…" attribute that must, if present, contain the URL of the quoted document.

The user-visible citation outside the <blockquote> can be done with <cite>, optionally by wrapping both the quote and the citation in a <figure>/<figcaption> to associate one with the other.

Example from MDN:

<figure>
  <blockquote>
    <p>
      It was a bright cold day in April, and the clocks were striking thirteen.
    </p>
  </blockquote>
  <figcaption>
    First sentence in
    <cite
      ><a href="http://www.george-orwell.org/1984/0.html"
        >Nineteen Eighty-Four</a
      ></cite
    >
    by George Orwell (Part 1, Chapter 1).
  </figcaption>
</figure>

Now, whether you want to follow this guidance and how easy it is to express in Markdown/DocC is another question.

3 Likes