Microsoft Word: one does not simply insert comments into footnotes.
— Sonja Drimmer (@Sonja_Drimmer) December 16, 2021
Thirteenth-century manuscripts: pic.twitter.com/wsVcQ3vUv7
Month: December 2021
Mandrake Illustration from Herbal illustrated in Italy, ca. 1520 (LJS 46)
In one superstition, people who pull up this root will be condemned to hell, and the mandrake root would scream and cry as it was pulled from the ground, killing anyone who heard it. Therefore, in the past, people have tied the roots to the bodies of animals and then used these animals to pull the roots from the soil.[2]
—Wikipedia citing John Gerard (1597). “Herball, Generall Historie of Plants”. Claude Moore Health Sciences Library. Archived from the original on 2012-09-01.
Handwriting my Website with a Digital Amanuensis
A Capital User Interface Idea
A few weeks ago I saw Ben Stokes’ post about PaperWebsite.com and my immediate reaction was, “I have to be able to do that!” I’ve long enjoyed writing by hand over typing as the tactile feel of of pen or pencil and paper is such an enjoyable one. I particularly enjoy using a nice fountain pen on high quality paper.
Obviously there was a route to doing a workflow like this as Ben had shown. I just needed to figure out a method with a low enough barrier that I could personally implement for doing this with my own WordPress website.
A Quick Solution
Not being a serious coder, I immediately began looking for ways I could leverage some of the IndieWeb building blocks my site supports. Micropub seemed like a no-brainer for the posting portion since I’ve got an endpoint using the Micropub WordPress plugin. Certainly not wanting to manually re-type everything once I was finished writing, I needed a way of converting my handwriting to text and then automating a way to plug that into my micropub client.
A short burst of searching revealed that Google Docs could do Optical Character Recognition (OCR) on photos. I pulled out my IFTTT app and found a recipe for taking a photo and saving it to Google Drive. Then I set up another recipe to watch a particular folder in Google Drive and take whatever text appears in new documents and send it to my website using a webhook that uses my Micropub endpoint. The whole thing only took a half hour from idea to a working prototype. In the end it took a tap to open IFTTT on my phone and another tap to take the photo. Then I had to manually open the document to trigger the OCR. Finally, I had to manually open and edit the post before posting.
I had set the micropub client to post as a draft as a default just in case the OCR wasn’t perfect. This was fortunate as the Google photo OCR was so solid that the letters “Dia” of the microscopic text from the word “Diamond” partially visible on my pen cap that was in the photo got pulled into the post.
In the few times I’ve used this workflow so far, I’ve mostly done straight text and syndicated posts to Twitter, Mastodon, and Micro.blog. Perhaps in the future I might set things up to add HTML links, but they’re fairly easy to add at the editing stage.
Since I started my experimentation, a few others in the IndieWeb community have noticed the paperwebsite.com site. Greg McVerry popped up and linked to it as well. He mentioned that he had a digital notebook with OCR capability. This reminded me that I’ve got both a Livescribe Echo pen and a Rocketbook notebook with a Pilot Frixion pen that has an app for uploading digitized images of notebook pages. I hadn’t done OER with Livescribe in ages, so I pulled out the Rocketbook, which is cleverly erasable and thus reusable not to mention being fairly inexpensive. A bit of quick set up allowed me to take a photo of a page which automatically uploads to Google Drive and does its own OCR process. This already dovetails with my prior process, so the whole thing is much smoother. As a result, I’m composing this post in my Rocketbook notebook and will automatically upload and post it to my site as a draft. I’ll probably add some links, a photo or two, and then publish it in a bit.
Rocketbook Interface
The Rocketbook notebook has some solid pages with an odd shiny texture and feel, presumably part of the technology that makes it easy to wipe them clean for reuse. The bottom of each page has seven different faint icon images which are meant to allow the app to determine where to send the digital copy of the notes. One can send them via email or to a variety of storage or sharing services. I could imagine having different recipes set up to allow one to publish their notes to different websites based on the icon X-ed out. Given the micropub possibilities, one could also use the icons as a means of differentiating post kinds (for example, indicating that a particular post is a note, an article, or a bookmark). Another alternate idea would be to use the icons as a means of selecting which services to syndicate your content to (for example, the diamond could mean syndicate this post to Micro.blog, the bell could mean Mastodon, and the clover syndicates the post to Twitter).
The overall process is quite elegant and pleasant. The OCR for Rocketbook is reasonably good aside from a few spelling errors which are easy enough to click and fix. I’ll admit that I far prefer using a fountain pen on some Tomoe River paper to using the Rocketbook paper and the Frixion pen, but really, who wouldn’t?
Handwritten notes for your digital zettelkasten or personal wiki
Since I’ve already got most of the infrastructure, I’ve gone the extra mile and set things up so that I can take notes on index cards zettelkasten-style and use a similar set up to post them to my Obsidian vault using similar IFTTT recipes.
Try it yourself
For those who want to set this up themselves, I’ve documented the IFTTT/micropub portion before. I’ll post the specific code I’m using below for these who may want it. The nice part is that as long as you have a micropub server for your website platform (there are many CMSs that have native or plugin support) the WordPress portion isn’t a deal breaker for others.
I’m sure, now that there are multiple proofs of concept, some enterprising developer will build a custom micropub client to do all of this work automatically or with a few options built into a clever interface.
I could see pen and paper manufacturers (Moleskin, Leuchtturm, Rocketbook, etc.) creating apps for doing this too. I’d love to see and hear about others trying this out for themselves. Hopefully it can be done with almost no code or some easy cut and paste from my example. Ask if you need help, and I’ll see what I can do to help.
IFTTT Webhook settings
This following will be roughly standard for WordPress endpoints using the plugin, but they can obviously be modified for your platform of choice.
- URL:
https://example.com/wp-json/micropub/1.0/endpoint
- Method:
POST
- Content type:
application/x-www-form-urlencoded
- Body:
access_token=PasswordHere&content=<<<{{Body}}>>>&h=entry&category[]=Social%20Stream&post-status=published&visibility=private
Historical examples
While doing some of this I did come across some older examples of handwriting to websites. Aside from handwriting typography which I think is usually ugly, I saw some interesting examples from Jeff Bridges[1] [2], gRegor Morrill, and scrolled through some great examples of handwritten and typed Tweets by Alton Brown. In his case, he was simply taking photos of his writing, but it worked! I’ll admit he had some fun and was definitely creative about it. Hopefully Twitter always exists to save the copies for him.
— Alton Brown (@altonbrown) November 20, 2012
— Alton Brown (@altonbrown) December 22, 2012
— Alton Brown (@altonbrown) December 10, 2012
— Alton Brown (@altonbrown) October 10, 2012
Conclusion
In short, I’ve now got another great way to post to my website. I love the great old school tactile user interface of pen and paper. Now I’m glad to have a reason to be able to do more of it in an ever-digitized culture.
Until I start working on cuneiform solutions…
Write On! 🖋
Editor’s note: This post was originally handwritten on Dec 16, 2021 at 20:15.
Different types of notes and use cases
Ideas
New ideas spurred by reading, potentially for future expansion and refinement.
Questions
Questions relating to the the text. What’s missing? What should have been asked or addressed? What biases exist that should be addressed?
Paraphrases
Paraphrases and [[progressive summaries]] of articles or portions of articles. Restatements of ideas which may be reused in other contexts.
Facts
Basic, usually new, facts highlighted for future use and/or [[spaced repetition]]
Quotes
Old school sententiae, aphorisms, and quotes for use in the future
Replies
Direct communication with others
Phatic notes and Reactions
Reactions, exhortations (Ha!, funny, ROFL, LOL, etc.), reacji, !, ?, ⭐, basic signs of life while reading
Others?
Are there any big holes I’m missing based on your experiences?
In general most micropub clients authenticate using an IndieAuth mechanism which micro.blog also supports and this allows apps (Newsblur in this case) to send formatted data (an article’s title, URL, and a person’s reply, for example) to be published on third party websites. Developers interested in the pieces might inquire in the IndieWeb chat about the quickest and easiest method for implementing or to see some other examples and find open sourced clients/servers that already do most of the heavy lifting: https://chat.indieweb.org/dev. It would be great to see Newsblur added to the growing list of clients that can publish to independent third party websites.
Unless and until Newsblur were to support this, I notice that it does have IFTTT support, so one might be able to carefully write some recipes that allows some functionality to dovetail with any website that has a micropub endpoint. I’ve documented some similar work I did using IFTTT to get the Inoreader feed reader to post reads, bookmarks, and replies to others’ sites to my WordPress website using micropub. I would abandon Inoreader for a reader with good Micropub support.
h/t to Jeremy Cherfas’
for bringing this to my attention.Call for Interest: IndieWebCamp pop up session on Goodreads replacements and decentralized book projects
If you’re interested, comment or reply to this post, or add your interest and preferred dates to the IndieWeb wiki.
- Date: Sometime in February 2022
- Time: TBD (approximately 3 hours in duration)
- Streaming video/audio platform: Zoom
- Hashtag for the session: #DistributedLibraries
We’ll focus discussion on personal libraries on one’s site(s) and how they can interact with each other. How can we pool data and resources for the common good? How can we provide Goodreads like functionality in a decentralized manner? What pieces are we missing? How can we add them? Are there any easy ways we can standardize the pieces for better site-to-site interoperability? How can we interoperate with other projects like Mastodon and BookWyrm or data sources like Open Library?
Organizationally, depending on attendees and needs we may break our time up into two or three facilitated sub-sessions to focus on and cover specific topics of interest. If you have an idea for a sub-session topic (we’ll operate Bar-Camp style the day of the event) you’d like to see or facilitate please indicate it below.
If you’d like to help facilitate the session or volunteer in running it, please don’t hesitate to get in touch.
Want to start discussing the topic prior to the session? Feel free to meet up online in the IndieWeb chat.
We’ll try to announce a date around mid-January to provide time for people to reserve the time.