Re: [matplotlib-devel] Debian + mpl 0.98.5 - Can we reduce the size of generated doc?

On Tue, Dec 16, 2008 at 15:39, John Hunter <jd...@gm...> wrote:
> On Tue, Dec 16, 2008 at 8:10 AM, Michael Droettboom <md...@st...> wrote:
>
>> Another option would be to not generate the high-res png and pdf
>> examples.  (Either or both).  Just removing them after the fact won't
>> work, since one would end up with broken links from the docs.  We would
>> also have to change the html to not include those links.  It should be
>> fairly simple to provide an option to the doc build system to do this,
>> and I'm happy to implement that if we all agree that's the direction to
>> take.
>
> This is fine with me.  Just add an rc option
>
>  doc.minimal_footprint
>
> or something like that which drops the high res and pdf.  This will
> prbably reduce the size 50-60%

yes yes please :) It would be really great to have it

full pylab_examples: 53M
pylab_examples no hires: 26M
pylab_examples no hires and no pdf: 12M

completely another story! ;)

> I have also removed the mpl_data symlink in my doc tree, and am still
> testing before I commit, because that is causing our binaries to get
> much larger on platforms which do not properly support linking.
> Instead, we'll refer explicitly to ../lib/matplotlib/mpl-data in the
> docs.  I am leaving the mpl_examples symlink because of all the
> relative path woes in pyplot.

Another patch I can remove as soon as another release is done :)

> Other than simple optimizations like this, I am discinclined to try
> and build smaller manuals simply to reduce their size.  The feature

Exactly the same goal I have in mind: I don't want to reduce the
information, but only those parts that adds "little" to the end users
while add a lot of space (if you get what I mean).

> that caused the explosion in size between 98.3 and 98.5 is the
> gallery, and image enhanced examples, which is arguably the most
> useful feature on the site.

And even as a local reference!! I had once to display dates and I was
sure I've seen an example that did it, but I didn't remember which
one, so I run all of them to find it. Now I would have to look up a
nice page full of images: much better!

Cheers,
-- 
Sandro Tosi (aka morph, Morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi