On 10/15/2010 04:40 AM, Christoph Zwerschke wrote:
> Am 15.10.2010 09:02 schrieb timblack1:
>> The Sphinx docs say that when you're using the default theme, the
>> sidebar can be made collapsible, but only when the sidebar is on the
>> left side of the page.  Perhaps someone could figure out how to get it
>> working when the sidebar is on the right side of the page, then we'd
>> have a little more readable docs.  It looks like a key part of the
>> collapsible sidebar code ends up in _build/html/_static/sidebar.js, so
>> that might be the place to start.
>
> A collapsible sidebar is a good idea for people with limited screen width.
The problem isn't limited screen width, because the 2.1 docs
<http://www.turbogears.org/2.1/docs/> do not have a fluid layout; they
have a fixed layout.  So, the problem is maybe more for those with a
wider screen--the <div class="body"> element takes up about 1/4 of my
whole screen width, and about 2/3 the width of the <div
class="document"> element.  It would be nice if it could take up the
whole width of the <div class="document"> element (when the sidebar is
collapsed).
> I'll try to implement it in the new layout.
I looked into whether the sidebar could just be given a "float: right"
style so that content in the <div class="body"> element would expand to
fill the whole width of the <div class="body"> element, but that may not
be possible, because <div class="sphinxsidebar"> is not contained within
<div class="body">.  If you can change that nesting order in the
template so the sidebar is nested within the body, then it might be
easier to use "float:right" on <div class="sphinxsidebar"> than to mess
with changing the JavaScript file.  Of course, since this method makes
the sidebar NOT collapsible, this would place a special width limitation
on any images used at the very top of every documentation page.
> Maybe we can even allow switching the sidebar from the left to the
> right side.  However, I don't like the idea of having the side bar on
> the right as default. My reasons are, first, the left side is where
> you usually expect the navigation and table of content in
> left-to-right writing cultures. Second, I see the sidebar as extension
> of the bread crumbs (expansion of the last bread crumb) which are
> (left-eligned)  on the *left* side of the top bar. Of course we could
> move the bread crumbs (right-aligned) to the right side, but that
> would look even more unusual. Plus, we already want the search field
> on the top right since that's also a common place.
In the version of the 2.1 docs I see at
http://www.turbogears.org/2.1/docs/, the sidebar is on the right, and
the breadcrumbs are at the left at the bottom of the page.

Tim

-- 
You received this message because you are subscribed to the Google Groups 
"TurboGears" 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?hl=en.

Reply via email to