authorship

 authorship  is how to indicate who the author is for a post, and an algorithm that determines the author of a post.

See the specification to implement the algorithm:
 * authorship-spec

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  or   property with an embedded h-card, e.g.

Example:

  Author Name  This is an example note

Author information in a header or footer
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  inside your post h-entry (an invisible link to your home page), and ensure the h-card in your header or footer has a   property that also links to your home page.

Example:

This is an example note 

...

  Author Name 

(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
See

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  property on that feed, either as a full h-card or referencing an h-card in the header or footer as described above.

Example:

  Author Name 

This is an example note This is an example note

(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  property in each h-entry that shares the same   property as your header or footer h-card.

Example:

This is an example note  This is an example note  ...    <img src="/me.jpg"> Author Name </a>

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  property in each post or feed.

Example permalink:

This is an example note </a>

Home page:

... <img src="/me.jpg" class="u-photo"> Author Name</a> ...

(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:
 * https://sturdy-backbone.glitch.me/

You can use the preview feature of Monocle to see if a feed or post will look good in a reader:
 * https://monocle.p3k.io/preview

How to determine
See authorship-spec.