Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-24 Thread Ryan May
Michael Droettboom wrote: > I think what's going on there is a syntax error in the clabel docstring > that is truncating it. I fixed this in SVN. I think there's a cron job > running, so this should update in due time. > > In general, the documentation is built directly from the docstrings in >

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-24 Thread Michael Droettboom
I think what's going on there is a syntax error in the clabel docstring that is truncating it. I fixed this in SVN. I think there's a cron job running, so this should update in due time. In general, the documentation is built directly from the docstrings in SVN so they should correspond, but

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-24 Thread Ryan May
John Hunter wrote: > On Thu, Oct 23, 2008 at 10:51 AM, Ryan May <[EMAIL PROTECTED]> wrote: > >> I've done it for barbs and I'll see if I notice anything else as time >> allows. Obviously I'm biased towards certain functionality. :) I'm >> guessing you guys have to do regenerate the docs and push

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-23 Thread Ryan May
Michael Droettboom wrote: > Ryan May wrote: >> John Hunter wrote: >>> Yes, but it's pretty easy. To build and update from the docs dir, I >>> just do >>> >>> python make.py html sf >>> I've pushed your changes out -- thanks! >>> >> >> Thanks. Now, did I do something wron

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-23 Thread John Hunter
On Thu, Oct 23, 2008 at 11:44 AM, Michael Droettboom <[EMAIL PROTECTED]> wrote: > It's probably just that John didn't rebuild matplotlib itself and then clean > before republishing the docs. Your change works for me locally. I think the trick is I also have to "touch" the pymods_api.rst doc. I

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-23 Thread Michael Droettboom
Ryan May wrote: > John Hunter wrote: > >> On Thu, Oct 23, 2008 at 10:51 AM, Ryan May <[EMAIL PROTECTED]> wrote: >> >> >>> I've done it for barbs and I'll see if I notice anything else as time >>> allows. Obviously I'm biased towards certain functionality. :) I'm >>> guessing you guys have

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-23 Thread Ryan May
John Hunter wrote: > On Thu, Oct 23, 2008 at 10:51 AM, Ryan May <[EMAIL PROTECTED]> wrote: > >> I've done it for barbs and I'll see if I notice anything else as time >> allows. Obviously I'm biased towards certain functionality. :) I'm >> guessing you guys have to do regenerate the docs and push

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-23 Thread John Hunter
On Thu, Oct 23, 2008 at 10:51 AM, Ryan May <[EMAIL PROTECTED]> wrote: > I've done it for barbs and I'll see if I notice anything else as time > allows. Obviously I'm biased towards certain functionality. :) I'm > guessing you guys have to do regenerate the docs and push them somewhere > before a

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-23 Thread Ryan May
John Hunter wrote: > On Thu, Oct 23, 2008 at 9:53 AM, Ryan May <[EMAIL PROTECTED]> wrote: >> I'll comment that the new site looks absolutely awesome. I've turned >> quite a few heads around here when I show people the new site and docs, >> especially the gallery. Great work guys! >> >> One questio

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-23 Thread John Hunter
On Thu, Oct 23, 2008 at 9:53 AM, Ryan May <[EMAIL PROTECTED]> wrote: > I'll comment that the new site looks absolutely awesome. I've turned > quite a few heads around here when I show people the new site and docs, > especially the gallery. Great work guys! > > One question, how is the list of "plo

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-23 Thread Ryan May
I'll comment that the new site looks absolutely awesome. I've turned quite a few heads around here when I show people the new site and docs, especially the gallery. Great work guys! One question, how is the list of "plotting commands" on the main page generated? Is it just the pyplot API? Right

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-23 Thread Michael Droettboom
Fixed. These errors were all in new content. Any comments on the content? ... :) Xavier Gnata wrote: > ok. > It is way better now but still: > http://validator.w3.org/check?uri=http%3A%2F%2Fmatplotlib.sourceforge.net%2F&charset=(detect+automatically)&doctype=Inline&group=0 > > > > hum I should

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-23 Thread Xavier Gnata
ok. It is way better now but still: http://validator.w3.org/check?uri=http%3A%2F%2Fmatplotlib.sourceforge.net%2F&charset=(detect+automatically)&doctype=Inline&group=0 hum I should spend some time on this because: http://validator.w3.org/check?uri=http%3A%2F%2Fmatplotlib.sourceforge.net%2Fgallery.h

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-22 Thread John Hunter
On Wed, Oct 22, 2008 at 1:38 PM, Anthony Floyd <[EMAIL PROTECTED]> wrote: > On Wed, Oct 22, 2008 at 11:00 AM, Michael Droettboom <[EMAIL PROTECTED]> > wrote: >> Some of the documentation has not yet been reformatted to reST for Sphinx. >> >> There is a status page here: >> >> http://matplotlib.sou

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-22 Thread Anthony Floyd
On Wed, Oct 22, 2008 at 11:00 AM, Michael Droettboom <[EMAIL PROTECTED]> wrote: > Some of the documentation has not yet been reformatted to reST for Sphinx. > > There is a status page here: > > http://matplotlib.sourceforge.net/devel/outline.html Ah, thanks! [snip] > As to whether we provide the

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-22 Thread Michael Droettboom
Some of the documentation has not yet been reformatted to reST for Sphinx. There is a status page here: http://matplotlib.sourceforge.net/devel/outline.html (And I'm embarrassed to note that I'm slated to update the ticker module... ;) As to whether we provide the old docs in parallel -- I'll

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-22 Thread Anthony Floyd
While I like the redesign (and Sphinx in general), it seems some information has gone missing, particularly with regards to the API documentation. For example, ticker.py has a tonne of useful information in the docstring about how to set up formatters and tickers. For some reason I just cannot fi

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-21 Thread Stef Mientki
Michael and John, this is really fantastic !! thanks, Stef John Hunter wrote: > On Fri, Oct 17, 2008 at 12:37 PM, Zane Selvans <[EMAIL PROTECTED]> wrote: > > >> A thumbnail gallery of all the examples in the User's Guide and Examples is >> a great idea! >> Plots are inherently visual, and human

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-21 Thread John Hunter
On Fri, Oct 17, 2008 at 12:37 PM, Zane Selvans <[EMAIL PROTECTED]> wrote: > A thumbnail gallery of all the examples in the User's Guide and Examples is > a great idea! > Plots are inherently visual, and humans have a huge amount of built-in > visual processing power. Searching a even an enormous

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-17 Thread Zane Selvans
First, are there plans to eventually embed autogenerated plots in the the "examples" section (http://matplotlib.sourceforge.net/examples/ ) in the same way that they're embedded within the user guide? There are plans to do that, and probably to

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-17 Thread Scott Sinclair
> "John Hunter" <[EMAIL PROTECTED]> 10/16/08 6:39 PM > We've been working behind the scenes on a new documentation system for > matplotlib, which integrates the web site, API documentation and PDF > As an example we can include plots in our API documentation, see > > http://matplotlib.sourceforg

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-17 Thread Michael Droettboom
This has now been fixed in SVN. index.html is the only page that includes hand-written HTML. If you see any errors of this nature on other pages, please file bugs with Sphinx and/or docutils. Cheers, Mike Xavier Gnata wrote: > Looks great but there are too many errors: > http://validator.w3.o

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-17 Thread Michael Droettboom
Zane Selvans wrote: > Wow! The new site looks beautiful. Thank you! > > The apparent lack of searchable, online, well organized, > cross-referenced documentation has been my main frustration with > Matplotlib. I'm very glad it's being worked on. > > A couple of quick things: > > First, are the

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-16 Thread Zane Selvans
Wow! The new site looks beautiful. Thank you! The apparent lack of searchable, online, well organized, cross- referenced documentation has been my main frustration with Matplotlib. I'm very glad it's being worked on. A couple of quick things: First, are there plans to eventually embed au

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-16 Thread Neil Pilgrim
John Hunter wrote: > We've been working behind the scenes on a new documentation system for > matplotlib, which integrates the web site, API documentation and PDF > guide into a single source of sphinx/rest documents which are easier > to maintain and extend, hopefully leading to better and more >

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-16 Thread Xavier Gnata
Looks great but there are too many errors: http://validator.w3.org/check?uri=http%3A%2F%2Fmatplotlib.sourceforge.net%2F&charset=(detect+automatically)&doctype=Inline&group=0 I'm not a geek and I do not care about w3c small warnings but it would be so nice to have a xhtml compliant website (as clo

Re: [Matplotlib-users] ANN: matplotlib website 1.0

2008-10-16 Thread Jörgen Stenarson
The new webpage looks great, sphinx has really meant a lot for the documentation in the scientific projects. > > Because some of these extensions are generally useful, Michael, > Fernando and I have been working on a "sphinx_template" which contains > the template of a sphinx documentation projec

[Matplotlib-users] ANN: matplotlib website 1.0

2008-10-16 Thread John Hunter
We've been working behind the scenes on a new documentation system for matplotlib, which integrates the web site, API documentation and PDF guide into a single source of sphinx/rest documents which are easier to maintain and extend, hopefully leading to better and more up-to-date docs. We went liv