Re: Literate Programming

From	Hans Georg Schaathun <hg@schaathun.net>
Newsgroups	comp.lang.python
Subject	Re: Literate Programming
Date	2011-04-09 16:20 +0100
Organization	University of Bergen
Message-ID	<23a678-b87.ln1@svn.schaathun.net> (permalink)
References	<r7b178-602.ln1@svn.schaathun.net> <e3553833-f504-4651-a219-8b1008134c8f@n12g2000yqc.googlegroups.com> <6r3478-jk5.ln1@svn.schaathun.net> <9b7ae6d0-5ba4-449c-a9c3-82dd583837b0@u8g2000yqh.googlegroups.com>

Show all headers | View raw

On Sat, 9 Apr 2011 03:45:55 -0700 (PDT), Jim
  <jim.hefferon@gmail.com> wrote:
:  I'm sorry; I don't understand "commenting code within a block" but I
:  wondered if it meant you were not fully familiar with the idea of the
:  web-type programs.

The idea was pretty clear from the web page you cited.  The web system
allows merging code and doc's within one file, but it does not provide
a markup language.  Hence I need to find a markup language with suitable
markup to go with it.

:  Before each chunk comes the description of what that chunk does.

Sure, and reST does this fine if every chunk is at the same level of
indentation, but if I split an indented block with a comment, reST
does not preserve the correct indentation.  Similarily, if the else
clause is in a different chunk from the corresponding if clause,
sphinx looses track and will not highlight consistently.  I posted an
example of what I wanted to do in reply to Robert Kern's post.

: > Alternatively, I could use pyweb directly with LaTeX.  However, then
: > I would need to find or create macro packages which provide the
: > features of reST directly in LaTeX.  Do you know of a good candidate?
: 
:  What features?

Standardised and well thought-out markup for functions/methods/classes etc.,
as well as highlighting.  

-- 
:-- Hans Georg

Back to comp.lang.python | Previous | Next — Previous in thread | Next in thread | Find similar

Thread

Literate Programming Hans Georg Schaathun <hg@schaathun.net> - 2011-04-07 19:09 +0100
  Re: Literate Programming jkn <jkn_gg@nicorp.f9.co.uk> - 2011-04-07 12:31 -0700
  Re: Literate Programming Robert Kern <robert.kern@gmail.com> - 2011-04-07 16:21 -0500
    Re: Literate Programming Hans Georg Schaathun <hg@schaathun.net> - 2011-04-08 10:01 +0100
  Re: Literate Programming Jim <jim.hefferon@gmail.com> - 2011-04-08 05:22 -0700
    Re: Literate Programming Hans Georg Schaathun <hg@schaathun.net> - 2011-04-08 20:21 +0100
      Re: Literate Programming Jim <jim.hefferon@gmail.com> - 2011-04-09 03:45 -0700
        Re: Literate Programming Hans Georg Schaathun <hg@schaathun.net> - 2011-04-09 16:20 +0100
  Re: Literate Programming "Tim Arnold" <tim.arnold@sas.com> - 2011-04-08 12:58 -0400
    Re: Literate Programming Hans Georg Schaathun <hg@schaathun.net> - 2011-04-09 16:25 +0100
      Re: Literate Programming "Tim Arnold" <tim.arnold@sas.com> - 2011-04-11 12:39 -0400

csiph-web