From: John Kitchin <jkitchin@andrew.cmu.edu>
To: "ZHUO QL (KDr2)" <zhuoql@yahoo.com>,
org-mode-email <emacs-orgmode@gnu.org>
Subject: Re: Proposal: references from code to text.
Date: Mon, 14 May 2018 08:05:08 -0700 [thread overview]
Message-ID: <CAJ51ETq4pk-zk=y4fC-bH6QJvN0h8mR-vUUds3UmNdWyohfq7Q@mail.gmail.com> (raw)
In-Reply-To: <871seebxdt.fsf@gmail.com>
[-- Attachment #1: Type: text/plain, Size: 2404 bytes --]
It seems like this is nearly all possible already (see below). It is a
little wonky that you have to put text in a src txt block to achieve it,
but otherwise what is missing?
* Main document
See [[id:BAD97113-3561-4A4A-BA07-0CD5BF6BA35F][There is a reason we only
support two args]] (text to text) for notes about this function. The
addition is done in line [[(add)]] (text to code).
#+NAME: DOC-OF-ADD
#+BEGIN_SRC txt
"We use the function add to calculate the sum of two numbers."
#+END_SRC
#+NAME: ADD
#+BEGIN_SRC emacs-lisp -n -r :noweb yes :tangle test.el
(defun add (x y)
<<DOC-OF-ADD>> ;; code to code
;; [[id:BAD97113-3561-4A4A-BA07-0CD5BF6BA35F][There is a reason we only
support two args]] code to text
(+ x y) (ref:add)
)
#+END_SRC
#+RESULTS: ADD
: add
** Notes
*** There is a reason we only support two args
:PROPERTIES:
:ID: BAD97113-3561-4A4A-BA07-0CD5BF6BA35F
:END:
John
-----------------------------------
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
On Sun, May 13, 2018 at 10:48 PM, Eric S Fraga <esflists@gmail.com> wrote:
> On Saturday, 12 May 2018 at 13:29, ZHUO QL (KDr2) wrote:
> > Hi all, I just post a proposal for orgmode on my website(generated by
> orgmode):
> > http://kdr2.com/tech/emacs/1805-proposal-org-ref-code-to-text.html .
> > Here is the source of the proposal:
> > # -*- mode: org; mode: auto-fill; -*-
> >
> > #+TITLE: Proposal for Orgmode: references from code to text.
> > #+AUTHOR: KDr2
>
> [...]
>
> > - Beside the ~NAME~, we could also support reference via the
> > ~CUSTOM_ID~ property or anything else that can locate a text chunk.
> > - In the tangling process, we should do some kind of transformation of
> > the target text, for example, escape the quote mark. A hook may be
> > needed to let the user customize the transformation too.
> >
> > What do you think?
>
> I like the symmetry of having src reference text. I guess, in what you
> propose above, that the text that would be incorporated would be a
> single element (in org parsing parlance) or else we would have to
> specify an extent in the link information.
>
> Are you able to implement something? I would definitely help test it.
>
> --
> Eric S Fraga via Emacs 27.0.50, Org release_9.1.6-591-gee336b
>
[-- Attachment #2: Type: text/html, Size: 3666 bytes --]
next prev parent reply other threads:[~2018-05-14 15:05 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <800808596.465327.1526131788117.ref@mail.yahoo.com>
2018-05-12 13:29 ` Proposal: references from code to text ZHUO QL (KDr2)
2018-05-14 5:48 ` Eric S Fraga
2018-05-14 15:05 ` John Kitchin [this message]
2018-05-14 17:06 ` Eric S Fraga
2018-05-14 17:11 ` Eric S Fraga
2018-05-15 4:49 ` ZHUO QL (KDr2)
2018-05-15 10:04 ` Eric S Fraga
2018-05-16 7:04 ` ZHUO QL (KDr2)
2018-05-16 14:25 ` John Kitchin
2018-05-16 19:37 ` Samuel Wales
2018-05-17 2:29 ` John Kitchin
2018-05-17 2:40 ` Samuel Wales
2018-05-17 2:58 ` ZHUO QL (KDr2)
2018-05-17 3:10 ` John Kitchin
2018-05-17 9:33 ` ZHUO QL (KDr2)
2018-06-15 21:44 ` John Kitchin
2018-06-15 18:07 ` Grant Rettke
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
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CAJ51ETq4pk-zk=y4fC-bH6QJvN0h8mR-vUUds3UmNdWyohfq7Q@mail.gmail.com' \
--to=jkitchin@andrew.cmu.edu \
--cc=emacs-orgmode@gnu.org \
--cc=zhuoql@yahoo.com \
/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 external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.