bug-gnulib
[Top][All Lists]
Advanced

[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 21:27:08 +0100
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4 (gnu/linux)

rekado <address@hidden> skribis:

> 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;
>     }

OK.  Would it be possible to make the above CSS rule conditional on
having a Mozilla-compatible browser, and just leave text unjustified in
other cases?

Otherwise leaving text always unjustified is fine.

>> 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.

Fair enough.

> (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.)

OK, I’d be in favor of pushing this first version to gnu.org (it’s
already a big improvement) so we can move forward, and then we can
always iterate.

Karl: WDYT?

Thanks,
Ludo’.



reply via email to

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