authorship
authorship is how to indicate who the author is for a post, and an algorithm that determines the author of a post.
Why
You should clearly indicate who is the author of a post so when other sites summarize or reply to your post, they can properly recognize the author(s)!
How to publish
Publishing your authorship of a post is designed to be both easy and flexible to adapt to a variety of publishing methods and designs. Any of the following are fine.
Choose whichever is the least work for you, your site, your theme(s), your code, and easiest for you to maintain!
Authorship for individual posts
For individual posts, (such as a post displayed on its permalink), you have a few options for how to provide authorship information.
Full author information in each post
If your posts have your name and photo already visible, then your h-entry for the post can include a full h-card with the complete author info for the post, by adding an explicit p-author
or u-author
property with an embedded h-card, e.g. <a class="u-author h-card" href="/">β¦</a>
Example:
<div class="h-entry"> <a href="/" class="u-author h-card"> <img src="/me.jpg" class="u-photo"> <span class="p-name">Author Name</span> </a> <div class="e-content">This is an example note</div> </div>
If you have an h-card on your website in a header or footer, you can avoid duplicating the author information inside the h-entry by establishing a link between the two: add a <a class="u-author" href="/"></a>
inside your post h-entry (an invisible link to your home page), and ensure the h-card in your header or footer has a url
property that also links to your home page.
Example:
<div class="h-entry"> <div class="e-content">This is an example note</div> <a href="/" class="u-author"></a> </div> ... <footer> <a href="/" class="h-card"> <img src="/me.jpg" class="u-photo"> <span class="p-name">Author Name</span> </a> </footer>
(This example has a minimal h-card but you can include as many details in the h-card as you would like)
Authorship on a dedicated page
Authorship for streams of posts
For a page with a stream of posts (like on an archive, homepage, etc.), you may want to avoid duplicating authorship information on each individual post.
Include authorship with h-feed markup
If you have a top-level h-feed, then you can include a u-author
property on that feed, either as a full h-card or referencing an h-card in the header or footer as described above.
Example:
<div class="h-feed"> <a href="/" class="u-author h-card"> <img src="/me.jpg"> Author Name </a> <div class="h-entry"> <span class="e-content">This is an example note</span> </div> <div class="h-entry"> <span class="e-content">This is an example note</span> </div> </div>
(This example has a minimal h-card but you can include as many details in the h-card as you would like)
Include authorship without h-feed markup
If you don't have an h-feed and want to display your author info in your website header or footer, you will need to include an invisible u-author
property in each h-entry that shares the same url
property as your header or footer h-card.
Example:
<div class="h-entry"> <span class="e-content">This is an example note</span> <a href="/" class="u-author"></a> </div> <div class="h-entry"> <span class="e-content">This is an example note</span> <a href="/" class="u-author"></a> </div> ... <footer> <a href="/" class="h-card"> <img src="/me.jpg" class="u-photo"> <span class="p-name">Author Name</span> </a> </footer>
Dedicated author page
If you don't want to show any author information on your post permalinks or feed pages, you can create an h-card on your home page and link to it from an invisible u-author
property in each post or feed.
Example permalink:
<div class="h-entry"> <div class="e-content">This is an example note</div> <a href="/" class="u-author"></a> </div>
Home page:
... <div class="h-card"> <img src="/me.jpg" class="u-photo"> <a href="/" class="u-url p-name">Author Name</a> </div> ...
(This example has a minimal h-card but you can include as many details in the h-card as you would like)
Validate
Try this authorship testing tool to validate your authorship markup - it will tell you how the authorship algorithm finds your author information on a permalink:
You can use the preview feature of Monocle to see if a feed or post will look good in a reader:
How to determine
See authorship-spec.
See Also
- authorship-spec
- discovery
- posts
- h-entry
- h-card
- rel-author
- https://sturdy-backbone.glitch.me/ ββ―a testing tool by Sven Knebel to check whether your authorship markup is working
- Why: Because heuristics will get it wrong, sometimes hilariously: https://twitter.com/AlexanderRKlotz/status/1252389218514427909
- "Google Scholar has parsed this cafeteria lunch menu as an author list, and it's delightful" @AlexanderRKlotz April 21, 2020
- https://twitter.com/thornet/status/1475924019308371978
- "βThe meaning of authorship depends heavily on how we draw the boundaries of our selfhood.β
Nice line from its footnotes." @thornet December 28, 2021
- "βThe meaning of authorship depends heavily on how we draw the boundaries of our selfhood.β