diegodlh / unofficial-hypothesis-client

An unofficial Hypothesis web-based annotation client.

Unofficial Hypothesis client

The unofficial Hypothesis client is a browser-based tool for making annotations on web pages. It’s an unofficial client for the Hypothesis web annotation service. It’s used by the unofficial Hypothesis browser extension, and can also be embedded directly into web pages (not yet).

It is a fork of the official Hypothesis client.

Client configuration

The annotation client gets its configuration parameters from the sidebar-app iframe's own document (provided by the h service or by the browser extension) and from the parent document. Information about how to configure the client from the parent document is available here, and full details about how the client configures itself here.

This unofficial client implements configuration from the browser extension as well via the fetchConfigExtension method in fetch-config. Briefly, configuration settings are retrieved by the sidebar from the extension, merged with the other configuration sources, and consumed by the sidebar itself or relayed to the annotator component.

Some of the settings retrieved from the extension are supported by the official client and documented here. Others are experimental features implemented by this unofficial client and documented below. They are disabled by default and can be configured via the sidebar-app iframe's own document and from the parent document as well.

adderToolbarFooter

String. Controls whether the name of the currently selected annotation group is shown on the adder toolbar. (Default: never).

always - The group name is always shown.

exceptPublic - The group name is shown for groups other than “Public”.

never - The group name is not shown.

usePdfWhiteOverlay

Boolean. Controls whether the transparent text layer in PDF documents is rendered white instead to aid selection. (Default: false).

transparentToolbarButtons

Boolean. Controls whether the annotator toolbar buttons are rendered transparent i nstead of opaque. (Default: false).

enableExperimentalNewNoteButton

This setting is already supported by the official client and documented here. This unnoficial client implements configuration via the browser extension.

openSidebar

This setting is already supported by the official client and documented here. This unnoficial client implements configuration via the browser extension.

Development

See the official client Development Guide for instructions on building, testing and contributing to the client.

License

The unofficial Hypothesis client is released under the 2-Clause BSD License, sometimes referred to as the "Simplified BSD License". Some third-party components are included. They are subject to their own licenses. All of the license information can be found in the included LICENSE file.