← Back to team overview

fenics team mailing list archive

Re: error building doc

 

On Thu, Aug 26, 2010 at 10:57:15AM +0200, Kristian Ølgaard wrote:
> On 26 August 2010 09:21, Anders Logg <logg@xxxxxxxxx> wrote:
> > 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
>
> This is how I rate them:
> agogo       # 4 (I would rate this number #2, maybe #1 if there was
> more difference between
>                       -- and ^^ sections in the table of contents, and
> 'note' and 'warning' did not look the same.)
> basic        # 8
> default      # 3
> epub         # 7
> haiku        # 6
> nature       # 1
> scrolls      # 9
> sphinxdoc # 2
> traditional  # 5

nature:

  Layout/organization looks good but I think it looks too bleak and
  washed-out. Maybe it would be simple to just change the colors.

sphinxdoc:

  I like this better than 'nature', but it looks too much like the
  Sphinx documentation. :-)

  But it's better than 'agogo' in formatting code (the blue box).

default:

  Can't see the difference between sections and subsections.

My rating would be

 1. sphinxdoc
 2. agogo
 3. nature
 4. default

I'll change to sphinxdoc for now.

--
Anders



References