cvs commit: www/en/docproj current.sgml

[Giorgos Keramidas]

On 2004-12-06 11:50, Ceri Davies <ceri at submonkey.net> wrote:
> On Sat, Dec 04, 2004 at 11:04:08PM +0000, Murray Stokely wrote:
> > murray      2004-12-04 23:04:08 UTC
> >
> >   FreeBSD doc repository
> >
> >   Modified files:
> >     en/docproj           current.sgml
> >   Log:
> >   Use CSS for headings instead of <font> tags.
>
> > | @@ -65,7 +65,7 @@
> > |      the open documentation problem reports.</p>
> > |
> > |      <a name="handbook3"></a>
> > | -    <h3><font color="#660000">FreeBSD Handbook 3rd Edition</font></h3>
> > | +    <h3 class="red">FreeBSD Handbook 3rd Edition</h3>
>
> Hmm.  Does that actually buy us anything in the way of maintainability?

Yes, CSS can buy us a lot in maintainability and consistency.  We just
have to be a bit careful when we use it.  For instance, in this change
the "red" class name should probably go away.  Removing the class and
making all <h3> elements have a standard style with:

	h3 {
		color: maroon;
	}

works too.  It also lets us easily change the default appearance of H3
elements to a more blog-like style later on, without having to remember
what `red' means:

	h3 {
		color: #666;
		margin: 0;
		padding: 2em 0 2px 0;
		border: 0;
		border-bottom: 1px dashed #369;
	}

I am very much in support of using CSS as much as possible for the style
of the pages, if it matters at all.

- Giorgos