On Mar 13, 2009, at 6:24 AM, Michele Simionato wrote:
> > I would like to use Sphinx to process my "Adventures of a Pythonista > in Schemeland" > (http://www.artima.com/weblogs/viewpost.jsp?thread=251474) and > collect them in > a nice hyperlinked document with search capabilities. > Each Adventure is a Scheme file (extension .ss) which contains a big > docstring with > the text of the Adventure, in ReST format. Currently I have a function > scheme2rst(schemefilename) which takes in input the filename of the > Scheme file > (for instance adventure1.ss) and returns the filename of the > corresponding .rst > file (i.e. adventure1.rst), which is written on the file system as a > side effect. > I could very well write a preprocessor script that converts all the > Scheme files > to rst files and run Sphinx after that, but I would rather prefer to > integrate my > scheme2rst utility in Sphinx, so that I can avoid errors like > forgetting to regenerate > the .rst files. What's the suggested way to do something like that? > I assume there are hooks in Sphinx such that I can preprocess the > files > automatically. > Thanks for any hint, > > Michele Simionato I've found Cog very helpful for combining source and rst files in a way similar to what you describe. http://blog.doughellmann.com/2009/02/writing-technical-documentation-with.html Doug --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-dev@googlegroups.com To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~----------~----~----~----~------~----~------~--~---