[issue10716] Modernize pydoc to use CSS

Ezio Melotti added the comment: I added a few comments for ccs_v3.diff on rietveld. -- ___ Python tracker ___ ___ Python-bugs-list ma

[issue10716] Modernize pydoc to use CSS

Ron Adam added the comment: A reminder: Check for instances where html.escape is not called on data inserted into the html pages. I'll update the patch as the non-css (error handling) parts made it into python 3.2. :-) -- ___ Python tracker

[issue10716] Modernize pydoc to use CSS

Ron Adam added the comment: To go forward I can create a new private api instead of changing HTMLDoc, that would be preferable. Should the -w option also use the new html pages? Or do we need a new option for that? -- ___ Python tracker

[issue10716] Modernize pydoc to use CSS

Georg Brandl added the comment: These arguments should not really be of concern. If we indeed deem them public API, they can stay but be ignored. -- ___ Python tracker ___ ___

[issue10716] Modernize pydoc to use CSS

Ron Adam added the comment: > If the colors are passed directly to the HTML they should be > removed >and left to the CSS(s) only. I don't know the code > well enough to say if this is doable and/or if it requires a > deprecation first; We may have to do dome depreciating when it comes to the o

[issue10716] Modernize pydoc to use CSS

Ezio Melotti added the comment: A few comments about css_v2.diff: 1) when the value is '0', there's no need to specify the unit (e.g. 0em); 2) when the color is specified the background-color should be specified as well (and vice versa); 3) hex colors (e.g. #00FF00) should be preferred to named

[issue10716] Modernize pydoc to use CSS

Changes by Ron Adam : Removed file: http://bugs.python.org/file20183/css_v1.diff ___ Python tracker ___ ___ Python-bugs-list mailing list Unsu

[issue10716] Modernize pydoc to use CSS

Changes by Ron Adam : Removed file: http://bugs.python.org/file20088/pydoc sample html files.zip ___ Python tracker ___ ___ Python-bugs-list m

[issue10716] Modernize pydoc to use CSS

Changes by Ron Adam : Removed file: http://bugs.python.org/file20081/defaultstyle.css ___ Python tracker ___ ___ Python-bugs-list mailing list

[issue10716] Modernize pydoc to use CSS

Ron Adam added the comment: Here is a new diff which updates all the new pydoc pages to use the css file. The css file is simpler and cleaner. I also made a few adjustments to the url handler error handling, and changed the titles in the head sections so they say "Pydoc" instead of "Python"

[issue10716] Modernize pydoc to use CSS

Ron Adam added the comment: It may be useful to change those to 'id=' and 'class=' if possible. It isn't clear to me how much of pydoc is still part of the public api in python 3.x. pydoc.__all__ is set only to ['help']. Entering help(pydoc) just gives the basic help and command line argum

[issue10716] Modernize pydoc to use CSS

Georg Brandl added the comment: Well, you could reuse these arguments to mean CSS classes, and have styles like ".red { color: red }" :) -- nosy: +georg.brandl ___ Python tracker _

[issue10716] Modernize pydoc to use CSS

Ron Adam added the comment: The HtmlDoc class has methods that take colors. Can this be changed or does it need to be depreciated first? def heading(self, title, fgcol, bgcol, extras=''): """Format a page heading.""" return '''    %s%s ''' % (bgcol, fgcol, title, fgc

[issue10716] Modernize pydoc to use CSS

Ron Adam added the comment: Here is a tentative start on this. (css_v1.diff) The css file is much better. It's shorter, simpler and validated. The header and navbar panel use it in the new server. Added a markup call to the topic page contents. (The same markup call is already used for th

[issue10716] Modernize pydoc to use CSS

Raymond Hettinger added the comment: There's no rush on this one. There desired properties are: * separate content from presentation * validated CSS and HTML * simple CSS so that people can *easily* customize it * possibly offer two premade stylesheets 1) a default beautiful one 2) one the c

[issue10716] Modernize pydoc to use CSS

Éric Araujo added the comment: [Raymond] > I'm looking for a deeper fix, all the in-line styling replaced by a > stylesheet. Can you guys work together on bring this to fruition? When I talked about the CSS reset, I was referring to a precise part of the file proposed by Ron, so we’re already

[issue10716] Modernize pydoc to use CSS

Ezio Melotti added the comment: The CSS also has a validation error, some warnings and could be written better IMHO (specifically I don't like the placement of the {}). I also don't believe that extensive CSS resets are useful -- they usually just lead to lot of redefining. I usually limit my

[issue10716] Modernize pydoc to use CSS

Ron Adam added the comment: Ok, I just looked at them again, I didn't remember how different it was. They probably won't be much help other than maybe seeing how some things could be done. Here's a zip file of some saved pages, so you can take a look. -- Added file: http://bugs.pytho

[issue10716] Modernize pydoc to use CSS

Raymond Hettinger added the comment: The uploaded stylestyle is *much* bigger than I expected. There should be no more than a one-to-one correspondence. With inheritance, perhaps even fewer entries. -- ___ Python tracker

[issue10716] Modernize pydoc to use CSS

Ron Adam added the comment: I think that's how I ended up with the style sheet I uploaded. It works, but it can be a slow process. Another factor is the pydoc server will reread an external style sheet on browser refreshes. So you can see the results of style sheet changes without restartin

[issue10716] Modernize pydoc to use CSS

Raymond Hettinger added the comment: A good procedure is to start afresh with an empty, embedded style sheet and replace the html styling attributes one at a time, while keeping the overall look and feel the same. At the end of the process the embedded style sheet can be converted to extern

[issue10716] Modernize pydoc to use CSS

Ron Adam added the comment: Eric, most of what's in that file is what I figured out by trial and error in order to get it to work on the different browsers at that time. (about 3 years ago.) You are probably more experienced with css than I am, so you are more than welcome to update and chan

[issue10716] Modernize pydoc to use CSS

Raymond Hettinger added the comment: I'm looking for a deeper fix, all the in-line styling replaced by a stylesheet. Can you guys work together on bring this to fruition? -- ___ Python tracker __

[issue10716] Modernize pydoc to use CSS

Éric Araujo added the comment: Those two scripts are just three-liners pydoc launchers. I disagree about the CSS reset. Default values and user-set values have a reason for being there, and I share the viewpoint that they should not be reset. -- _

[issue10716] Modernize pydoc to use CSS

Ron Adam added the comment: I uploaded the css file I used in an experimental version of pydoc. It may give some useful starting values. Before this is done, the old server code should be removed (also for 3.3). (another issue?) There are two files in the tools/scripts directory that may

[issue10716] Modernize pydoc to use CSS

Changes by Éric Araujo : -- nosy: +eric.araujo ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.pyth

[issue10716] Modernize pydoc to use CSS

Alexander Belopolsky added the comment: See also the calendar module for an example of a "modern" html. -- ___ Python tracker ___ ___

[issue10716] Modernize pydoc to use CSS

Alexander Belopolsky added the comment: I believe Ron has done something along these lines already. See issue2001. Committed css file is empty, (see r86971) but I am adding Ron to "nosy" in case he has something in the pipeline. -- nosy: +belopolsky, ron_adam __

[issue10716] Modernize pydoc to use CSS

Changes by Łukasz Langa : -- assignee: -> lukasz.langa nosy: +lukasz.langa ___ Python tracker ___ ___ Python-bugs-list mailing list U

[issue10716] Modernize pydoc to use CSS

New submission from Raymond Hettinger : This is a straight-forward project. Pydoc currently generated 1990's style html which mixes content and presentation, making it very difficult for users to customize the appearance of the output. It is full of html like:    %s%s ''' % (bgcol, fgc