Re: [Docutils-users] include *part* of file

[Ben F. <big...@be...>]

Alan G Isaac <ai...@am...> writes:

> > Alan G Isaac <ai...@am...> writes: 
> >> I need to include parts of some external files.
>
> On Thu, 07 Sep 2006, Ben Finney apparently wrote: 
> > What is the use case? And why is it not solved by breaking out the
> > "part" to a separate file, that gets included in each file that
> > needs it?
>
> My current need:
> I am discussing some code.  I need to use current examples of the
> actual code.  If the code changes, I need those changes to be
> reflected in my document.

My suggested solution:

Have the document-processing rules do a pre-processing step, to
extract all pieces directly from the program source documents to
separate reST files first (named such that the main reST document
references them), then call docutils.

> A need at other times:
> I am referencing documents that are under active revision, and I
> need to include text drawn from the current version of those
> documents.

Ditto.

I would be very disappointed to see this pre-processing feature added
to docutils, which is explicitly focussed on processing the markup and
rendering it.

-- 
 \      "There is more to life than increasing its speed."  -- Mahatma |
  `\                                                            Gandhi |
_o__)                                                                  |
Ben Finney <be...@be...>