From mboxrd@z Thu Jan  1 00:00:00 1970
From: "Charles C. Berry" <ccberry@ucsd.edu>
Subject: Re: Include sections of org document in tangled files
Date: Wed, 7 Dec 2016 19:12:15 -0800
Message-ID: <alpine.OSX.2.20.1612071759010.980@charles-berrys-macbook.local>
References: <m2inr2dm13.fsf@block-party.net>
	<alpine.OSX.2.20.1612030950530.882@charles-berrys-macbook.local>
	<m2d1h3qp4s.fsf@block-party.net>
Mime-Version: 1.0
Content-Type: text/plain; format=flowed; charset=US-ASCII
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:33921)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ccberry@ucsd.edu>) id 1cEp8B-0003Lw-Ja
	for emacs-orgmode@gnu.org; Wed, 07 Dec 2016 22:12:24 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ccberry@ucsd.edu>) id 1cEp87-0003ho-K7
	for emacs-orgmode@gnu.org; Wed, 07 Dec 2016 22:12:23 -0500
Received: from iport-acv5-out.ucsd.edu ([132.239.0.10]:32712)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_ARCFOUR_SHA1:16) (Exim 4.71)
	(envelope-from <ccberry@ucsd.edu>) id 1cEp87-0003gX-5g
	for emacs-orgmode@gnu.org; Wed, 07 Dec 2016 22:12:19 -0500
In-Reply-To: <m2d1h3qp4s.fsf@block-party.net>
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode/>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: David Dynerman <emperordali@block-party.net>
Cc: emacs-orgmode@gnu.org

On Wed, 7 Dec 2016, David Dynerman wrote:

> Dear Chuck,
>
> Your suggestion worked fantastically - I got it working and am very excited.
>
> Now, the next step is figuring out how to handle typesetting math in single way between org and python docstrings. Math in Python docstrings is usually done by RestructuredText markdown, e.g.:
>
> :math:`f(x) = x^2`
>
> while the org code should just be, for example,
>
> \[
> f(x) = x^2
> \]
>

> So the goal would be have noweb not only include a documentation block 
> in the python code, but also call a translation function that identifies 
> LaTeX fragments in the org source and converts them to ReST markdown.
>

This is do-able.

First, look at

 	(info "(org) Noweb reference syntax")

and note that the noweb reference

 	<<my-src-block(x="value_for_x")>>

will call `my-src-block' with the `x' var set to "value_for_x" and insert 
the output into the current src block.

Second, https://github.com/masayuko/ox-rst has a reStructuredText backend. 
So, you can install ox-rst.el, then write an emacs-lisp src block:


#+NAME: export-body
#+BEGIN_SRC emacs-lisp :var src-block-name="my-code" :results raw
   (save-excursion
     (org-babel-goto-named-src-block
      src-block-name)
     (org-export-string-as
      (org-babel-expand-src-block)
      'rst t))
#+END_SRC

and then a src-block like this

#+BEGIN_SRC emacs-lisp :noweb yes :tangle yes
<<export-body("my-code")>>
#+END_SRC

will insert the rst formatted text from the `my-code' src block when the 
latter src block is tangled.

p.s. Untested with 'rst.

HTH,

Chuck