The Hypothesis browser extensions allow you to annotate web documents using your Hypothesis account.
| Chrome | Firefox | Opera | Safari | IE |
|---|---|---|---|---|
 |
 |
 |
 |
 |
| Now available | In development | not yet |
not yet |
not yet |
The code for the extensions is in the src/ directory, and can be built into a
browser extension by running:
npm install
make
Once this is done you should be able to load the build/ directory as an
unpacked extension.
The extension code has a test suite, which you can run using:
npm test
Note that the browser extensions are for the most part just a wrapper around the
Hypothesis client. Depending on what you're interested in working on,
you may need to check out the client repository too. If you do that, you can get
the browser extension repository to use your checked-out client repository by
running
npm link
in the client repository, and then
npm link hypothesis
in the browser-extension repository. After that, a call to make will use the
built client from the client repository. Please consult the client's
documentation for instructions on building the client in a development
environment.
Tip: If you get a permission denied error when running npm link
you probably need to fix npm's permissions. See
Fixing npm permissions.
Tip: To unlink your dev browser extension from your dev client run
npm unlink hypothesis in your browser extension directory
(see the npm uninstall docs).
See Building the extension for more information.
Join us in #hypothes.is on freenode for discussion.
If you'd like to contribute to the project, you should consider subscribing to the development mailing list, where we can help you plan your contributions.
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
The Hypothesis browser extensions are 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.