microsyntax

From IndieWeb


microsyntax refers to short text conventions for conveying specific semantic meaning, such as an "@" prefix indicating a (user)name, or "#" prefix indicating a hashtag (both conventions popularized by Twitter).

Why

Why author

When writing/authoring, itโ€™s often easier to use a little bit of inline punctuation like an '@' or a '#' as a microsyntax to express some additional meaning rather than adding explicit markup or even markdown.

IndieWeb Examples

Many IndieWeb sites have examples of @-names, #hashtags, etc. See their specific sections for now (though many of those are for features in general, and need some amount of filtering for actual microsytnax examples). We could collect microsyntax-specific examples here, in addition to these links to other IndieWeb Examples sections, until we have enough of each.

Prior work

Please see previous work:

Brainstorming

A place to brainstorm indieweb microsyntax especially for plaintext notes, and POSSEing of specific types of posts to plaintext-like POSSE destinations (e.g. Twitter])

(this overall section could use some gardening and updating, many of these never went anywhere and should likely be archived, and some have been implemented and should be documented with real world examples)

related brainstorming

See the following for brainstorming on other pages related to microsyntaxes:

at-sign for in-reply-to URL

  • @example.com/some-post => <a href="http://example.com/some-post" class="u-in-reply-to">
    • We need pfefferle and acegiak to clarify their use case. Just adding links to the users domain in your post will send a webmention to the domain, so IMO it is unnecessary to prefix user domains with @ so I'm assuming they meant post urls. —Sandeep Shetty
      • The idea was to generate an easy mardownish way to generate semantic links, not really meant to display to any enduser - Matthias Pfefferle
    • No one does this currently (any real world example?) - feels a bit forced. People already think of "@" as meaning "hey this person". - Tantek 15:54, 21 June 2013 (PDT)
    • -1 agreed, this example is forced and doesnโ€™t reflect real world usage. @mentions succeeded because they were a paved cowpath, it defeats the object to try to repurpose them --Waterpigs.co.uk 16:07, 21 June 2013 (PDT)
    • "we wanted a way to mark which one was the reply-to without needing to edit the html because we want the plugins to be accessible to non-technical wordpress users - plus, adding the html manually would be tiresome, so we're trying to work out a way to make it quick and easy" -acegiak
    • Seems OK to me but I've settled on re: http://example.com/some-post in my personal logs & recently on my site (e.g.1, e.g.2; just using as minimal reply context for now as I'm pretty sure others do). I've been only using it at the start of an entry but I think you could safely use it anywhere. Colintedford.com 21:11, 7 January 2015 (PST)

heart for like

  • <3 - ASCII heart, used as substitute for โ€œloveโ€
  • <3 example.com =><a href="http://example.com" class="u-like">

paren Y for thumbs up

Some research:

  • (Y) - Used for the thumbs up emoticon on Skype, Facebook

metrics and exercise

Various metrics could use emoji, i.e. when POSSEing to text-like destinations like Twitter

  • ๐ŸŒœSlept 8 hours
  • ๐Ÿšฒ Evening Ride
  • ๐Ÿš™ Drove 3.2 miles in 25 minutes
  • ๐Ÿƒ Ran 3.2 miles in 25 minutes
  • ๐Ÿšถ Walked 3.2 miles in 50 minutes
  • ๐Ÿ’ช Did 13pushups
  • ๐Ÿ‘ฃ Weighed 153.3lbs

quotations

A minimal plaintext syntax for posting quotations which an auto-linker/formatter could use to style it properly.

โ€œthe personal blog, yournameโ€ขcom, where you control everything and get to do whatever the hell pleases youโ€ http://avc.com/2014/08/the-personal-blog/ #indieweb

https://twitter.com/kevinmarks/status/504674367565869056

โ€œI miss being able to engage other people online in discussions that are actually productive.โ€ @espiers http://elizabethspiers.com/2014/08/25/here-i-go-again-on-my-own/ #indieweb

https://twitter.com/kevinmarks/status/504675650943582208

"I wanted to reply to that comment, but could not for the life of me, log into WordPress to leave it. So Iโ€™ll blog about it instead." http://avc.com/2014/08/the-personal-blog/

http://aaronparecki.com/notes/2014/08/27/1/

These examples consist of the following components:

  • quoted text wrapped in standard or curly quotes ("" or โ€œโ€)
  • source URL
  • optional author name
  • optional hashtags

hat for footnotes

Like "^1", see:

See Also