From: John Kitchin <jkitchin@andrew.cmu.edu>
To: Eric Abrahamsen <eric@ericabrahamsen.net>
Cc: emacs-orgmode@gnu.org
Subject: Re: Marking/highlighting text temporarily
Date: Wed, 29 Apr 2015 09:38:29 -0400 [thread overview]
Message-ID: <m2iocfhx62.fsf@andrew.cmu.edu> (raw)
In-Reply-To: <87mw1r865s.fsf@ericabrahamsen.net>
I think it could benefit from a dedicated syntax in the following
context:
There are different types of annotation you might like, e.g. delete,
insert, replace, comment (I am drawing from ideas of annotations in PDF,
and the idea of track changes). In multi-author documents you might want
to know who wrote the annotation, and when. Finally, you might want some
way to mark that the annotation has been "seen". These might be
stand-alone or attached to text.
To follow something like the cite syntax, here is an example that shows
a comment type, author, timestamp, checked status, and content. I have
not thought about how these would be displayed much except that you
would almost always want an overlay to hide most of this, and show only
the important stuff with an appropriate face (e.g. crossout for delete,
^....^ for insert, tooltip for comment, +old text+=new text=, etc...
[@annote :type comment :author John Kitchin :timestamp [2015-04-29 Wed
9:26AM] :checked nil :content This is just a comment]
[@annote :type insert :author John Kitchin :timestamp [2015-04-29 Wed
9:26AM] :checked nil :content some new content]
[@annote :type delete :author John Kitchin :timestamp [2015-04-29 Wed
9:26AM] :checked nil :old-content Some words to delete]
[@annote :type replace :author John Kitchin :timestamp [2015-04-29 Wed
9:26AM] :checked nil :old-content This is just a comment :new-content
replacement text]
Most of this information would be inserted by emacs, not by the
author. Eric is right about the functionality provided to create and
manipulate these annotations. Maybe some kind of minor mode to enable
what could act like track changes, with commands to accept or reject the
changes, etc...
I would use this a lot with my students in writing papers.
Eric Abrahamsen writes:
> Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:
>
>> Hello,
>>
>> Eric Abrahamsen <eric@ericabrahamsen.net> writes:
>>
>>> I'm copying Nicolas -- Nicolas, is there a process for inclusion in
>>> contrib? Would this be eligible? I'll just stick it in Elpa,
>>> otherwise.
>>
>> Any package is eligible.
>>
>> However, contrib/ is from pre-"package.el" days. Nowadays, I tend to
>> think it should be used only as an incubator for libraries meant to be
>> moved into core. Other libraries should be packaged in ELPA.
>>
>> I admit I didn't read the thread carefully. IIUC, it seems to be an
>> annotation mechanism. If I'm correct, I think it belongs to the first
>> category.
>
> Yup, "annotation mechanism" is about right. Just to be clear, you think
> it fits into the category of incubation-prior-to-core?
>
> If anyone thinks that this mechanism warrants actual new Org syntax, I'd
> be happy to work on implementing that. But to be honest, I think it sits
> pretty comfortably on top of what's already available. The only slight
> awkwardness comes when you'd like a different face for the annotation
> links (currently solved with John Kitchin's hi-lock trick), and the fact
> that the link export routines don't have access to the exportation
> info/plist channels (ie, when exporting an annotation link to ODT, I'd
> like to be able to give the annotation an "author" element, but as far
> as I know I can't get access to that). These aren't major flaws.
>
> All that said, I do think this is an important feature that fills a bit
> of gap in Org. TODOs are fundamental, but they are discrete entities.
> Those of us who use Org for authoring could use a method of decorating
> spans of text with pertinent information. As org-comment stands now, the
> tabular list buffer serves as a pseudo Agenda for text comments: I have
> been using it, for example, as a way of keeping track of translation
> problems that I need to resolve.
>
> I'll admit I have dreamed of a syntax that looks like: [[body text to
> annotate][TODO:Look this up on the internet:@work]]. The thought of
> plugging that in to the existing Agenda machine is exhausting even to
> contemplate, though.
>
> I know we've got inlinetodos. They bug me, though: the absurd number of
> stars (even if they are invisible), and the fact that you're still not
> really attaching the TODO to specific text, which is what I want. I know
> these aren't reasonable objections, but still.
>
> Now I wish we'd named it org-annotate.
>
> I'm done,
> Eric
--
Professor John Kitchin
Doherty Hall A207F
Department of Chemical Engineering
Carnegie Mellon University
Pittsburgh, PA 15213
412-268-7803
@johnkitchin
http://kitchingroup.cheme.cmu.edu
next prev parent reply other threads:[~2015-04-29 13:38 UTC|newest]
Thread overview: 65+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-04-24 6:19 Marking/highlighting text temporarily Vikas Rawal
2015-04-24 6:42 ` Thomas S. Dye
2015-04-24 7:53 ` Marcin Borkowski
2015-04-24 7:05 ` Glyn Millington
2015-04-24 7:13 ` Eric Abrahamsen
2015-04-24 7:19 ` Eric Abrahamsen
2015-04-24 7:38 ` Fabrice Niessen
2015-04-24 7:40 ` Eric S Fraga
2015-04-24 7:58 ` Marcin Borkowski
2015-04-24 8:48 ` Eric S Fraga
2015-04-24 21:38 ` Vikas Rawal
2015-04-25 0:52 ` John Kitchin
2015-04-25 1:34 ` Eric Abrahamsen
2015-04-25 4:13 ` Vikas Rawal
2015-04-25 7:47 ` Eric Abrahamsen
2015-04-25 9:08 ` Eric Abrahamsen
2015-04-26 18:14 ` John Kitchin
2015-04-27 6:13 ` Eric Abrahamsen
2015-04-27 10:27 ` John Kitchin
2015-04-27 11:11 ` Marcin Borkowski
2015-04-27 12:37 ` Eric Abrahamsen
2015-04-27 12:58 ` John Kitchin
2015-04-27 13:06 ` Eric Abrahamsen
2015-04-27 23:35 ` John Kitchin
2015-04-28 2:28 ` Eric Abrahamsen
2015-04-28 19:32 ` John Kitchin
2015-04-29 8:41 ` Eric Abrahamsen
2015-04-29 9:57 ` Rasmus
2015-04-29 12:14 ` Eric Abrahamsen
2015-04-29 12:31 ` Rasmus
2015-04-29 13:57 ` John Kitchin
2015-04-29 13:52 ` John Kitchin
2015-04-29 10:39 ` Nicolas Goaziou
2015-04-29 12:34 ` Eric Abrahamsen
2015-04-29 12:51 ` Rasmus
2015-04-29 13:21 ` Eric S Fraga
2015-04-29 14:00 ` John Kitchin
2015-04-29 14:42 ` Eric S Fraga
2015-04-29 14:54 ` Eric Abrahamsen
2015-04-29 13:16 ` Eric S Fraga
2015-04-29 14:56 ` Eric Abrahamsen
2015-04-29 13:38 ` John Kitchin [this message]
2015-04-29 21:51 ` Nicolas Goaziou
2015-04-30 1:45 ` Eric Abrahamsen
2015-04-30 9:58 ` Rasmus
2015-04-30 11:32 ` Eric S Fraga
2015-04-30 13:45 ` John Kitchin
2015-05-03 13:33 ` Eric Abrahamsen
2015-05-08 10:19 ` Nicolas Goaziou
2015-05-18 9:57 ` Rasmus
2015-05-18 11:48 ` Nicolas Goaziou
2015-05-18 13:16 ` Rasmus
2015-05-18 15:44 ` Eric S Fraga
2015-05-18 16:31 ` Rasmus
2015-05-18 20:49 ` Eric Abrahamsen
2015-05-18 15:50 ` Nicolas Goaziou
2015-05-18 16:25 ` Rasmus
2015-05-18 16:56 ` Nicolas Goaziou
2015-05-18 17:28 ` Rasmus
2015-05-18 18:36 ` Eric S Fraga
2015-05-19 8:14 ` Nicolas Goaziou
2015-04-28 10:48 ` Eric Abrahamsen
2015-04-25 9:04 ` Eric S Fraga
2015-05-18 21:42 ` Marcin Borkowski
2015-05-28 10:52 ` Alan Schmitt
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=m2iocfhx62.fsf@andrew.cmu.edu \
--to=jkitchin@andrew.cmu.edu \
--cc=emacs-orgmode@gnu.org \
--cc=eric@ericabrahamsen.net \
/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).