post format
posts are markdown (.md
) or html (.html
) fragments with html “front matter” for metadata. the front matter includes…
<link rel="archived" href>
- link to the original post, for imported posts.
<link rel="references" href>
- one for each post being replied to, including the posts that those posts are replying to (these are not resolved recursively).
<meta name="title" content>
- title or “headline” of the post.
<meta name="published" content>
- date the post was published, as a rfc 3339 timestamp.
<link rel="author" href name>
- author of the post. the
name
here is used in atom output, while the other author metadata is used in html output. <meta name="author_display_name" content>
- name of the author, used in html output.
<meta name="author_display_handle" content>
- handle of the author, used in html output. this is
@projectName
for chosts (autost cohost2autost
), or a domain name likeexample.com
for other imported posts (autost import
). we recommend setting this to a domain name likeexample.com
, but it can be anything really. <meta name="tags" content>
- one for each tag associated with the post.
<meta name="is_transparent_share">
- if present, hide the post content area entirely. this is used by
autost cohost2autost
to make cohost’s “transparent shares” look nicer.
see also templates/post-meta.html
and PostMeta
internally.