fenics team mailing list archive

[Anders Logg <logg@xxxxxxxxx>]

On Tue, May 31, 2011 at 02:10:25PM +0200, Marie E. Rognes wrote:
> On 05/31/2011 01:56 PM, Anders Logg wrote:
> >On Tue, May 31, 2011 at 01:53:03PM +0200, Harish Narayanan wrote:
> >>On 5/31/11 1:49 PM, Anders Logg wrote:
> >>>On Tue, May 31, 2011 at 01:05:44PM +0200, Marie E. Rognes wrote:
> >>>>On 05/31/2011 01:04 PM, Harish Narayanan wrote:
> >>>>>On 5/31/11 1:03 PM, Marie E. Rognes wrote:
> >>>>>>On 05/31/2011 12:58 PM, noreply@xxxxxxxxxxxxx wrote:
> >>>>>>>------------------------------------------------------------
> >>>>>>>revno: 296
> >>>>>>>committer: Harish Narayanan<hnarayanan@xxxxxxxxx>
> >>>>>>>branch nick: fenics-doc
> >>>>>>>timestamp: Tue 2011-05-31 12:57:19 +0200
> >>>>>>>message:
> >>>>>>>    Removed<h2>    as requested by Marie
> >>>>>>>modified:
> >>>>>>>    source/_themes/fenics/layout.html
> >>>>>>>
> >>>>>>>
> >>>>>>
> >>>>>>I've merged fenics-doc/1.0 with fenics-doc as you might have noticed ;-)
> >>>>>>
> >>>>>>Please push there.
> >>>>>
> >>>>>Done.
> >>>>>
> >>>>
> >>>>Great, thanks :-)
> >>>
> >>>What is the motivation for the merge? Luckily the cronjob that
> >>>automatically pulls from fenics-doc and publishes it on the web page
> >>>is not running. (And I would like to keep it so until the pages are
> >>>ready for launch.)
> >>>
> >>>As discussed last week (with either Marie or Harish, don't remember),
> >>>perhaps it is more natural now to put the web pages under fenics-web
> >>>instead of fenics-doc (now that the actual docs are located in the
> >>>projects)?
> >>>
> >>>Harish: what we will get from the designer is the main logo to be
> >>>placed in the top right corner of the red banner, or perhaps the
> >>>entire banner including the logo and the text "FEniCS Project" in that
> >>>special font. We will also get a bunch of icons in various sizes and
> >>>formats (desktop install, small thumbnail for newsitems etc), so feel
> >>>free to move ahead with the design/structuring of the main page any
> >>>time.
> >>
> >>Is this designer not providing some sort of overall look for the site as
> >>well?
> >
> >I have not asked for that specifically since I kind of like what we
> >have now.
>
>
> I miss some navigation in "what is now". If exactly the same theme
> is also to be used for the documentation, I think this will be
> become even more apparent. For browsing the documentation, the
> classical sphinx sidebars (or some variant of those) with next
> topic/previous/table of contents/modules/index etc are really
> useful.

Agree. I think there should be

1. Some text at the top that tells you where you are (relative to the
top level): About, Installation, Documentation etc.

2. For the docs, I think there should be a sidebar of some kind with a
table of contents. Not sure whether it should be embedded as part of
the page or actually on the side.

I don't know how to set a sidebar/toc for just some pages.

--
Anders