IndieWebCamp is a 2-day creator camp focused on growing the independent web

p3k

This article is a stub. You can help the IndieWebCamp wiki by expanding it.

p3k-logo.png

pзk

pзk (pronounced "peek") is the name of the software that runs aaronparecki.com and caseorganic.com

Screenshots

Writing a note (mini UI)
Writing a note (full UI)
Writing an article


Other

Source Code

While the core of p3k is not open source, many components are. Below is a list of the components used in p3k.

I am working to pull out more parts of p3k into libraries and will keep this list up to date as I progress.

Features

IndieWeb Support

Publishing Other Content

Aside from notes, articles and replies, I also publish the types of content listed below.

Sleep

Example: http://aaronparecki.com/metrics/2012/12/03/075900/

I've had the best luck with the Jawbone UP for tracking my sleep. I have logs now since November 2011 of how much I've slept every night.

The Jawbone app has an interface for adding a note to a sleep record. Here is a screenshot showing an example of adding a note to a sleep record.

Weight

Example: http://aaronparecki.com/metrics/2013/09/15/081800/

I use the Withings scale to track my weight. Through a series of convoluted steps, the data eventually ends up on p3k and is published here.

Currently every time there is a new measurement it results in a post on my site. I may change this to post once a week showing a small graph instead.

Pushups

Example: http://aaronparecki.com/metrics/2013/11/28/143242/

I wrote a simple simple pushup-tracking app which makes POST requests directly to my server, creating these posts.

Backwards-Compatible Support

Notes vs Articles

  • Note: a note is plaintext only, HTML markup is not allowed. There is some auto-linking code that adds links around @mentions, URLs and hashtags. Any recognized URLs like images and video are embedded below the post.
  • Article: an article is a long form entry that supports any HTML.
  • See also: Semantics Of Article-Note Distinction

Storing External Content

When displaying external content on my site for reply-context and comments, p3k stores both the raw HTML and the parsed JSON for external pages on disk. Below is a screenshot showing how the folder structure maps to the URLs.

p3k-external-files.png

Working On

The things I am currently implementing in p3k:

PESOS photos from Instagram

  • Subscribe to the realtime API for my account
  • My server receives a POST request when I post a new photo
  • Download the photo and create a new photo post on my site
  • Find the first comment on the photo (the photo caption on Instagram)
  • Delete the first comment
  • Re-add the comment appending my permalink for the photo

4 comments

Itching

These are a collection of annoyances that have respective features / improvements. As their annoyance level bubbles to the top, they're likely to become concrete "Working On" tasks.

Create buttons to POSSE posts after they are created

Occasionally I find myself posting a note and afterwards wishing I had clicked the "POSSE to Facebook" checkbox in my interface.

When viewing a note, I should have a button I can press to POSSE to any of my POSSE destinations. I guess this will involve an intermediate interface element so that I can edit the text that will be sent to the POSSE destination.

1 comment

Refactor post types to have separate single & list templates

Currently my internal classes for post types only specify a view template for when the post is on its own page. (e.g. http://aaronparecki.com/notes/2013/12/06/1/indieweb-icon) When viewed in a list (e.g. http://aaronparecki.com/tag/indieweb) the HTML is handled by an entirely different part of the code.

Refactor so the Page classes have all the knowledge they need to render items in both views. This will help with maintaining views for different post types.

Need Further Thought

Checkins

I have been using Foursquare consistently for a number of years now, and it is the authoritative source of every venue I've been. I know that if I have never checked in somewhere before on Foursquare, I actually have never been there before.

While my Foursquare feed is currently public, I'm reconsidering whether I want my "IndieSquare" feed to be completely public. I may end up being more selective about the checkins I make public instead, and keep my full checkin history private.

Examples of public checkins often include a short note from me along with the venue for things like checking in to a venue for a public event, or checking in somewhere to say I'm going to be hacking there for a while inviting people to join me. When I check in to lunch two blocks away from my office, it's not that I don't want anyone to know I'm there, it's just that probably nobody cares and there usually isn't anything actionable that would come from them knowing anyway. Usually I'm getting something to go and don't have time to stay and talk anyway.

IndieSquare

Foursquare provides:

  • a push API so I can pesos checkins to my site in real time
  • lots of my friends still use it
  • the app still provides fun tidbits when I check in, like "you've been here 5 weeks in a row", etc
  • searching for venues is difficult to implement from scratch, and I'm not entirely happy with the OSM data, so using foursquare venues continues to be highest quality

Really getting annoyed that when Foursquare venues are renamed, merged or deleted, my own history is changed.

  • Figure out how to represent a "checkin" on my own site (see Creating content on the Indie Web for more thoughts)
  • Figure out how to store venues on my site (venue IDs, nice slugs, ???)
  • Build a basic interface for viewing "checkin" data
  • Syndicate out to Foursquare and possibly Facebook (although Facebook recently deprecated checkins in favor of attaching venues to notes)
  • Repurpose the Checkie app to search my site for venues and post checkins to my site first
  • Download all Foursquare history and create checkins on my site retroactively

Location

Since I carry an active GPS tracker at all times, I collect a large amount of location data. It is not automatically organized into "trips" or anything, it's just a raw stream. I've been considering various ways of publishing this for some time.

Currently I publish my current city as well as time zone of wherever I am on my home page. I do not yet have a feed available.

I'm considering publishing a new "location" post any time I change cities (or possibly also large neighborhood). Here is an example of publishing my city automatically to Facebook: http://www.flickr.com/photos/aaronpk/6962452588/

There are other non-venue locations I may want to publish, such as when I get into a neighborhood I haven't been to in a while. Ideally my phone would detect automatically when I've entered a new area or an area I haven't been to in a while. Probably I would want it to prompt me before publishing anything publicly. I could receive a push notification saying something like "It looks like you're in NW Portland for the first time since August! Publish this?"

Open Source

While the entire p3k stack is not open source, I have open-sourced many of the components. I've chosen to provide components of the stack rather than the whole thing because in reality nobody is going to want to use the exact same workflow I have built. Instead, components of my site can be re-used by others in their own way.

See #Source Code above.

Contents

Retrieved from "http://indiewebcamp.com/p3k"