Re: [RFC/PATCH 2/8] docbook: improve css style

From: Jeff King <peff@peff.net>
Date: Mar 24, 2009, 09:16 UTC
Message-ID: <20090324091600.GA2484@coredump.intra.peff.net>
In-Reply-To: <94a0d4530903240206k6eecdabg2cbb2c5595cd4bc@mail.gmail.com>

On Tue, Mar 24, 2009 at 11:06:50AM +0200, Felipe Contreras wrote:

> Take a look at:
> http://people.freedesktop.org/~felipec/git/user-manual.html#bisect-merges
> 
> Do you think slanting Z (and the other characters) is enough to emphasize it?

I think it looks better with color to emphasize that it is different, just as the <code> blocks get monospaced _and_ colored.

However, I think this is a matter of poor semantic markup in the first place. Italics on a word for emphasis in text is very different from what is happening here, which is essentially typesetting math variables. I would say that `Z` is probably a better match, though I prefer the LaTeX-style "math mode" italics for this sort of thing. I think asciidoc supports some math markup, but I haven't lookd at it.

So basically, I think these variables look fine slanted and green. But I think an emphasized word in the text should not be green.

-Peff