Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-26 Thread Stephen J. Turnbull
On Mon, Mar 26, 2012 at 6:42 AM, Terry Reedy wrote: >> Of course you can always use a user stylesheet to override our choices. > > Can anyone tell me the best way to do that with FireFox? http://kb.mozillazine.org/UserContent.css explains clearly enough. I can't help you with your particular ve

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-26 Thread Éric Araujo
Hi, Le 25/03/2012 15:25, Georg Brandl a écrit : > On 25.03.2012 21:11, Steven D'Aprano wrote: >> I think it would be better to leave 2.7 with the old theme, >> to keep it visually distinct from the nifty new theme used >> with the nifty new 3.2 and 3.3 versions. > Hmm, -0 here. I'd like more opin

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-26 Thread Ethan Furman
Antoine Pitrou wrote: On Sun, 25 Mar 2012 08:34:44 +0200 Also I think there should be some jquery animation when collapsing/expanding. Please, no. I don't need my technical web pages singing and dancing for me. ;) ~Ethan~ ___ Python-Dev mailing l

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-26 Thread Ethan Furman
Antoine Pitrou wrote: On Mon, 26 Mar 2012 12:25:20 -0700 Ethan Furman wrote: Georg Brandl wrote: On 25.03.2012 21:11, Steven D'Aprano wrote: Georg Brandl wrote: Thanks everyone for the overwhelmingly positive feedback. I've committed the new design to 3.2 and 3.3 for now, and it will be li

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-26 Thread Antoine Pitrou
On Mon, 26 Mar 2012 12:25:20 -0700 Ethan Furman wrote: > Georg Brandl wrote: > > On 25.03.2012 21:11, Steven D'Aprano wrote: > >> Georg Brandl wrote: > >> > >>> Thanks everyone for the overwhelmingly positive feedback. I've committed > >>> the > >>> new design to 3.2 and 3.3 for now, and it will

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-26 Thread Ethan Furman
Georg Brandl wrote: Here's another try, mainly with default browser font size, more contrast and collapsible sidebar again: http://www.python.org/~gbrandl/build/html2/ I've also added a little questionable gimmick to the sidebar (when you collapse it and expand it again, the content is shown at

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-26 Thread Ethan Furman
Georg Brandl wrote: On 25.03.2012 21:11, Steven D'Aprano wrote: Georg Brandl wrote: Thanks everyone for the overwhelmingly positive feedback. I've committed the new design to 3.2 and 3.3 for now, and it will be live for the 3.3 docs momentarily (3.2 isn't rebuilt at the moment until 3.2.3 fin

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-26 Thread Terry Reedy
On 3/26/2012 8:46 AM, Zvezdan Petkovic wrote: On Mar 26, 2012, at 12:22 AM, Terry Reedy wrote: Does the css specify Courier New or is this an unfortunate fallback that might be improved? Perhaps things look better on max/*nix? I just checked pydoctheme.css and Courier New is not specified th

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-26 Thread R. David Murray
On Mon, 26 Mar 2012 08:44:40 -0400, Scott Dial wrote: > Why even bother formatting the page? The web started out as *content markup*. Functional declarations, not style declarations. I wish it had stayed that way, but it was inevitable that it would not. > The authorship and editorship have a

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-26 Thread Matt Joiner
the text in the nav bar is too small, particularly in the search box. ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archi

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-26 Thread Zvezdan Petkovic
On Mar 26, 2012, at 12:22 AM, Terry Reedy wrote: > Does the css specify Courier New or is this an unfortunate fallback that > might be improved? Perhaps things look better on max/*nix? I just checked pydoctheme.css and Courier New is not specified there. It only specifies monospace. That's a d

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-26 Thread Scott Dial
On 3/26/2012 1:00 AM, Greg Ewing wrote: > This seems to be another case of the designer over-specifying > things. The page should just specify a sans-serif font and let > the browser choose the best one available. Or not specify > a font at all and leave it up to the user whether he wants > serif o

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Matt Joiner
FWIW it doesn't hurt to err on the side of what worked. i have generally have issues with low contrast, the current stable design is very good with this. i've just built the docs from tip, and the nav bar issue is fixed, nicely done i also don't see any reason to backport theme changes, +0 __

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Greg Ewing
Steven D'Aprano wrote: While I sympathize with the ideal of making the docs readable, particular for those of us who don't have 20-20 vision, "must be readable from halfway across the room" is setting the bar too high. The point is that reducing contrast never makes anything more readable, an

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Terry Reedy
On 3/25/2012 8:37 PM, Steven D'Aprano wrote: For what it's worth, it wouldn't surprise me if the problem is the fallback font. If I'm reading the CSS correctly, the standard font used in the new docs is Lucinda Grande, with a fallback of Arial. Unfortunately, Lucinda Grande is normally only avai

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Eli Bendersky
On Sun, Mar 25, 2012 at 21:25, Georg Brandl wrote: > On 25.03.2012 21:11, Steven D'Aprano wrote: >> Georg Brandl wrote: >> >>> Thanks everyone for the overwhelmingly positive feedback.  I've committed >>> the >>> new design to 3.2 and 3.3 for now, and it will be live for the 3.3 docs >>> momentar

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Terry Reedy
On 3/25/2012 8:37 PM, Steven D'Aprano wrote: Terry Reedy wrote: I ran the following experiment: I put old and new versions of the buitin functions page side-by-side in separate browser windows. I asked my teenage daughter to come into the room, approach slowly, and say when she could read one

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Scott Dial
On 3/25/2012 8:37 PM, Steven D'Aprano wrote: > E.g. change the font-family from > > font-family: 'Lucida Grande',Arial,sans-serif; > > to > > font-family: 'Lucida Grande','Lucida Sans Unicode','Lucida > Sans',Tahoma,Verdana,Arial,sans-serif; > > or similar. > +1 To providing other fallbacks.

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Nick Coghlan
On Mon, Mar 26, 2012 at 7:42 AM, Terry Reedy wrote: > Can anyone tell me the best way to do that with FireFox? For general webbrowsing, I'm reasonably impressed by the effectiveness of www.readability.com. It's a sign-up service however, and I've never tried it on technical material like the Pyth

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Steven D'Aprano
Terry Reedy wrote: On 3/25/2012 12:32 PM, Georg Brandl wrote: On 25.03.2012 17:54, Terry Reedy wrote: On 3/25/2012 2:34 AM, Georg Brandl wrote: Here's another try, mainly with default browser font size, more contrast Untrue. You still changed the high contrast dark blue to the same low contr

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Terry Reedy
On 3/25/2012 12:32 PM, Georg Brandl wrote: On 25.03.2012 17:54, Terry Reedy wrote: On 3/25/2012 2:34 AM, Georg Brandl wrote: Here's another try, mainly with default browser font size, more contrast Untrue. You still changed the high contrast dark blue to the same low contrast light blue for b

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Ben Finney
Brian Curtin writes: > On Sun, Mar 25, 2012 at 14:50, Andrew Svetlov > wrote: > > I like to see new schema only for 3.3 as sign of shiny new release. > > Please don't do this. It will result in endless complaints. Complaints of what nature? Do you think those complaints are justified? -- \

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Brian Curtin
On Sun, Mar 25, 2012 at 14:50, Andrew Svetlov wrote: > I like to see new schema only for 3.3 as sign of shiny new release. Please don't do this. It will result in endless complaints. ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.o

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Maciej Fijalkowski
On Sun, Mar 25, 2012 at 9:25 PM, Georg Brandl wrote: > On 25.03.2012 21:11, Steven D'Aprano wrote: >> Georg Brandl wrote: >> >>> Thanks everyone for the overwhelmingly positive feedback.  I've committed >>> the >>> new design to 3.2 and 3.3 for now, and it will be live for the 3.3 docs >>> moment

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Andrew Svetlov
I like to see new schema only for 3.3 as sign of shiny new release. On Sun, Mar 25, 2012 at 10:25 PM, Georg Brandl wrote: > On 25.03.2012 21:11, Steven D'Aprano wrote: >> Georg Brandl wrote: >> >>> Thanks everyone for the overwhelmingly positive feedback.  I've committed >>> the >>> new design t

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Georg Brandl
On 25.03.2012 21:11, Steven D'Aprano wrote: > Georg Brandl wrote: > >> Thanks everyone for the overwhelmingly positive feedback. I've committed the >> new design to 3.2 and 3.3 for now, and it will be live for the 3.3 docs >> momentarily (3.2 isn't rebuilt at the moment until 3.2.3 final goes out

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Georg Brandl
On 25.03.2012 21:09, Matt Joiner wrote: > Not sure if you addressed this in your answers to other comments... > > Scroll down the page. Minimize the nav bar on the left. Bring it back > out again. Now the text in the nav bar permanently starts at an offset > from the top of the page. Yes, that wa

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Steven D'Aprano
Georg Brandl wrote: Thanks everyone for the overwhelmingly positive feedback. I've committed the new design to 3.2 and 3.3 for now, and it will be live for the 3.3 docs momentarily (3.2 isn't rebuilt at the moment until 3.2.3 final goes out). I'll transplant to 2.7 too, probably after the final

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Matt Joiner
Not sure if you addressed this in your answers to other comments... Scroll down the page. Minimize the nav bar on the left. Bring it back out again. Now the text in the nav bar permanently starts at an offset from the top of the page. On Sun, Mar 25, 2012 at 7:44 PM, Matt Joiner wrote: > Is nice

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Georg Brandl
On 25.03.2012 08:34, Georg Brandl wrote: > Here's another try, mainly with default browser font size, more contrast and > collapsible sidebar again: > > http://www.python.org/~gbrandl/build/html2/ > > I've also added a little questionable gimmick to the sidebar (when you > collapse > it and expa

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Georg Brandl
On 25.03.2012 13:09, Stephen J. Turnbull wrote: > On Sun, Mar 25, 2012 at 11:04 AM, Stefan Krah wrote: > >> Do you mean a fixed search box like this one? >> >> http://coq.inria.fr/documentation >> >> Please don't do this, I find scrolling exceptionally distracting in the >> presence of fixed elem

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Georg Brandl
On 25.03.2012 17:54, Terry Reedy wrote: > On 3/25/2012 2:34 AM, Georg Brandl wrote: >> Here's another try, mainly with default browser font size, more contrast > > Untrue. You still changed the high contrast dark blue to the same low > contrast light blue for builtin names, etc. What problem do y

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Georg Brandl
On 25.03.2012 10:06, Peter Otten wrote: > Georg Brandl wrote: > >> Here's another try, mainly with default browser font size, more contrast >> and collapsible sidebar again: >> >> http://www.python.org/~gbrandl/build/html2/ > > Nice! Lightweight and readable. > >>From the bikeshedding departmen

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Georg Brandl
On 25.03.2012 17:26, Ned Batchelder wrote: > On 3/25/2012 2:34 AM, Georg Brandl wrote: >> Here's another try, mainly with default browser font size, more contrast and >> collapsible sidebar again: >> >> http://www.python.org/~gbrandl/build/html2/ > Georg, thanks so much for taking on this thankless

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Georg Brandl
On 25.03.2012 09:19, Ben Finney wrote: > Georg Brandl writes: > >> Here's another try, mainly with default browser font size, more >> contrast and collapsible sidebar again: >> >> http://www.python.org/~gbrandl/build/html2/ > > Great! You've improved it nicely. I especially like that you have >

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Stefan Krah
Stephen J. Turnbull wrote: > Not with just a header. http://turnbull.sk.tsukuba.ac.jp/Teach/IntroSES/ > is a (very primitive and not stylistically improved in years) example > of a frame-based layout that I use some of my classes. I would > put a search field in the top frame (if I had one. :-)

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Terry Reedy
On 3/25/2012 2:34 AM, Georg Brandl wrote: Here's another try, mainly with default browser font size, more contrast Untrue. You still changed the high contrast dark blue to the same low contrast light blue for builtin names, etc. What problem do you think you are trying to solve by making the

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Tim Golden
On 25/03/2012 16:26, Ned Batchelder wrote: Georg, thanks so much for taking on this thankless task with grace and skill. It can't be easy dealing with the death by a thousand tweaks Seconded. I'm constantly edified by the way in which people in the community respond to even quite abrupt critici

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Ned Batchelder
On 3/25/2012 2:34 AM, Georg Brandl wrote: Here's another try, mainly with default browser font size, more contrast and collapsible sidebar again: http://www.python.org/~gbrandl/build/html2/ Georg, thanks so much for taking on this thankless task with grace and skill. It can't be easy dealing w

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Michael Urman
On Sun, Mar 25, 2012 at 07:07, Antoine Pitrou wrote: >> >> I've also added a little questionable gimmick to the sidebar (when you >> collapse >> it and expand it again, the content is shown at your current scroll >> location). > > The gimmick is buggy (when you collapse then expand it in the mid

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Stephen J. Turnbull
On Sun, Mar 25, 2012 at 2:34 PM, Stefan Krah wrote: > Stephen J. Turnbull wrote: >> Does it bother you when the header is fixed and contains >> the search box?  I prefer that arrangement, anyway. > > Do you have an example website? Not with just a header. http://turnbull.sk.tsukuba.ac.jp/Teach

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Stefan Krah
Stephen J. Turnbull wrote: > > Do you mean a fixed search box like this one? > > > > http://coq.inria.fr/documentation > > > > Please don't do this, I find scrolling exceptionally distracting in the > > presence of fixed elements. > > Does it bother you when the header is fixed and contains > the

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Antoine Pitrou
On Sun, 25 Mar 2012 08:34:44 +0200 Georg Brandl wrote: > Here's another try, mainly with default browser font size, more contrast and > collapsible sidebar again: > > http://www.python.org/~gbrandl/build/html2/ > > I've also added a little questionable gimmick to the sidebar (when you > collaps

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Matt Joiner
Is nice yes?! When I small the nav bar, then embiggen it again, the text centers vertically. It's in the wrong place. The new theme is very minimal, perhaps a new color should be chosen. We've done green, what about orange, brown or blue? ___ Python-Dev m

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Oleg Broytman
On Sun, Mar 25, 2012 at 08:34:44AM +0200, Georg Brandl wrote: > http://www.python.org/~gbrandl/build/html2/ Perfect! I like it! Oleg. -- Oleg Broytmanhttp://phdru.name/p...@phdru.name Programmers don't die, they just GOSUB without RETURN. __

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Stephen J. Turnbull
On Sun, Mar 25, 2012 at 11:04 AM, Stefan Krah wrote: > Do you mean a fixed search box like this one? > > http://coq.inria.fr/documentation > > Please don't do this, I find scrolling exceptionally distracting in the > presence of fixed elements. Does it bother you when the header is fixed and con

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Peter Otten
Serhiy Storchaka wrote: >> * Maybe the Next/Previous Page headers on the left could link to the >> respective page. > > Do you mean next/previous links in header/footer? No, I mean the two sections in the sidebar on the left, below "Table of Contents".

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Hynek Schlawack
Hi Georg, Am 25.03.2012 um 08:34 schrieb Georg Brandl: > Here's another try, mainly with default browser font size, more contrast and > collapsible sidebar again: > > http://www.python.org/~gbrandl/build/html2/ I really like it! Only one nitpick: If a header follows on a “seealso”, the vertica

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Andrew Svetlov
On Sun, Mar 25, 2012 at 12:04 PM, Stefan Krah wrote: > Andrew Svetlov wrote: >> I like to always see "Quick search" widget without scrolling page to >> top. Is it possible? > > Do you mean a fixed search box like this one? > > http://coq.inria.fr/documentation > No. You are right, it's distractin

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Stefan Krah
Andrew Svetlov wrote: > I like to always see "Quick search" widget without scrolling page to > top. Is it possible? Do you mean a fixed search box like this one? http://coq.inria.fr/documentation Please don't do this, I find scrolling exceptionally distracting in the presence of fixed elements

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Serhiy Storchaka
25.03.12 09:34, Georg Brandl написав(ла): I've also added a little questionable gimmick to the sidebar (when you collapse it and expand it again, the content is shown at your current scroll location). I'm not sure if this is possible, and how good it would look like, but I have one crazy idea.

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Stephen J. Turnbull
In the header next to "Python v3.3a1 documentation" there is a "»" symbol, which suggests something can be expanded. Knowing that there are many versions of the documentation, I thought it might bring up a menu of versions. But clicking does nothing. Is that intentional? I guess it's supposed t

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Andrew Svetlov
I like to always see "Quick search" widget without scrolling page to top. Is it possible? Or maybe you can embed some keyboard shortcut for quick jump to search input box? On Sun, Mar 25, 2012 at 11:44 AM, Serhiy Storchaka wrote: > 25.03.12 11:06, Peter Otten написав(ла): > >> * Inlined code does

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Serhiy Storchaka
25.03.12 11:06, Peter Otten написав(ла): * Inlined code doesn't need the gray background. The bold font makes it stand out enough. I believe that the gray background is good, but it should make it lighter. * Instead of the box consider italics or another color for [New in ...] text. Yes, th

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Serhiy Storchaka
25.03.12 09:34, Georg Brandl написав(ла): Here's another try, mainly with default browser font size, more contrast and collapsible sidebar again: It may be worth now the line-height reduce too? I've also added a little questionable gimmick to the sidebar (when you collapse it and expand it ag

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Peter Otten
Georg Brandl wrote: > Here's another try, mainly with default browser font size, more contrast > and collapsible sidebar again: > > http://www.python.org/~gbrandl/build/html2/ Nice! Lightweight and readable. >From the bikeshedding department: * Inlined code doesn't need the gray background. Th

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Glenn Linderman
On 3/24/2012 11:34 PM, Georg Brandl wrote: I've also added a little questionable gimmick to the sidebar (when you collapse it and expand it again, the content is shown at your current scroll location). It would be educational to see how you pulled that trick! I will look if I get time. However

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Eli Bendersky
On Sun, Mar 25, 2012 at 08:34, Georg Brandl wrote: > Here's another try, mainly with default browser font size, more contrast and > collapsible sidebar again: > > http://www.python.org/~gbrandl/build/html2/ > > I've also added a little questionable gimmick to the sidebar (when you > collapse > it

Re: [Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-25 Thread Ben Finney
Georg Brandl writes: > Here's another try, mainly with default browser font size, more > contrast and collapsible sidebar again: > > http://www.python.org/~gbrandl/build/html2/ Great! You've improved it nicely. I especially like that you have https://en.wikipedia.org/wiki/Unobtrusive_JavaScript>

[Python-Dev] Playing with a new theme for the docs, iteration 2

2012-03-24 Thread Georg Brandl
Here's another try, mainly with default browser font size, more contrast and collapsible sidebar again: http://www.python.org/~gbrandl/build/html2/ I've also added a little questionable gimmick to the sidebar (when you collapse it and expand it again, the content is shown at your current scroll l