[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: rekado
Subject: Re: [PATCH] gendocs.sh: default to a common CSS style sheet for HTML output
Date: Fri, 12 Dec 2014 14:15:29 +0100

Ludovic Courtès writes:
> Perhaps also this:
>   p { text-align: justify; }
> But then it looks like spacing around paragraphs would need to be
> slightly increased, WDYT?

In my experience, paragraph justification often looks terrible in many
cases (especially when unbreakable phrases like <code> sections are
embedded in the paragraph) unless hyphenation is enabled.  Mozilla
browsers (and possibly others) can do hyphenation, but it's done with a
proprietary CSS property that is not necessarily supported by any other
browser, which is why I didn't add them:

    p {
      -moz-hyphens: auto;
      text-align: justify;

That said, justified paragraphs with hyphenation do look rather nice.

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

Placing the bullets (as well as numbers in numbered lists) in the margin
ensures that the flow of text on the left hand side is uninterrupted,
making list items more legible.

It is possible that the effects of my stylesheet are a little different
in different browsers due to different defaults.  I might add some reset
rules to override browser defaults and to achieve similar appearance in
most browsers.

(I should add that I'm not trying to push this stylesheet through as is.
I just think that the few relatively uncontroversial changes it contains
result in much more legible manuals, something we almost take for
granted in printend or TeX-processed documents.  I think it would be a
benefit if the generated defaults for HTML would also result in
comparably legible text.)

-- rekado

reply via email to

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