Christoph and Michael,
On 11/10/2010 23:06, Christoph Zwerschke wrote:
...
You can have a sticky sidebar with the Sphinx default template by
setting
the stickysidebar option. Unfortunately, there is no such option for
the top
and bottom bars, so the top links and bread crumbs move away when
scrolling.
Not good. Seens very few docs have sticky navigation, maybe because of
compatibility issues with various browsers. We would probably need
to invent
something on our own.
My only object to having more floating sections is real estate. As it
stands, we're going to have something on the side, taking up screen
space. If we add something sticky to the top and/or bottom, we're
going to lose more screen real estate. I don't think I'm in favor of
that at all.
It's not really such a big problem in these times of wide screens any
more. Usually you have to make the page narrower anyway because text
with long lines is not good for readability. But I agree it can still
be a problem if you go several levels down, and the section titles get
indented and longer, then either you need a really wide sidebar or the
entries will we wrapped to several lines. Plus, it creates more noise
on the screen. More whitespace makes makes it more pleasing to read.
So maybe we should completely dismiss the sidebar, and use clean,
small tocs at the top, and properly working breadcrumbs instead. The
SQLAlchemy docs are a good example: http://www.sqlalchemy.org/docs/
I use SA and while the documentation is incredible, the lack of the side
bar is something I miss. On my monitors (17 inch notebook and 22 inch
desktop) I have about 300 - 400 pixels white space on both sides with
the SA doc - space for a sidebar :-) .
Very much like Christoph's sample, with the exception that I would put
the sidebar on the right side, i.e. out of the way but it is still there
when I want/need to search use the TOC to jump else where. Not sure if
the top and bottom need to be sticky too, and the actual documentation
section doesn't need to be as wide as it is. Maybe similar to Sphinx but
with sticky sidebar - http://sphinx.pocoo.org/tutorial.html?
Just my 0.02€
Werner
--
You received this message because you are subscribed to the Google Groups
"TurboGears Trunk" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/turbogears-trunk?hl=en.
