There are several different files in the client source code that read configuration (also sometimes called "options" or "settings") from different places.
An additional difficulty is that the client consists of two separate components:
src/annotator/ is JavaScript code that's injected directly
This is a very rough demonstration of how to embed Hypothesis in a single page app.
When you click on the "Go to page two" button it loads the second "page" of the app. This page is just loaded by
JavaScript, without having the browser load a new page as it would normally do when following a link.
Importantly the JavaScript code does change URL in the browser's location bar though, using
history.pushState().
Before changing the URL it unloads Hypothesis from the page, and after changing the URL it reloads Hypothesis
into the page. This is to work around a limitation with Hypothesis - it doesn't detect URL changes done by
pushState() and reload the annotations.
| /** | |
| * Check if the request is a PDF file. | |
| * @param {Object} details First argument of the webRequest.onHeadersReceived | |
| * event. The properties "responseHeaders" and "url" | |
| * are read. | |
| * @return {boolean} True if the resource is a PDF file. | |
| */ | |
| function isPdfFile(response, url) { | |
| var header = response.getResponseHeader('content-type'); | |
| if (header) { |
One-time startup:
docker run -d --name postgres -p 5432:5432 -e POSTGRES_PASSWORD=pass postgres
echo 'localhost:5432:postgres:postgres:pass' >> ~/.pgpass
chmod go-rwx ~/.pgpass
pip install psycopg2
After this you just have to run docker start postgres to start it (e.g. after rebooting your laptop).
The SQLAlchemy URL in conf/development.ini should be:
| #!/usr/bin/env python2.7 | |
| import argparse | |
| import json | |
| import requests | |
| def get_annotation(url, id_): | |
| return requests.get(url + "/api/annotations/" + id_).json() |
| diff --git a/h/static/scripts/app.coffee b/h/static/scripts/app.coffee | |
| index 62cccba..5c98e67 100644 | |
| --- a/h/static/scripts/app.coffee | |
| +++ b/h/static/scripts/app.coffee | |
| @@ -112,6 +112,7 @@ module.exports = angular.module('h', [ | |
| .directive('match', require('./directive/match')) | |
| .directive('tabbable', require('./directive/tabbable')) | |
| .directive('tabReveal', require('./directive/tab-reveal')) | |
| +.directive('scrollToMe', require('./directive/scrolltome')) | |