Making IndieWeb Friendly WordPress Themes: An IndieWebCamp Popup Session

The IndieWeb WordPress community could use some more theme options.

Let’s get together as a community and host a theme raising (a play on the idea of the old barn raising). We can all work/hack together to make some of the popular WordPress themes more IndieWeb friendly. We’ll discuss methods for adding the necessary Microformats and best ways to indieweb-ify a WordPress theme.

Either bring your own favorite theme or work from one on a list.

All levels are welcome!

Beginners and those without coding experience are welcome/encouraged to attend. We’ll try to help newcomers learn to begin tinkering with some WordPress theme code. If you don’t have a GitHub account yet, you might create one beforehand and we’ll show you how to use it for development, but even without it you can still do a lot with just a text editor.

Details

When: 2020-09-26 9:30 – 11:30 AM (Pacific) / 12:30 – 2:30 PM (Eastern)
Event page: https://events.indieweb.org/2020/09/making-indieweb-friendly-wordpress-themes-8fs9gAVX3OkV
hashtag: for social media and used to create an Etherpad for the session:
Etherpadhttps://etherpad.indieweb.org/WPandMicroformats for note taking during the session
Streaming video/audio platform: Zoom (link to come)
Demos: Yes – when we’re done, show off how well your new hacked theme works on your site.

RSVP

Newcomers can post a comment on this post below or reply yes via Twitter to https://twitter.com/ChrisAldrich/status/1300562134699393024. Or you can feel free to just show up on the morning of the event.

If you feel able, RSVP at Meetable or post an indie RSVP on your own website.

Prerequisites

Bring your own theme or a theme you’d like to make more IndieWeb friendly by adding Microformats v2 support. Ideas for possible themes can be found at https://indieweb.org/WordPress/Development#Themes

(Optional) Create a GitHub account which you can use/learn during the process. Those who don’t want a GitHub account can simply use their text editor of choice to modify the relevant theme files.

Volunteers

We’re always happy to have additional help! If you’d like to volunteer or help organize and run the session, please touch base with Chris Aldrich or David Shanske in the IndieWeb Meta chat room.

I look forward to seeing everyone there!

A note taking problem and a proposed solution

tl;dr

It’s too painful to quickly get frequent notes into note taking and related platforms. Hypothes.is has an open API and a great UI that can be leveraged to simplify note taking processes.

Note taking tools

I’ve been keeping notes in systems like OneNote and Evernote for ages, but for my memory-related research and work in combination with my commonplace book for the last year, I’ve been alternately using TiddlyWiki (with TiddlyBlink) and WordPress (it’s way more than a blog.)

I’ve also dabbled significantly enough with related systems like Roam Research, Obsidian, Org mode/Org Roam, MediaWiki, DocuWiki, and many others to know what I’m looking for.

Many of these, particularly those that can be used alternately as commonplace books and zettelkasten appeal to me greatly when they include the idea of backlinks. (I’ve been using Webmention to leverage that functionality in WordPress settings, and MediaWiki gives it grudgingly with the “what links to this page” basic functionality that can be leveraged into better transclusion if necessary.)

The major problem with most note taking tools

The final remaining problem I’ve found with almost all of these platforms is being able to quickly and easily get data into them so that I can work with or manipulate it. For me the worst part of note taking is the actual taking of notes. Once I’ve got them, I can do some generally useful things with them—it’s literally the physical method of getting data from a web page, book, or other platform into the actual digital notebook that is the most painful, mindless, and useless thing for me.

Evernote and OneNote

Older note taking services like Evernote and OneNote come with browser bookmarklets or mobile share functionality that make taking notes and extracting data from web sources simple and straightforward. Then once the data is in your notebook you can actually do some work with it. Sadly neither of these services has the backlinking functionality that I find has become de rigueur for my note taking or knowledge wrangling needs.

WordPress

My WordPress solutions are pretty well set since that workflow is entirely web-based and because WordPress has both bookmarklet and Micropub support. There I’m primarily using a variety of feeds and services to format data into a usable form that I can use to ping my Micropub endpoint. The Micropub plugin handles the post and most of the meta data I care about.

It would be great if other web services had support for Micropub this way too, as I could see some massive benefits to MediaWiki, Roam Research, and TiddlyWiki if they had this sort of support. The idea of Micropub has such great potential for great user interfaces. I could also see many of these services modifying projects like Omnibear to extend themselves to create highlighting (quoting) and annotating functionality with a browser extension.

With this said, I’m finding that the user interface piece that I’m missing for almost all of these note taking tools is raw data collection.

I’m not the sort of person whose learning style (or memory) is benefited by writing or typing out notes into my notebooks. I’d far rather just have it magically happen. Even copying and pasting data from a web browser into my digital notebook is a painful and annoying process, especially when you’re reading and collecting/curating as many notes as I tend to. I’d rather be able to highlight, type some thoughts and have it appear in my notebook. This would prevent the flow of my reading, thinking, and short annotations from being subverted by the note collection process.

Different modalities for content consumption and note taking 

Based on my general experience there are only a handful of different spaces where I’m typically making notes.

Reading online

A large portion of my reading these days is done in online settings. From newspapers, magazines, journal articles and more, I’m usually reading them online and taking notes from them there.

.pdf texts

Some texts I want to read (often books and journal articles) only live in .pdf form. While reading them in an app-specific setting has previously been my preference, I’ve taken to reading them from within browsers. I’ll explain why in just a moment, but it has to do with a tool that treats this method the same as the general online modality. I’ll note that most of the .pdf  specific apps have dreadful data export—if any.

Reading e-books (Kindle, e-readers, etc.)

If it’s not online or in .pdf format, I’m usually reading books within a Kindle or other e-reading device. These are usually fairly easy to add highlights, annotations, and notes to. While there are some paid apps that can extract these notes, I don’t find it too difficult to find the raw file and cut and paste the data into my notebook of choice. Once there, going through my notes, reformatting them (if necessary), tagging them and expanding on them is not only relatively straightforward, but it also serves as a simple method for doing a first pass of spaced repetition and review for better long term recall.

Lectures

Naturally taking notes from live lectures, audiobooks, and other spoken events occurs, but more often in these cases, I’m typically able to type them directly into my notebook of preference or I’m using something like my digital Livescribe pen for notes which get converted by OCR and are easy enough to convert in bulk into a digital notebook. I won’t belabor this part further, though if others have quick methods, I’d love to hear them.

Physical books

While I love a physical book 10x more than the next 100 people, I’ve been trying to stay away from them because I find that though they’re easy to highlight, underline, and annotate the margins, it takes too much time and effort (generally useless for memory purposes for me) to transfer these notes into a digital notebook setting. And after all, it’s the time saving piece I’m after here, so my preference is to read in some digital format if at all possible.

A potential solution for most of these modalities

For several years now, I’ve been enamored of the online Hypothes.is annotation tool. It’s open source, allows me reasonable access to my data from the (free) hosted version, and has a simple, beautiful, and fast process for bookmarking, highlighting, and annotating online texts on desktop and mobile. It works exceptionally well for both web pages and when reading .pdf texts within a browser window.

I’ve used it daily to make several thousand annotations on 800+ online web pages and documents. I’m not sure how I managed without it before. It’s the note taking tool I wished I’d always had. It’s a fun and welcome part of my daily life. It does exactly what I want it to and generally stays out of the way otherwise. I love it and recommend it unreservedly. It’s helped me to think more deeply and interact more directly with countless texts.

When reading on desktop or mobile platforms, it’s very simple to tap a browser extension and have all their functionality immediately available. I can quickly highlight a section of a text and their UI pops open to allow me to annotate, tag it, and publish. I feel like it’s even faster than posting something to Twitter. It is fantastically elegant.

The one problem I have with it is that while it’s great for collecting and aggregating my note data into my Hypothes.is account, there’s not much I can do with it once it’s there. It’s missing the notebook functionality some of these other services provide. I wish I could plug all my annotation and highlight content into spaced repetition systems or move it around and modify it within a notebook where it might be more interactive and cross linked for the long term. Sadly I don’t think that any of this sort of functionality is on Hypothes.is’ roadmap any time soon.

There is some great news however! Hypothes.is is open source and has a reasonable API. This portends some exciting things! This means that any of these wiki, zettelkasten, note taking, or spaced repetition services could leverage the UI for collecting data and pipe it into their interfaces for direct use.

As an example, what if I could quickly tell Obsidian to import all my pre-existing and future Hypothes.is data directly into my Obsidian vault for manipulating as notes? (And wouldn’t you know, the small atomic notes I get by highlighting and annotating are just the sort that one would like in a zettelkasten!) What if I could pick and choose specific course-related data from my reading and note taking in Hypothes.is (perhaps by tag or group) for import into Anki to quickly create some flash cards for spaced repetition review? For me, this combination would be my dream application!

These small pieces, loosely joined can provide some awesome opportunities for knowledge workers, students, researchers, and others. The education focused direction that Hypothes.is, many of these note taking platforms, and spaced repetition systems are all facing positions them to make a super-product that we all want and need.

An experiment

So today, as a somewhat limited experiment, I played around with my Hypothes.is atom feed (https://hypothes.is/stream.atom?user=chrisaldrich, because you know you want to subscribe to this) and piped it into IFTTT. Each post creates a new document in a OneDrive file which I can convert to a markdown .md file that can be picked up by my Obsidian client. While I can’t easily get the tags the way I’d like (because they’re not included in the feed) and the formatting is incredibly close, but not quite there, the result is actually quite nice.

Since I can “drop” all my new notes into a particular folder, I can easily process them all at a later date/time if necessary. In fact, I find that the fact that I might want to revisit all my notes to do quick tweaks or adding links or additional thoughts provides the added benefit of a first round of spaced repetition for the notes I took.

Some notes may end up being deleted or reshuffled, but one thing is clear: I’ve never been able to so simply highlight, annotate, and take notes on documents online and get them into my notebook so quickly. And when I want to do something with them, there they are, already sitting in my notebook for manipulation, cross-linking, spaced repetition, and review.

So if the developers of any of these platforms are paying attention, I (and I’m sure others) really can’t wait for plugin integrations using the full power of the Hypothes.is API that allow us to all leverage Hypothes.is’ user interface to make our workflows seamlessly simple.

Read WP Rig Starter Theme Project Looking for New Maintainers (WordPress Tavern)
A couple of years ago, Morten Rand-Hendriksen launched WP Rig for WordPress. The goal was to bring a modern starter theme and build process to the theme development community. Now, he and the curre…
I couldn’t take this sort of project over, but it looks like something interesting to look into.
Replied to Using WordPress to own your online data & social media presence w/Chris Aldrich (Meetup)
Sat, Aug 22, 2020, 11:00 AM:

Corporate social media has been dominating the online space so significantly that the newest generation of Internet users now thinks that is what the "web" actually is. Fortunately, with WordPress as your platform, you can not only take back your online identity and presence, but you can use it to have a richer and fuller experience than the locked-down experience you get with the limits of Facebook, Twitter, Instagram, etc.

Chris will explore some open web standards and technologies that open up WordPress to allow site-to-site interactions and easier posting functionality through the magic of a small handful of simple plugins. These are simple enough building blocks that the beginning WordPress user can do some powerful new things with their sites but are also rich enough that senior developers can build and extend them or find uses for them for business sites and even e-commerce.

Thanks to everyone who came out today for the Santa Clarita Valley WordPress Meetup! I’m attaching a link to my slide deck on WordPress + IndieWeb which includes links to all the plugins and resources we discussed. If you have questions, feel free to ask me directly or in the IndieWeb chat.

Slides: https://docs.google.com/presentation/d/14uctBWq7SNvB8yVW7jYPhb4i6dXT02NXdpdd9pHESv0/edit?usp=sharing

About to start “Using WordPress to own your online data & social media presence” for the Santa Clarita Valley WordPress Meetup

https://events.indieweb.org/2020/08/santa-clarita-valley-wordpress-meetup-using-wordpress-to-own-your-online-data-social-media-presence-SRTciSsJrPKq or https://www.meetup.com/wordpressscv/events/271867555/

Finishing up my slides today for a presentation about IndieWeb to the WordPress Santa Clarita Valley Meetup on Saturday morning. Everyone is welcome!

It’s not a necessary prerequisite for my talk, but I’ll try to pick up where Tantek Çelik (@t) left off in his invited talk right before the State of the Word at WordCamp US 2019.

RSVPed Attending Hey Pressto! Conference 2020

A WordPress and ClassicPress conference which happens only on Twitter

Hello, we are Hey Pressto! Hey Pressto! is a ClassicPress and WordPress conference which happens only on Twitter.

#HeyPresstoConf2020 will happen on Thursday September 24, see more details about the schedule.

What does that mean? Well, it’s like a conference but presentations are a series of 15 Tweets, one per minute with the conference hashtag, in a scheduled time slot. You can add images, gifs, videos, links to your tweets to add more depth. The conference hashtag, numbering the tweets in a presentation, and threading them, all help the audience follow along. People viewing a presentation can interact by liking the tweets, retweeting them and commenting on the presentation, which builds engagement, creates question and answer threads, starts discussion and stimulates ideas. We will turn all presentations into moments so that they will remain easy to follow for as long as the presenters wish to keep their tweets available.

Here’s a reminder that the call for submissions to #HeyPresstoConf20 are still open until September 3rd. Join this WordPress and ClassicPress online conference which happens only on Twitter.

Read On Digital Gardens, Blogs, Personal Spaces, and the Future by Justin Tadlock (WordPress Tavern)
I have been thinking a lot about digital gardens this week. A blog post by Tom McFarlin re-introduced me to the term, which led me down a rabbit hole of interesting ideas on creating a digital space…

My blog posts were merely random thoughts — bits and pieces of my life. 

Annotated on August 12, 2020 at 09:52AM

Despite having something that worked sort of like a blog, I maintained various resources and links of other neat ideas I found around the web. It was a digital garden that I tended, occasionally plucking weeds and planting new ideas that may someday blossom into something more. 

The idea of a thought space hiding in here….
Annotated on August 12, 2020 at 09:53AM

“The idea of a ‘blog’ needs to get over itself,” wrote Joel Hooks in a post titled Stop Giving af and Start Writing More. “Everybody is treating writing as a ‘content marketing strategy’ and using it to ‘build a personal brand’ which leads to the fundamental flawed idea that everything you post has to be polished to perfection and ready to be consumed.”
It is almost as if he had reached down into my soul and figured out why I no longer had the vigor I once had for sharing on my personal blog. For far too long, I was trying to brand myself. Posts became few and far between. I still shared a short note, aside, once in a while, but much of what I shared was for others rather than myself. 

For many, social media took over their “streams” of thoughts and ideas to the point that they forgot to sit, reflect, and write something longer (polished or not).

Personal websites used for yourself first is a powerful idea for collecting, thinking, and creating.

Getting away from “branding” is a great idea. Too many personal sites are used for this dreadful thing. I’d much rather see the edge ideas and what they flower into.
Annotated on August 12, 2020 at 09:56AM

Personal websites can be so much more than a progression of posts over time, newer posts showing up while everything from the past is neatly tucked on “page 2” and beyond. 

This is an interesting idea and too many CMSes are missing this sort of UI baked into them as a core idea. CMSes could do a better job of doing both: the garden AND the stream
Annotated on August 12, 2020 at 09:57AM

While I lament the loss of some of the artistry of the early web and lay much of the blame at the feet of blogging platforms like WordPress, such platforms also opened the web to far more people who would not have otherwise been able to create a website. Democratizing publishing is a far loftier goal than dropping animated GIFs across personal spaces. 

WordPress has done a lot to democratize publishing and make portions of it easier, but has it gone too far in crystalizing the form of things by not having more wiki-like or curation-based features?
Annotated on August 12, 2020 at 10:01AM

Throughout the platform’s history, end-users have remained at the mercy of their WordPress theme. Most themes are built around what WordPress allows out of the box. They follow a similar formula. Some may have a fancy homepage or other custom page templates. But, on the whole, themes have been primarily built around the idea of a blog. Such themes do not give the user true control over where to place things on their website. While some developers have attempted solutions to this, most have never met the towering goal of putting the power of HTML and CSS into the hands of users through a visual interface. This lack of tools has given rise to page builders and the block editor. 

an apropos criticsm
Annotated on August 12, 2020 at 10:02AM

I also want them to be able to easily build something like Tom Critchlow’s wikifolder, a digital collection of links, random thoughts, and other resources.
More than anything, I want personal websites to be more personal. 

Those in the IndieWeb want this too!! I definitely do.
Annotated on August 12, 2020 at 10:03AM

Read WordPress Auto-Updates: What do you have to lose? (Wordfence)
A new feature that will allow automatic updating of plugins and themes will be available in WordPress version 5.5, which is scheduled to be released on August 11, 2020. In this core release of the world’s most popular content management system, site owners will have the option to turn auto-updates on for individual plugins and ...Read More
This should be an interesting update because of this. I’m probably going to generally ignore the functionality since I prefer closer control over my site and spend so much time in it on a daily basis.
Read Improve Your Remote Collaboration With P2 by Miguel LezamaMiguel Lezama (The WordPress.com Blog)
P2 powers internal collaboration at WordPress.com — and now it’s free for everyone. As more collaboration is happening remotely and online — work yes, but increasingly also school and persona…
It looks like Automattic is dusting off their old p2 / o2 theme projects for a new remote working platform? Here’s hoping that they consider Webmention support for true distributed cross-site @​mentions.