Re: [matplotlib-devel] Doc changes

On Wed, Dec 17, 2008 at 10:52 AM, Michael Droettboom <md...@st...> wrote:

> SUMMARY: Since so much has changed in the doc build, I need help testing
> it in other environments -- particularly because LaTeX docs have never
> built on my machine.  I've done this on the branch, so the Debian guys
> can run with it, but it's a little risky, due to the depth of cuts I had
> to make.  I've tested successfully with Sphinx 0.5.1 and docutils 0.5.
> Please clean your checkout and then build for yourself and let me know
> if you see anything funny.
>
> DETAILS:
>
> You can now do
>
>  python make.py --small html
>
> which will only generate low-res PNGs for the html build.  "--small" has
> no effect for pdf build.

Very nice -- it seems like you've solved some of the unneeded rebuild
problems we had been having too, because successive calls to make html
seem to go much faster now.

> gen_gallery now runs in a sphinx callback (env-updated) after all the
> input files have been parsed, (and all the plots have been generated),
> but right before the html or latex is written out.  This eliminates the
> need to run the build multiple times, and the need to have an
> autogenerated file (doc/_templates/gallery.html) in SVN.  The thumbnail
> downsampling is now done as part of this step, rather than as part of
> plot_directive, since it isn't needed for LaTeX builds.

I have built the pdf on a linux environment and the html on a linux
and os x environment, so it is looking good.  I've built with and w/o
the --small

> Lastly, since files are in many different places, the Sourceforge site
> should probably be cleaned (if it isn't automatically already) to ensure
> we don't go over quota.

Will do -- some time ago I emailed the sf support people and asked for
a quota increase, and they replied that there wasn't really a quota
anymore, but I will clean it so we minimize our footprint.  And it
they ever do get anxious about the size we consume, we can always go
--small :-)

Thanks again, sorry that was such a bear.  Hopefully the plot
directive emerges stronger from the carnage.

JDH