Re: [matplotlib-devel] future of mpl documentation

[Darren D. <dar...@co...>]

On Monday 02 June 2008 08:33:55 Michael Droettboom wrote:
> Darren Dale wrote:
> > On Saturday 31 May 2008 11:44:34 pm Darren Dale wrote:
> >> On Saturday 31 May 2008 10:19:47 pm John Hunter wrote:
> >>> On Sat, May 31, 2008 at 9:01 PM, Fernando Perez <fpe...@gm...>
> >
> > I tracked this down by checking the contents of the generated
> > build/latex/Matplotlib.tex, line 954. It is from the following code from
> >
> > mathtext.rst:
> >> When using the STIX fonts, you also have the choice of:
> >>
> >>     ================ =================================
> >>     Command          Result
> >>     ================ =================================
> >>     ``\mathbb``      :math:`\mathbb{Blackboard}`
> >>     ``\mathcircled`` :math:`\mathcircled{Circled}`
> >>     ``\mathfrak``    :math:`\mathfrak{Fraktur}`
> >>     ``\mathsf``      :math:`\mathsf{sans-serif}`
> >>     ================ =================================
> >
> > I'm not sure this is being properly rendered in the HTML output for me,
> > either. Mike, are you able to compile this into a pdf on your machine,
> > and if so, would you tell us how to configure STIX support? I commented
> > this block out in svn for now.
>
> Sorry about that.  It requires the amssymb and/or amsmath LaTeX packages
> to render correctly.  Perhaps it is better to not require the LaTeX
> installation to have anything special though.  I think the best course
> of action is to just include pre-generated images in the documentation
> source for this.  I'll go ahead and do that.

I added doc/static_figs to hold scripts that require optional dependencies to 
generate images for the docs. I would like to be able to keep track of how the 
images are generated, so if we lose one we know how to recreate it. I added 
two scripts (softlinks actually) a README and a make.py to that directory. 
make.py saves the images to doc/_static.