John Hunter schrieb: > I have a sphinx extension directive"plot_directive" > > > http://matplotlib.svn.sourceforge.net/viewvc/matplotlib/trunk/matplotlib/doc/sphinxext/plot_directive.py > > which we use to embed matplotlib plots, with links to src, in our > narrative and API docs, eg > > http://matplotlib.sourceforge.net/users/screenshots.html#ellipses AND > > http://matplotlib.sourceforge.net/api/axes_api.html#matplotlib.axes.Axes.acorr > > The directive call is fairly, simple. Eg, in the Axes.acorr docs in > the link above, we point to an external example:: > > .. plot:: mpl_examples/pylab_examples/xcorr_demo.py > > which triggers a run of xcorr_demo.py, creates a Figure instance, > saves it to a PNG file, and puts the files in the right place so the > sphinx build can find it. This is a great feature for us since we are > a graphics package and can insure that the code we point to a doc > build time actually generates the figure we display. > > What I would like to do is create a single page image gallery of > thumbnails that point to all of our generated examples. We have a > large examples directory that contains many subdirectories consisting > of hundreds of examples. Most of these create figures, some do not, > and some fail due to various errors. We generate one "plot" directive > call for every example file, but some of these fail, and at doc build > time, only the plot directive knows whether an example fails or not. > > So we have a lot of *.rst files which might call the plot directive, > and each of these calls may generate a figure and thumbnail. What I > would like to do is, after all the est files and their associated plot > directives are called, have the ability for the plot_directive.py to > get a "finalize" call in the same way it gets a "setup" call, which > would generate a thumbnail gallery as a rst file or jinja template, > which is then built before the build process exits. > > Currently, I have an external script which iterates over the plot > directive output directory and generates the necessary rst or jinja > html templates, but this requires repeated calls to the build process: > first I build the plot directive images and thumbnails, then run the > script which generates the gallery jinja template, and then rerun the > build prccess to render the gallery. It would be nice if the plot > directive could generate the necessary templates in the first build > (this part is easy), and then trigger a run of these rst/template > files before the build process exits (this is the part I am unsure > about).
Wouldn't the "build-finished" event be fine for running a job at the end of the build process? Geog --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
