search

hypothesis / vision

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

RSS/Atom Syndication #170

Open dwhly opened 9 years ago

dwhly commented 9 years ago

Should support both auto-discovery, and perhaps show an icon near search field on /stream. Current filters in place on the /stream would be able to be subscribed to, as long as the results are public to all.

Related to: https://github.com/hypothesis/h/issues/391

tilgovi commented 9 years ago

Changed the title of the issue to RSS/Atom syndication and removed any mention of search or streams.

What is needed first is an articulation of what and why we want to export to RSS/Atom and who or what people and integrations are served by it.

seanh commented 9 years ago

Related: https://github.com/hypothesis/vision/issues/179

zackw commented 9 years ago

I'd just like to mention that I'm experimenting with hypothes.is embedding as an alternative to traditional blog comments, and in that context I really want a way to subscribe to all annotations on my site, so that if there's a situation requiring moderator intervention I know about it ASAP.

judell commented 9 years ago

Hi Zack,

Indeed. The existing feed, http://hypothes.is/stream.atom, is a firehose. We'll have, Real Soon Now, filtering by url, user, and tag. What you really need, of course, is a site filter as well and that's coming later.

I was about to write that, while not convenient, it's at least doable to run the existing feed through an external filter that scopes to your base URL. But in fact I see that's not possible. Consider an entry in the feed:

  <entry>
    <id>tag:hypothes.is,2015-06-03:KcZ_vhHPQmq44fMwyIOuUw</id>
    <title>Bronx Masquerade by Nikki Grimes | Youth Voices</title>
    <updated>2015-06-03T18:31:36.154046+00:00</updated>
    <published>2015-06-03T18:31:36.154013+00:00</published>
    <author>
      <name>SaulNDSS</name>
    </author>
    <link rel="alternate" type="text/html" href="https://hypothes.is/a/KcZ_vhHPQmq44fMwyIOuUw" />
    <link rel="alternate" type="application/json" href="https://hypothes.is/api/annotation/KcZ_vhHPQmq44fMwyIOuUw" />
     <content type="html">
&lt;blockquote&gt;telling me I need to be planning for some future&lt;/blockquote&gt;this is trying to say that Tyrone needs to be planning for a future for himself because he doesn't want to go to school. He says that if it wasn't for Wesley and friends he wouldn't be here working or anything. they both need to plan to have a big future 
    </content>
  </entry>

There's no way for an external filter to know that the annotation targets http://youthvoices.net/masquerade.

This would help, I think:

<link rel="related" type="text/html" href="http://youthvoices.net/masquerade" />

I'll float it over on the h repo and see what folks think. Thanks for prompting this realization! We will have a site filter, and I think that's what you'll ultimately want for the case you describe, but this might be a useful workaround and, anyway, would make the Atom feed richer.

malcook commented 6 years ago

@judell - possible also to filter by group?