[Top][All Lists]

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

Re: [PATCH] gendocs.sh: default to a common CSS style sheet for HTML out

From: Ludovic Courtès
Subject: Re: [PATCH] gendocs.sh: default to a common CSS style sheet for HTML output
Date: Fri, 12 Dec 2014 10:16:22 +0100
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4 (gnu/linux)

rekado <address@hidden> skribis:

>>> It assumes that <http://gnu.org/s/emacs/manual.css> would be copied to
>>> <http://gnu.org/manual/manual.css> as a starting point.
>> Seems like a good idea to me.
>> Projects can override this if they want.
>> We can merge this after the global css is in place.
> FWIW, I created a simple style sheet with what I think are rather
> conservative improvements over the defaults:
> - limit lines to a more readable length (34rem)
> - add whitespace (e.g. spacing between paragraphs and between headings)
> - shaded background for examples and TOC
> - adjust font sizes dependent on available window width
> - hanging bullets in lists
> This is certainly not perfect and hasn't been tested with many manuals,
> but at the very least the Gzip manual[1] becomes more readable, in my
> opinion, with this style applied.
> The stylesheet is available here:
>     https://userstyles.org/styles/108215/gnu-manuals

(Note that the actual CSS is at
<http://userstyles.org/styles/108215/gnu-manuals.css>, but the
address@hidden had to be removed in my case so I could try it

I tried it with the Guix manual and it looks nice to me!

I would add this, to make @code, @file, etc. use a fixed-width font:

  samp, code {
      font-family: Courier, monospace;

Perhaps also this:

  p { text-align: justify; }

But then it looks like spacing around paragraphs would need to be
slightly increased, WDYT?

Bullet lists also slightly protrude in the margin; perhaps that should
be fixed?

Thanks for your help!


reply via email to

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