fenics team mailing list archive

[Anders Logg <logg@xxxxxxxxx>]

On Thu, Aug 26, 2010 at 11:41:07AM +0530, Harish Narayanan wrote:
> On 8/25/10 11:34 PM, Anders Logg wrote:
> > On Wed, Aug 25, 2010 at 05:46:14PM +0100, Garth N. Wells wrote:
> >> I get the error
> >>
> >>   Theme error:
> >>   no theme named 'agogo' found (missing theme.conf?)
> >>   make: *** [html] Error 1
> >>
> >> when I try to build to doc. Should this theme be added?
> >
> > You need to upgrade your Sphinx:
> >
> >   sudo apt-get install python-setuptools
> >   sudo apt-get remove python-sphinx
> >   sudo easy_install -U Sphinx
>
> While on this topic, the existing themes in Sphinx are as follows:
>
> agogo
> basic
> default
> epub
> haiku
> nature
> scrolls
> sphinxdoc
> traditional
>
> You can try each one out by changing html_theme in source/conf.py and
> re-making the documentation. I personally like 'nature'. Also, see the
> following thread for ideas: http://bit.ly/cC5oTC
>
> What is everyone's personal opinion on how the documentation should
> look? (This information will be used as "community design input" toward
> the web site.)

I think the matplotlib documentation looks good:

http://matplotlib.sourceforge.net/

Ultimately, our documentation should have the look and feel of our
(new) web site.

I just changed from the old style since that made sections and
subsections look very similar.

--
Anders