From: Ben F. <big...@be...> - 2006-09-07 00:42:52
|
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...> |