Unofficial Hypothes.is extension
π§ What is Hypothesify?
Hypothesify is a small unofficial Chrome extension for the annotation tool Hypothes.is that allows private and public annotation of any website or PDF.
I decided to make one as part of my learning process of JavaScript. This explains why the code is not really nice and there will be definitely some π. Sorry for the inconvenience.
π Functions of Hypothesify
Hypothesify has the following functions:
- It can show a number of public annotations for a selected website before you open it in Hypothes.is. β Please, note that if you choose this option, every URL goes through the servers of Hypothes.is.
- It can open and close a selected webpage or a PDF document in Hypothes.is.
- It generates a code that you can send to your friends, include in your Note app or integrate into your webpage. To copy the code, click on the generated code panel and press CTRL+C (Windows and Linux) or CMD+C (MacOS).
β Generated code
- a simple link π
- <a> HTML element with @href attribute
- Markdown code in the format []()
- <iframe> HTML element (for inclusion of the whole webpage as iframe)
- {{iframe/pdf}} codes for inclusion of the webpage into Roam π§
β How does Hypothesify work?
Hypothesify uses two key services of Hypothes.is:
- Its public API for obtaining the number of public annotations for any selected webpage.
- Its via proxy that opens any webpage or PDF document in Hypothes.is.
π Privacy
The extension itself does not collect or store any private information. However, if you wish to "Check for available public annotations" in the popup menu, every URL will be sent to the Hypothes.is server. While the request to the server contains only the URL, I assume that the server gets also the IP address of the machine making the request. Note that sometimes the URL address may also contain sensitive information.
Hopefully, I can implement a blacklist and whitelist of URLs in a future version since this is an issue that worries me.
π Support for Hypothesify
If you wish to support this extension, you can make a PayPal donation. π€ΈββοΈ
See: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=6AMGMUDRX29XU&source=url
πΎ Versions
v.1.1, 25th July 2020 - replacement of deprecated :hiccup code with new {{iframe/pdf}} codes for Roamresearch.com
v.1.0, 2nd May 2020 - first version
π Licence of Hypothesify
GNU GPLv3