hypothesis / vision

Envisioning the future of the Hypothesis.
https://github.com/hypothesis/vision/issues/
40 stars 8 forks source link

Provide transclusion with annotations #195

Open nichtich opened 9 years ago

nichtich commented 9 years ago

I'd like to transclude (aka "quote") part of an annotated text in another document and automatically get existing and future annotations of this excerpt made in the original document. Transclusions should already by possible by reuse of range annotation. Given an annotation with a range one should be able to include the selected text as quote in another document. The second step is to find other annotations that are located within the range of the first annotation used for transclusion.

dwhly commented 9 years ago

Given an annotation with a range one should be able to include the selected text as quote in another document.

What are you imagining? That the selection of an annotation is embedded as a card, twitter-like, in another page? Or that the selection is actually more incorporated as part of the body text of another document (which would be more true-to-form of the Xanadu example), i.e. as in a "Xanadoc"? Certainly either are theoretically possible. The former is close to our notion of Embedded annotations (https://github.com/hypothesis/h/issues/141).

One thing I'm curious about is the use case for this. Can you tell a few user stories that might help here?

tilgovi commented 9 years ago

Duplicate of #119.

tilgovi commented 9 years ago

If the transcluded entity includes enough metadata to make the source known to the client, the client should use that metadata to fetch relevant annotations of that entity. That is #119.

nichtich commented 9 years ago

I'd like to include

<div data-transclude-highlight="https://hypothes.is/a/0_e-4BLlQ5OpfYbi8Xlt-A"/>

in my HTML page to get the highlighted quote from https://hypothes.is/a/0_e-4BLlQ5OpfYbi8Xlt-A, with link to the original at https://hyperland.com/mlawLeast.html, and the annotation https://hypothes.is/a/NG37Df5LSwWVQSmLaGvdhg within this quote.

119 and #12 look very similar but slightly different use-case.

tilgovi commented 9 years ago

I think you're just wanting both of those together and still don't see this as a new issue.

On Fri, Sep 25, 2015, 06:17 Jakob Voß notifications@github.com wrote:

I'd like to include

in my HTML page to get the highlighted quote from https://hypothes.is/a/0_e-4BLlQ5OpfYbi8Xlt-A, with link to the original at https://hyperland.com/mlawLeast.html, and the annotation https://hypothes.is/a/NG37Df5LSwWVQSmLaGvdhg within this quote.

119 https://github.com/hypothesis/vision/issues/119 and #12

https://github.com/hypothesis/vision/issues/12 look very similar but slightly different use-case.

— Reply to this email directly or view it on GitHub https://github.com/hypothesis/vision/issues/195#issuecomment-143218498.