Hi, > Scenario: I'm a brand new user to TurboGears. Why should I care about > it? What can it do to make my life better?
I've used TG for a couple of days. I'v been very disturbed by the fact that there are two different templates for the doc. This one http://turbogears.org/2.1/docs/ and this one http://turbogears.org/2.0/docs/. Actually I red almost only on the second one, because the Documentation link of the homepage points to it and this template is much more readable than the first one. I realized later that I was reading deprecated docs. But the fact that there are two templates out there for documentation is very very disturbing for a new user. Emmanuel On 12 oct, 12:28, werner <[email protected]> wrote: > 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.
