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.