Publish Obsidian plugin annotations to website

[Brandon Lewis]

I've been using the Hypothesis Obsidian annotator to annotate PDFs in an Obsidian vault—so I have a bunch of annotations as markdown files. I am now attempting to publish the Obsidian vault as a website at movement-ontology.brandazzle.net, but the plugin apparently isn't supported on website, as the annotations do not render. Is there any way I could host the Hypothesis tools on the website and connect my annotations so that viewers can see my annotations?

[mdiro...@hypothes.is]

Hi Brandon,

I'm not sure if other folks on the forum will have other ideas, but here's our directions for embedding Hypothesis in a web page: https://web.hypothes.is/help/embedding-hypothesis-in-websites-and-platforms/.

There's additional information here: https://h.readthedocs.io/projects/client/en/latest/publishers/embedding/.

Best,

Michael

[Chris Aldrich]

Brandon,

Obsidian Annotator (https://github.com/elias-sundqvist/obsidian-annotator), which I'm presuming you're using, looks like it's working from within Obsidian instead of a web page and is very clever looking, but without some significant work, I don't think it's going to provide you with the results you're looking for. It sounds like you want an all-public chain of work and Obsidian Annotator currently defaults to an all-private chain.

From my brief perusal of what's going on, the plugin appears to be tied to a single Hypothes.is account (likely the developer's) which defaults all annotations to private (only you) and as a result, even if you had the permalink to the annotations you'd not be able to see them presented on the web as they're all private and you wouldn't have access to the account.  You could try filing some issues on the related Github repository to see if the developer might add the ability to make public annotations using your own personal account, which I'm sure would require your personal API key for Hypothes.is to be put into the settings page for the plugin in Obsidian. Another issue I see is that it's taking Hypothesis tags and turning them into Obsidian tags, which is generally fine, but the developer isn't accounting for multi-word tags which is creating unintended tag errors along the way that will need to be manually fixed.

If you're open to an alternate method of annotating and doing so in public, I can recommend a workflow that will allow you to do what it sounds like you're attempting. It starts with annotating .pdf files (either on the web, or as local files in your browser) in public using your own Hypothes.is account. (Most of this also works with private annotations, but if you want them to appear on public versions of web-hosted .pdf files with the same fingerprints, you'll want them to be public so others can see/interact with them.) Next set up the Hypothesidian script described here: https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225. There are some useful hints further down the thread on that page, so read the whole thing. The Github repository for it is here: https://github.com/SilentVoid13/Templater/discussions/191 if you need it. I've documented a few modifications I've made to the built-in template to suit my particular needs and which might serve as a template if you find it useful: https://boffosocko.com/2021/07/08/hypothes-is-obsidian-hypothesidian-for-easier-note-taking-and-formatting/.

You can then use the functionality of Hypothesidian to pull in the annotations you want (by day, by document, only your annotations, all the annotations on a document, etc.) For .pdf files, you may require Jon Udell's facet tool https://jonudell.info/h/facet/ to search your personal account for the name of the file or one of the tags you used. When you find it, you can click on it and it will open a new browser window that contains the appropriate urn file "key" you'll need to put into Hypothesidian to grab the annotations from a particular .pdf file. It will be in the general form: urn:x-pdf:1234abcd5678efgh9101112ijkl13. I haven't found an easier means of pulling out the URN/fingerprint of pdf files, though others may have ideas.

When you pull in your annotations you can also get/find permalinks to the annotations on the web if you like. I usually hide mine in the footnotes of pages with the labels "annotation in situ" and "syndication links", a habit I've picked up from the IndieWeb community (https://indieweb.org/posts-elsewhere). You can see a sample of how this might be done at https://notes.boffosocko.com/where-are-the-empty-spaces-on-the-internet where I've been doing some small scale Hypothes.is/Obsidian/Web experiments. (I'm currently using Blot.im to get [[wikilinks]] to resolve.)

Another strong option you're probably looking for is to use "via" links on the URLs for your pdf files so that people can automatically see the annotation layer. (This may require whitelisting on Hypothes.is' end depending on where the files are hosted; alternately https://docdrop.org/ may be useful here.) Then if you've annotated those publicly, they'll also be able to see them that way too.

Another side benefit of this method is that it doesn't require the Data View plugin for Obsidian to render your annotations within Obsidian which also means you'll have cleaner looking pages of annotations in your web published versions. (ie. none of the %% code blocks which don't render properly on the web)

As I notice you're using some scanned .pdf files which often don't have proper OCR and can make creating annotations with appropriate Hypothes.is anchors, you might also appreciate the functionality of docdrop for this as well.

Given your reliance on documents and the fact that you've annotated some in what looks like Adobe Acrobat or a similar .pdf program, you might additionally enjoy using Zotero with Obsidian, Zotfile, and mdnotes as outlined here: https://forum.obsidian.md/t/zotero-zotfile-mdnotes-obsidian-dataview-workflow/15536. It's relatively slick, but requires additional set up, reliance on more moving pieces, and isn't as nice an overall user interface in comparison to Hypothes.is. It also misses all of the potential useful social annotation you might get with Hypothes.is.

Hopefully this is all reasonably clear and helpful. I'd be interested in hearing about options from others who are using Hypothes.is in conjunction with Obsidian or other related note taking tools and publishing them to the web after-the-fact.

Best,

Chris Aldrich

[Chris Aldrich]

With regard to the last portion, I've just noticed that starting in the recently released version 6, Zotero will now allow you to view annotations previously made in Adobe software. It will also let one extract all the annotations from within a text and save them into a note in Zotero and then export them as markdown into Obsidian or other tools. This means one doesn't need as many additional tools (Zotfile or MDNote) to get this data. (See https://www.zotero.org/blog/zotero-6/.)