On Wed, Dec 17, 2008 at 10:52 AM, Michael Droettboom <md...@stsci.edu> 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

------------------------------------------------------------------------------
SF.Net email is Sponsored by MIX09, March 18-20, 2009 in Las Vegas, Nevada.
The future of the web can't happen without you.  Join us at MIX09 to help
pave the way to the Next Web now. Learn more and register at
http://ad.doubleclick.net/clk;208669438;13503038;i?http://2009.visitmix.com/
_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

Reply via email to