posts

From IndieWeb
Jump to: navigation, search

Post or posts may refer to individual pieces of content published on an indieweb site such as notes, articles, & responses, or the act of creating the aforementioned content (present tense), or Posts about the IndieWeb.

In list form:

Having multiple posts on your own site is a requirement for IndieMark Level 1.

Contents

Why

Why you should publish posts on your own site: see why.

How

How to publish a post.

Kinds of Posts

Experience has shown that there are different kinds of posts on indieweb sites, and publishing and display interfaces for them vary by type. Here are a few kinds of posts that indieweb community members are currently publishing:

Roughly ordered by apparent/anecdotal indieweb posting frequency across different sites / implementations:

Posted by only three indieweb sites, worthy of consideration for post type discovery

Posted by only a couple of indieweb sites so far

Posted by only one indieweb site so far:

Posts of various types may also be implicit mentions of other posts by linking to them, but the difference only matters to the receiver — i.e. there is no dedicated UI for people to publish a “mention” of something.

Indieweb community members are working on publishing these real soon now:

  • ...

Merely gleams in various eyes:

  • ...

Inferring post kinds from properties

Alternative perspective: instead of explicit post kinds, infer the post kind (and thus presentation/UI) by what aspects/properties a post has. E.g.:

The above list is very roughly ordered and likely requires implementation experience (of multiple post types/kinds) to better understand which properties should more primarily determine a post type than others.

Combinations of the above will also have to be explored to see if they make sense, and given multiple possible inferred post kinds, which should "win" in terms of driving the presentation/UI. E.g.

  • with an embedded image and with a p-location venue -> checkin with photo. E.g. this post by aaronpk should be considered a check-in. Reasoning:
    • the p-location applies to the whole h-entry, not the specific u-photo, thus making the h-entry primarily a checkin, and secondarily, happening to have a photo
    • the alternative, a photo post tagged with a venue location, should be expressed by having the p-location be a property of an object nested on the u-photo, e.g. a "u-photo h-item" or "u-photo h-photo" which then has a "p-location h-card" inside it. The actual nested root class (h-item or h-photo, these are (mostly) just brainstorms) matters less than there happening to be such a nested root class.

Articles about implied post types

New Post Types

In general, we should avoid creating new post types/kinds.

Both individually and as a community. Simpler is better and all that.

The key is whenever you think you have something new to post, try posting it as your simplest existing post type, which are likely just notes, maybe with tags, e.g. what User:Waterpigs.co.uk does with steps, and User:Sandeep.io does with tags as well. Then document here on the wiki why/how that doesn't work if you run into problems.

One reason why re-using an existing post type might "not work" is that you really want to present it differently, provide a specific UX for a particular kind of posts differently from any existing post type. This is the *primary* reason that should drive any desire to create new post types.

If there's no reason to present a different UX, then you likely shouldn't be thinking about a new post type.

And even if you do want to present a different UX, consider simply using the existence of specific properties (e.g. in-reply-to for replies) to drive the presentation of a different UX, rather than creating a new post type.

If you get that far, step one, document real world examples of such new UX (even from silos) with screenshots/mockups embedded on this wiki.

After you've documented existing UX of a post type, see if you can find something similar in ActivityStreams's similar concept of "object types", and thus re-use their name/terminology.

Pieces of a Post

At a minimum, indieweb posts should have:

  • permalink URL
  • contents of the post
  • date published of the post

and likely:

  • author of the post - even if it's self-evident from the domain.

and perhaps:

  • avatar of the author of the post

All marked up with h-entry+h-card naturally.

Additional pieces

Additional information about the post:

  • date updated
  • name - (AKA "title") of a post (articles typically have titles)
  • location - (AKA "geo") that the post is about, e.g. photos taken at a location, checkins. E.g. Instagram locations are "locations" that the photos are of, Wikipedia uses the geo microformat on pages to indicate location information about the subject of the page.
  • changes - ideally marked up with <ins> and <del>
  • from - location published/posted from, not necessarily the same as location that the post is about. E.g. Twitter locations are "published from" locations.
  • using - tool or application that was used to author / publish the post.

Footer sections

Footer sections. Posts sometimes have footers with links, references etc. Here are few known footer sections with a real world indieweb example in the wild of each.

  • Previously - links to previous posts by the author on the same or similar subjects. E.g. [1]
  • References - explicit list of citations supporting the post, from inline hyperlinks in the post, and/or [number] references inline in post text.
  • Elsewhere - a list of links to POSSE syndicated copies of the post on other services. E.g. [2]
    • Elsewhere of this Translation - a list of links to POSSE syndicated copies of a post which is a translation of another post.
  • Translations - links to translations of the post. E.g. [3]
  • Comments - a list of comments (in time sequence order) about or replying to the post. E.g. [4]
  • Referencing Articles / Mentions - other discussions / articles spawned as a result of (after) the post, or other related reading that cites the post. A that reader already took the time to read it and have the post in mind as context, may want to read articles that build upon it. E.g.: [5].
  • Likes/favorites - primarily on silos but capturing here as something that indieweb community members have expressed an interest in implementing on their own posts
  • Tags - often parsed from hashtags within the post. Examples: [6] [7]
  • Navigation - usually previous/next links between posts. Examples: [8] [9] [10] [11]
  • ... have a different section in the footer of your posts? Add it here with a link to a real world example.

All marked up with h-cite+h-card naturally (except maybe the comments can be just h-entry+h-card).

Inline and other references

Some post to other post or page references are inline in a post or elsewhere but not in a separate footer per se.

Posting practices

IndieWeb community members' thoughts on some of the details of how they post and why:

Post design

There's many ways to style and display posts, on their own on permalink pages, as part of a stream (e.g. a home page or feed), and in a collection in an archive.

Here are some posts about post display design:

Testing

Here are some tools for testing indieweb posts:

See Also

Retrieved from "https://indieweb.org/posts"
Personal tools
Namespaces
Variants
Actions
Recent & Upcoming
Resources
Toolbox