classification
Title: Can doc index of html version be separately scrollable?
Type: feature request Stage:
Components: Documentation Versions: Python 3.1, Python 3.0, Python 2.7, Python 2.6
process
Status: open Resolution:
Dependencies: Superseder: Wide literals in the table of contents overflow in documentation
View: 4711
Assigned To: ezio.melotti Nosy List: ezio.melotti, georg.brandl, orsenthil, tjreedy (4)
Priority: normal Keywords

Created on 2009-01-16 23:30 by tjreedy, last changed 2009-07-01 11:55 by ezio.melotti.

Messages (6)
msg79986 - (view) Author: Terry J. Reedy (tjreedy) Date: 2009-01-16 23:30
In the Windows help version of the docs that come with the Windows .msi
installer, the index pane to the left scrolls separately from the
content pane to the right.  Very nice for jumping around even to other docs.

In the html versions at docs.python.org, there is one scroll bar and the
index disappears when one moves very far down the page.  If sensibly
possible, decoupling index and context would be nice.  Please pardon my
ignorance if not.
msg80437 - (view) Author: Senthil Kumaran (orsenthil) Date: 2009-01-24 06:56
Terry, I think you mean the Sidebar content, right? 
Yes, I agree with you. It would be desirable to have the Sidebar
Fixed, while we scroll the document (Like this:
http://www.w3.org/Style/CSS/) 

This has to be worked out in the Sphnix CSS.
msg81302 - (view) Author: Georg Brandl (georg.brandl) Date: 2009-02-06 21:53
I've experimented with a style variant that keeps the sidebar fixed on
the left side, however I did not manage to get it to show a separate
scrollbar.  Maybe I was just stupid though.
msg81306 - (view) Author: Ezio Melotti (ezio.melotti) Date: 2009-02-06 22:08
Something like this maybe?

div.sphinxsidebar {
    float: left;
    width: 230px;
    height: 100%;
    font-size: 90%
    /* add these: */
    margin-top: 30px;
    height: 100%;
    overflow: auto;
    position: fixed;
}

...

div.related {
    background-color: #133f52;
    color: #fff;
    width: 100%;
    line-height: 30px;
    font-size: 90%;
    /* add this: */
    position: fixed;
}

I tested it only with Firefox3 and the Webdeveloper plugin and it looks
ok. "position: fixed" doesn't work on IE6 and there could be other
problems, but it may be a good starting point.
msg89966 - (view) Author: Ezio Melotti (ezio.melotti) Date: 2009-07-01 09:03
See also #3143.
I'll try to do a proper patch to fix this issue.
msg89971 - (view) Author: Ezio Melotti (ezio.melotti) Date: 2009-07-01 10:20
"overflow: auto" should fix #4711 too (adding an horizontal scroll bar
at the bottom of the sidebar).
History
Date User Action Args
2009-07-01 11:55:12ezio.melottisetpriority: normal
assignee: georg.brandl -> ezio.melotti
2009-07-01 10:20:12ezio.melottisetassignee: ezio.melotti -> georg.brandl
superseder: Wide literals in the table of contents overflow in documentation
messages: + msg89971
stage: needs patch ->
2009-07-01 09:03:39ezio.melottisetassignee: georg.brandl -> ezio.melotti
messages: + msg89966
stage: needs patch
2009-02-06 22:08:26ezio.melottisetnosy: + ezio.melotti
messages: + msg81306
2009-02-06 21:53:43georg.brandlsetmessages: + msg81302
2009-01-24 06:56:04orsenthilsetnosy: + orsenthil
messages: + msg80437
2009-01-16 23:30:32tjreedycreate