[null, {"document_url": "https://indieweb.org/marginalia", "unformatted_src": "https://lh3.googleusercontent.com/-r3A9y0QWUGA/T4XzCE5BhCI/AAAAAAAAPRU/zAXHDpcuuqg/s50-c/Recursion-small.jpg", "src": "https://lh3.googleusercontent.com/-r3A9y0QWUGA/T4XzCE5BhCI/AAAAAAAAPRU/zAXHDpcuuqg/s50-c/Recursion-small.jpg", "formatted_filename": "Recursion small"}, null, {"document_url": "https://indieweb.org/marginalia", "unformatted_src": "/images/thumb/0/04/marginalia-hidden.jpg/300px-marginalia-hidden.jpg", "src": "https://indieweb.org/images/thumb/0/04/marginalia-hidden.jpg/300px-marginalia-hidden.jpg", "formatted_filename": "px marginalia hidden", "alt_text": "Marginalia Hidden", "rendered_width": 300, "rendered_height": 188}, {"document_url": "https://indieweb.org/marginalia", "unformatted_src": "/images/thumb/1/15/marginalia-shown.jpg/300px-marginalia-shown.jpg", "src": "https://indieweb.org/images/thumb/1/15/marginalia-shown.jpg/300px-marginalia-shown.jpg", "formatted_filename": "px marginalia shown", "alt_text": "Marginalia Shown", "rendered_width": 300, "rendered_height": 189}, null, null, {"document_url": "https://indieweb.org/marginalia", "unformatted_src": "/images/thumb/d/d2/medium-annotation-sidebar.png.jpg/500px-medium-annotation-sidebar.png.jpg", "src": "https://indieweb.org/images/thumb/d/d2/medium-annotation-sidebar.png.jpg/500px-medium-annotation-sidebar.png.jpg", "formatted_filename": "px medium annotation sidebar", "alt_text": "Annotations in sidebar", "rendered_width": 500, "rendered_height": 227}, null, {"document_url": "https://indieweb.org/marginalia", "unformatted_src": "/images/thumb/2/2d/medium-annotation-sidebar-med.png.jpg/500px-medium-annotation-sidebar-med.png.jpg", "src": "https://indieweb.org/images/thumb/2/2d/medium-annotation-sidebar-med.png.jpg/500px-medium-annotation-sidebar-med.png.jpg", "formatted_filename": "px medium annotation sidebar med", "alt_text": "Annotations in sidebar-medium screen", "rendered_width": 500, "rendered_height": 360}, null, {"document_url": "https://indieweb.org/marginalia", "unformatted_src": "/images/f/fd/medium-annotation-overlay.png.jpg", "src": "https://indieweb.org/images/f/fd/medium-annotation-overlay.png.jpg", "formatted_filename": "medium annotation overlay", "alt_text": "Annotations in overlay", "rendered_width": 500, "rendered_height": 365}, null, {"document_url": "https://indieweb.org/marginalia", "unformatted_src": "/images/thumb/4/43/medium-annotation-sidebar-mobile.jpg/500px-medium-annotation-sidebar-mobile.jpg", "src": "https://indieweb.org/images/thumb/4/43/medium-annotation-sidebar-mobile.jpg/500px-medium-annotation-sidebar-mobile.jpg", "formatted_filename": "px medium annotation sidebar mobile", "alt_text": "Annotation overlay on mobile", "rendered_width": 500, "rendered_height": 444}, null]

Marginalia are responses to parts of a post, rather than posts as a whole; they are typically published (on another site) with a fragmention link to the specific part (like a paragraph), notified via Webmention, and displayed on the post adjacent to the referenced part (like sidebar comments next to paragraphs).




On the IndieWeb, marginalia can be posted with the same process as a usual post-level interaction, but with the target URL of the interaction set to a fragmention of the relevant phrase. For instance, to post a reply to a phrase "Gregor Samsa woke from troubled dreams" on http://example.com/kafka set the the in-reply-to URL as http://example.com/kafka##Gregor+Samsa+woke+from+troubled+dreams.


Notifications of marginalia posted by readers on their own site can be received using Webmention sent to a URL containing a fragmention.


As a first step, marginalia can be displayed as normal post-level comments at the bottom of the post but with a reference/fragmentioned link to the context-phrase.

A better UI is to display received marginalia in context, near the phrase being referred to. Marginalia UI could be coarse-grained to group all marginalia to a particular paragraph together or displayed at a phrase-level. To avoid interrupting the reading flow, some UI to hide/show the relevant marginalia could be provided.


 Kartik Prabhu posts and displays received marginalia on https://kartikprabhu.com since 2014-07-10 Johnny Oskarsson

Johnny Oskarsson displays received marginalia on https://joskar.se



Medium supports paragraph-level comments through a Twitter login. (Screenshots of the article [1] as on 2014-04-16) Posting a comment is triggered by clicking on a "+" sign on the top-right corner of a paragraph. Similarly, you can read the comments by clicking on the number on the top-right corner. On large screens the annotations appear in a sidebar on the right. For medium-sized screens the main text slides out of the screen to the left, making room for the sidebar. For small screens the annotations are displayed in an overlay. Swiping to the left scrolls through the annotations. On mobile Firefox the overlay additionally includes highlighting on the original content, but breaks on swiping to read next comment. Posting UI

Expand: on text selection, Medium shows a "Tweet this sentence" interface. Could be adapted for posting marginalia.



expand/document referring to: https://twitter.com/wblau/status/529713139961827329/photo/1


Retrieved from "https://indieweb.org/wiki/index.php?title=marginalia&oldid=34882"






