On 2/15/10 8:57 PM, Janet Swisher wrote:


On Mon, Feb 15, 2010 at 6:32 PM, Mark Harrison <[email protected]
<mailto:[email protected]>> wrote:

    I have a document which consists of lots of small tech notes,
    a paragraph or so usually with a snippet of code.

    I would like to coalesce these into a single chapter, so I
    don't have lots of links or a latex document with hundreds
    of one-paragraph chapters and therefore pages.

    I was going to do this in the makefile, e.g.

            foo.rst:
                    cat foo_pieces/*.rst >foo.rst

    Is there a better or more canonical way?


You could use the ReST 'include' directive:
http://docutils.sourceforge.net/docs/ref/rst/directives.html#including-an-external-document-fragment

But it sounds like you want to wildcard them so you don't have to
enumerate them. I don't know a way to do that.

It looks like this way is going to work pretty well, and it
has the unexpected side effect of generating html files for
all the foo_pieces/*.rst (at the cost of one warning message
each for not being in the TOC.

So for me, that's perfect... I can point people both at a big document
that's easy to scroll through, and unambiguously at a url
that has exactly one tech note.

Thanks!!
Mark

--
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to