Hi Adam! On Mon, Dec 8, 2014 at 5:40 PM, Adam Hughes <hughesadam87@gmail.com> wrote:

I really am impressed by this plt2rst.py module for autogenerating example documentation!

I've been trying to implement it just to test it out and think I have it setup right in terms of placement in my docs directory, I made an example plot_test.py file in examples, but I'm confused on how to actually use the plt2rst.py module. Consider this line from that file:

def setup(app): app.connect('builder-inited', generate_example_galleries)

app.add_config_value('plot2rst_paths', ('../examples', 'auto_examples'), True

When/how is this ever called? The examples themselves don't use these directives; so when is this found?

This plotting code is partially my fault, so I'll try to explain based on memory. I should say, though, that I adapted this code from an older version in the `scikit-image` docs, which took it from `scikit-learn` (which may have taken it from nipy or some other project). That is to say, I don't completely understand all the things. ;) This particular `setup(app)` function is run as part of the Sphinx infrastructure (see http://sphinx-doc.org/extdev/tutorial.html).

When I build in my make file, no auto_examples.html file is ever created in my build directory. So I'm thinking I'm not using this correctly. Is there another step besides just doing make build?

There's a bit of documentation written up here: https://github.com/tonysyu/mpltools/blob/master/doc/source/getting_started.r... One possible hang-up is that examples are expected to start with `plot_` and an `index.rst` file is required in gallery directories. I haven't looked at this in a while, but if you have any more questions, I can try to dig into the code a bit to try to remember what's going on. Cheers! -Tony