[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Contributions to Guile

From: Ricardo Wurmus
Subject: Re: Contributions to Guile
Date: Mon, 08 Feb 2016 20:22:22 +0100
User-agent: mu4e 0.9.13; emacs 24.5.1

Christopher Allan Webber <address@hidden> writes:

>>> If the html export was nicely themed
>> It can be nicely themed.  FWIW, Gnulib’s, which is what most
>> projects use to export their HTML to, now includes a CSS by
>> default (see <> as an example.)  We can
>> change this CSS anytime, and in fact, I would love it if someone
>> talented would come up with improvements!
> Ok, yeah
> does look a lot nicer!  I think it could look nicer still; eg, Racket's
> docs using Scribble and anything using Sphinx tends to seem more nicely
> themed:
> I think maybe the left-hand bar kind of helps, and some tweaks to the
> coloring might help too.

I would like to note that a while ago I prepared a *very simple* style
sheet for GNU manuals to make it easier for me to read them online:

This works with the “stylish” extension, which is available here:

I’m not claiming that this is beautiful, but it fixes a couple of things
that I found most annoying about the defaults.  The most obvious changes

  * limited maximum line width
  * list bullets in the frame
  * scaling (the font size changes as the window is resized, but the
    line width stays the same)
  * different colour for navigation header

I kept the changes to a minimum because I hoped they would be
uncontroversial enough to be accepted as an incremental improvement over
the defaults.

Some of the HTML produced by Texinfo isn’t annotated very well, so it’s
hard to find a generic style that works for every manual out there.

I think that is really pretty and with a
little more tweaking the online manuals could look similarly attractive.

~~ Ricardo

reply via email to

[Prev in Thread] Current Thread [Next in Thread]