GNOME Bugzilla – Bug 663487
CSS for API docs too "sparse," visually
Last modified: 2014-01-26 22:19:03 UTC
I was looking at the PyGTK docs available at http://developer.gnome.org/pygtk/stable/ and found the default CSS to be far too "sparse," so to speak. There was an awful lot of whitespace both vertically and horizontally which made it difficult to "take in" the documentation as easily as if it were just bare HTML. Specifically I found that the margins were far too large, that the double "<br><br>" inbetween the top function definitions created too much space, and the argument descriptions in each function likewise took up far too much vertical space. I ended up cobbling together a Stylish style to use for developer.gnome.org which makes things look much better for me, but IMO the default style should be more dense as well. FWIW, the Style I'm using now: @namespace url(http://www.w3.org/1999/xhtml); @-moz-document domain("developer.gnome.org") { .body { width: 100% !important; } .content { width: 95% !important; } dl dt, table tbody tr td p { margin-bottom: 0px !important; margin-top: 0px !important; } br { line-height: .2em; height: .2em; } } And also FWIW, after having put that together I noticed that the docs available at pygtk.org for the same content were much closer to how I'd ideally like docs to be presented. For instance, http://www.pygtk.org/pygtk2reference/class-gtkwindow.html versus http://developer.gnome.org/pygtk/stable/class-gtkwindow.html (And of course this kind of thing boils down to personal preference, but I figured putting in a bug might not hurt.)
The double <br> issue is bug 644666 (I thought I had commented in there), basically the single <br> gets duplicated somewhere in the chain doing the conversion from the initial HTML to developer.gnome.org HTML. Could you provide before/after screenshots for the other changes you have?
The <br> issue remains in bug 644666; for the other I just applied some reduced margins. commit 1df7f4a059f9dd1a8bdee07e3e726cfa7b4e35e5 Author: Frédéric Péters <fpeters@0d.be> Date: Sun Jan 26 22:15:45 2014 +0000 remove some spaces in argument tables https://bugzilla.gnome.org/show_bug.cgi?id=663487