After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 663487 - CSS for API docs too "sparse," visually
CSS for API docs too "sparse," visually
Status: RESOLVED FIXED
Product: website
Classification: Infrastructure
Component: developer.gnome.org
current
Other Linux
: Normal trivial
: ---
Assigned To: GNOME Web maintainers
GNOME Web maintainers
Depends on:
Blocks:
 
 
Reported: 2011-11-06 03:53 UTC by CJ Kucera
Modified: 2014-01-26 22:19 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description CJ Kucera 2011-11-06 03:53:08 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.)
Comment 1 Frederic Peters 2011-11-07 07:58:26 UTC
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?
Comment 2 Frederic Peters 2014-01-26 22:19:03 UTC
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