From: Jeff King <peff@peff.net>
Date: Tue, 24 Mar 2009 09:16:00 GMT
Subject: Re: [RFC/PATCH 2/8] docbook: improve css style
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