emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Tom Gillespie <tgbugs@gmail.com>
To: emacs-orgmode <emacs-orgmode@gnu.org>
Subject: Re: Bring up a screen giving option to open a series of orgmode files
Date: Tue, 15 Dec 2020 23:05:37 -0500	[thread overview]
Message-ID: <CA+G3_PNVTU2sxrw8E+qjrAwO7Hn8L3vjwVVdKuLviNpmPjM3=w@mail.gmail.com> (raw)
In-Reply-To: <87tusmjw23.fsf@localhost>

To hop in on the hypothes.is thread. I have spent quite a bit of time
working with hypothes.is and related tooling (mostly in python), so
here is a brain dump on interactions between org and hypothes.is. As
others have mentioned, this could easily be its own thread. Best!
Tom

A quick note on security for hypothes.is. Last I checked (about 30
seconds ago) there is still no way to control access to groups, if the
identifier for the group leaks then anyone can access it. This is not
the case for private annotations, those can only be seen by someone
with your api key (hopefully just you).

If you are looking for a light weight client that is hypothesis
compatible that could be used to build a tool that can push
annotations to an alternate backend then
https://github.com/judell/hlib might be a reasonable place to start.
Jon has previously used that to create a client that sent annotations
to an alternate backend, which could in theory be an elisp
implementation of a server for the w3c annotation standard that could
feed things to org-protocol (or similar).

If people are interested in this for org-mode I would suggest that a
starting point would be to write an elisp implementation that can
consume and produce the w3c web annotation standard format for
annotations and/or the hypothesis api format.

There are at least 3 different ways that web annotations can be
anchored, offset, xpath, exact + prefix/suffix. In principle you could
translate those into urls and use query parameters to encode the
target selectors. The problem that you will run into is that there are
some rather sizeable selector patterns like the example below (that I
happened to have up in another terminal) which will be a pain to work
with as urls. As a result of this a reasonable workflow would be to
create a custom link type for the hypothes.is annotation urls e.g. the
equivalent of #+link: hyp https://hyp.is/ and simply paste in a
shortened form of the share links. In addition one might want some
additional tooling so that the contents of the annotation could be
retrieved and cached, or retrieved, transformed, and embedded in the
document as an appendix during export (or similar).

Unifying org-capture, org-protocol, and general org hyperlinking with
the w3c spec seems like it would be hard in the general case, but for
specific use cases I can imagine that some reduced syntax could be
created that would fit in an org hyperlink. It actually would probably
be easier to do this by
coming up with a way to convert structured org sections or blocks to
and from the w3c spec, name those, and then use org hyperlinks to
refer to
the annotations directly in an org file that functioned as an
annotation store. Much less overhead than trying to set up a
stripped-down stand-alone web annotation server, and if you can
produce json to match the hypothes.is API then you could make use of
that to publish and share annotations/links when you go to publish an
org document.

'selector': [{'type': 'FragmentSelector',
     'value': 'pes-1',
     'conformsTo': 'https://tools.ietf.org/html/rfc3236'},
    {'type': 'RangeSelector',
     'endOffset': 92,
     'startOffset': 86,
     'endContainer':
'/div[4]/div[1]/div[4]/div[1]/article[1]/section[1]/article[1]/div[1]/div[2]/ul[1]/li[1]/div[3]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/figure[1]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]/div[1]',
     'startContainer':
'/div[4]/div[1]/div[4]/div[1]/article[1]/section[1]/article[1]/div[1]/div[2]/ul[1]/li[1]/div[3]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/figure[1]/div[1]/div[1]/div[1]/div[1]/div[2]/div[1]/div[1]'},
    {'end': 3034, 'type': 'TextPositionSelector', 'start': 3028},
    {'type': 'TextQuoteSelector',
     'exact': '100kHz',
     'prefix': ' DC - 20kHz\nSampling frequency: ',
     'suffix': '\nOnboard stimulatorNeural Interf'}]}


  reply	other threads:[~2020-12-16  4:06 UTC|newest]

Thread overview: 87+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-11-22 10:01 Bring up a screen giving option to open a series of orgmode files Gerardo Moro
2020-11-22 10:09 ` Jean Louis
2020-11-22 17:35   ` Berry, Charles via General discussions about Org-mode.
2020-11-22 18:33     ` Jean Louis
2020-11-22 19:03     ` Gerardo Moro
2020-11-22 19:15       ` Jean Louis
2020-11-23  3:59         ` Gerardo Moro
2020-11-23  5:21           ` Jean Louis
2020-11-23  8:12             ` Ihor Radchenko
2020-11-23  8:40               ` Gerardo Moro
2020-11-23  9:11                 ` Ihor Radchenko
2020-11-23  9:14                   ` Gerardo Moro
2020-11-23  9:14               ` Jean Louis
2020-11-24  4:07                 ` Gerardo Moro
2020-11-24  7:26                   ` Ihor Radchenko
2020-11-24  7:23                 ` Ihor Radchenko
2020-11-24  9:28                   ` Gerardo Moro
2020-11-24  9:57                     ` Ihor Radchenko
2020-11-24 16:26                       ` Jean Louis
2020-11-25  3:41                         ` Ihor Radchenko
2020-11-25  5:36                           ` Jean Louis
2020-11-25  7:15                             ` Ihor Radchenko
2020-11-25 11:20                               ` Browser org-capture bookmarklet Jean Louis
2020-11-25 12:51                                 ` Ihor Radchenko
2020-11-25 14:12                                   ` Jean Louis
2020-11-25 14:50                                   ` Jean Louis
2020-12-02  9:07                               ` Bring up a screen giving option to open a series of orgmode files Jean Louis
2020-12-02  9:53                                 ` Ihor Radchenko
2020-12-02 10:19                                   ` Jean Louis
2020-12-02  9:24                               ` Jean Louis
2020-12-02  9:56                                 ` Ihor Radchenko
2020-12-02 10:14                                   ` Jean Louis
2020-11-24 17:41                       ` Jean Louis
2020-12-02 10:17                       ` Maxim Nikulin
2020-11-27  2:40                   ` Jean Louis
2020-11-27  8:15                     ` Alan Schmitt
2020-11-27 12:04                       ` Jean Louis
2020-11-28 16:12                         ` Maxim Nikulin
2020-11-28 18:10                           ` Jean Louis
2020-11-28 15:51                     ` Maxim Nikulin
2020-11-28 17:59                       ` Jean Louis
2020-11-30  9:35                         ` Ihor Radchenko
2020-11-30 10:45                           ` Jean Louis
2020-12-01  2:38                             ` Ihor Radchenko
2020-12-01 10:30                               ` Jean Louis
2020-11-30 17:08                         ` Maxim Nikulin
2020-11-30 18:33                           ` Jean Louis
2020-12-02 16:41                             ` Maxim Nikulin
2020-12-02 17:24                               ` Jean Louis
2020-12-09 13:00                               ` Jean Louis
2020-12-09 15:03                                 ` Maxim Nikulin
2020-12-09 16:32                                   ` Jean Louis
2020-12-09 16:49                                     ` Maxim Nikulin
2020-12-10  0:04                                     ` Ihor Radchenko
2020-12-11  6:54                                       ` Jean Louis
2020-12-11 14:40                                         ` Maxim Nikulin
2020-12-11 15:22                                           ` Ihor Radchenko
2020-12-12  3:22                                             ` Jean Louis
2020-12-13  0:42                                               ` Ihor Radchenko
2020-12-13 15:00                                                 ` Jean Louis
2020-12-14 12:58                                                   ` Ihor Radchenko
2020-12-14 19:08                                                     ` Jean Louis
2020-12-14 22:27                                                       ` TRS-80
2020-12-14 22:33                                                         ` Jean Louis
2020-12-15  4:42                                                         ` Ihor Radchenko
2020-12-15  5:00                                                           ` Jean Louis
2020-12-16  2:59                                                             ` Ihor Radchenko
2020-12-16  4:05                                                               ` Tom Gillespie [this message]
2020-12-18 12:35                                                               ` Jean Louis
2020-12-16  1:48                                                           ` TRS-80
2020-12-16 12:40                                                           ` Maxim Nikulin
2020-12-12  2:49                                           ` Jean Louis
2020-12-13  0:48                                             ` Ihor Radchenko
2020-12-13 15:13                                               ` Jean Louis
2020-12-13 18:02                                                 ` Christopher Dimech
2020-12-13 20:31                                                   ` Jean Louis
2020-12-14  0:34                                                 ` Ihor Radchenko
2020-12-14  0:34                                                   ` Jean Louis
2020-12-14  0:35                                                 ` Ihor Radchenko
     [not found]                     ` <874kl7172r.fsf@localhost>
2020-11-30 10:51                       ` Jean Louis
2020-11-22 21:23       ` Berry, Charles via General discussions about Org-mode.
2020-11-23  9:52 ` Diego Zamboni
2020-11-23 21:04   ` Jean Louis
2020-11-24  9:53 ` John Sturdy
2020-11-24 10:04   ` Detlef Steuer
2020-11-24 13:44     ` Jean Louis
2020-11-24 14:38   ` Jean Louis

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='CA+G3_PNVTU2sxrw8E+qjrAwO7Hn8L3vjwVVdKuLviNpmPjM3=w@mail.gmail.com' \
    --to=tgbugs@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).