Implement browse/view/share

[MisterTJB]

All users want to browse the documents, and view the letters in a nice human readable way. They should be able to save the raw TEI of a document that they are looking at. If they email the current URL to a colleague both will see the exact same document.

[MisterTJB]

URLs should probably be of the form host/path/identifier

e.g. colenso.org.nz/letters/PrLBrghtn-0001

[MisterTJB]

Suggested browse filters:

• Date (via creation/date/@when)
• Sender (via correspAction[@type = "sent"] and //titleStmt/author/name/text())
• Receiver (via //correspAction[@type = "received"] and //correspAction/name/text())

Methodology:

Retrieve {document uri, creation date, sender/author, receiver, title} for every document in the database. When filters are selected, use jQuery to show/hide elements in the results list.

[MisterTJB]

Tested execution time for retrieving every document – BaseX reports 45ms and total page load time is approximately 1500ms. Note, though, that rendering only takes about 400ms.

The methodology of retrieving and displaying every document, then filtering via jQuery hiding is probably fine (as opposed to, e.g, pagination or progressive loading)

[MisterTJB]

Alongside each filter, indicate the number of results in the current result set that are associated with that filter. E.g:

Sender Person A (43) Person B (11)

Recipient Person C (12)

[MisterTJB]

Maybe browsing should be interpreted as "browsing" through search results from the latter view? I.e:

1. User searches and filters
2. User selects letter
3. Letter view is rendered
4. Left and right buttons allow user to "browse" through search results on via the letter view

[MisterTJB]

Proposed methodology:

• Create an endpoint for AJAX requests for XML documents
• Create a div with id="letter"
• Store array of document ids client side (i.e via Jade)
• Start at index 0 – next increments index, back decrements
  • increment until min(index, array.length-1)
  • decrement until max(0, index)
• Make AJAX request to example.com/endpoint/documentid?callback=xyz
• When document has returned, call xyz and replace contents of #letter with the contents of the returned document
• Fix the