Stylesheet for <example>

Tammy Fox tfox at redhat.com
Fri Sep 17 16:20:35 UTC 2004


On Fri, 2004-09-17 at 11:39, Paul W. Frields wrote:
> I would like to see <example> sections take on a different rendered
> style, somewhat like the <screen> sections. I think the right way to do
> this is with an outlined box, but without changing the shade (BG color).
> That should keep an <example> distinct from a <screen>.
> 
> I hope this doesn't sound trivial in the face of other work; I was
> actually doing substantial FDP work when the subject came up. As I was
> showing my wife a section of text I had written, which included several
> <example>s, she commented that the HTML rendering was confusing because
> the <example> content itself does not significantly differ from the
> surrounding <para> content. On top of that, the caption appears below
> the content.
> 
> We agreed that the caption is nice to have under the content for a
> professional appearance, but only if the example is in some way
> separated from the rest of the text. I thought introducing yet another
> color of shading was excessive. We already have blue for admonitions and
> gray for <screen>. Red sets the <section> headers apart. I think simply
> outlining the area and increasing the margin slightly would do the
> trick.
> 
> I will Bugzilla a RFE for this change to css/fedora.css shortly, but I
> thought I would solicit a few comments before I commit the bug.
> 
> -- 
> Paul W. Frields, RHCE
> 

I like the idea. I noticed this as well when I was reading a document
with examples but didn't want to add yet another color. Seems like just
adding a box around it would set it apart enough to make it easier to
read. File the RFE, and I'd be glad to add it to the CSS.

Tammy





More information about the fedora-docs-list mailing list