fenics team mailing list archive

[Kristian Ølgaard <k.b.oelgaard@xxxxxxxxx>]

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

I will object to using 5-9.

Kristian

>> 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/

Looks a lot like the sphinxdoc theme.

Kristian

> 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
>
> _______________________________________________
> Mailing list: https://launchpad.net/~fenics
> Post to     : fenics@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~fenics
> More help   : https://help.launchpad.net/ListHelp
>