On 03/01/2011 10:22 PM, Jason Grout wrote: > I tried building the standalone html docs using: > > cd doc > python make.py html > > I notice that there are around 30 .pyc files left in the > build/html/pyplots/ directory. Are these needed in the html > documentation build directory? > No -- but they are also a little hard to avoid. I have made a change to clean these out after the fact. > Also, it seems that the files in _images are redundant, as they are > referenced in their original directory, not _images. > > from the build/html directory: > > % find . -name multiline.pdf > ./_images/multiline.pdf > ./plot_directive/mpl_examples/pylab_examples/multiline.pdf > % grep -ri "multiline.pdf" * > examples/pylab_examples/multiline.html:<p>[<a class="reference external" > href="../../plot_directive/mpl_examples/pylab_examples/multiline.py">source > code</a>,<a class="reference external" > href="../../plot_directive/mpl_examples/pylab_examples/multiline.hires.png">hires.png</a>, > <a class="reference external" > href="../../plot_directive/mpl_examples/pylab_examples/multiline.pdf">pdf</a>]</p> > This one is harder. Sphinx annoyingly always copies every image that is displayed on a page to the _images directory. However, it is impossible to link (i.e. through an <a href="...">) to an image in the _images directory. Since our plot directive results need to both display the image and link to different resolutions of them, we have to at least have two copies of the "normal resolution" pngs, unless we can solve the problem in Sphinx itself or do some sort of postprocessing on the HTML output.
However, the .pdf files ending up in _images is the result of the peculiar way in which HTML and LaTeX are generated from the same source. Sphinx seems to think it is displaying both png and pdf images in the HTML and copies them both over. I have added a post-processing step to our build that subsequently removes the pdf files under _images. You can see the changes here: https://github.com/matplotlib/matplotlib/pull/28 Mike > Any comments about trimming down the size of the build/html directory? > > Thanks, > > Jason > > ------------------------------------------------------------------------------ > Free Software Download: Index, Search& Analyze Logs and other IT data in > Real-Time with Splunk. Collect, index and harness all the fast moving IT data > generated by your applications, servers and devices whether physical, virtual > or in the cloud. Deliver compliance at lower cost and gain new business > insights. http://p.sf.net/sfu/splunk-dev2dev > _______________________________________________ > Matplotlib-users mailing list > Matplotlib-users@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/matplotlib-users > -- Michael Droettboom Science Software Branch Space Telescope Science Institute Baltimore, Maryland, USA ------------------------------------------------------------------------------ What You Don't Know About Data Connectivity CAN Hurt You This paper provides an overview of data connectivity, details its effect on application quality, and explores various alternative solutions. http://p.sf.net/sfu/progress-d2d _______________________________________________ Matplotlib-users mailing list Matplotlib-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/matplotlib-users
