Bernard D. Tremblay (Ben) wrote:
>>[DocBook examples]
> Will no document be viewable publically on zope until/unless it has
> reached that degree of correctness?

That would be asking for the impossible, because HTML does not have
that level of markup. DocBook's richness can be emulated with the class
attribute, but I certainly don't want to require anything like that.
All I ask for is a good attempt at HTML 4.01 Strict with no
presentational elements like <b> or <i>. With the aid of a validator,
HTML 4.01 Strict is pretty easy to write.

If the author sees the need for something more than what HTML's
elements offer, s/he can use classified elements, such as the <p
class="note"> or <p class="remark"> I pointed out to Alex, instead of
presentational elements. (The class name should explain the meaning of
the presentational effect.)

Common constructs can be added to the site's pre-defined set. For
example, authors' remarks are a common construct. 'remark' has been
defined for them in the Markup Guide [1], and the site stylesheets
assign a color change and brackets to that class. An author who wants
to make an aside stand out from the main text [2] can just use
'class="remark"'. There's no need for the author to code CSS rules or
use tags like <font> and <i>; the site CSS already handles the remark's
styling and incorporates it into the site-wide theme.

> I can see DocBook on the horizon, but when does this sort of markup
> begin?

When we have a setup that makes it easy, I assume. :)

~fantasai

[1] http://moz.zope.org/contribute/writing/markup
[2] For examples, see
    http://www.mozilla.org/newlayout/doc/block-and-line.html


__________________________________________________
Do You Yahoo!?
Yahoo! Health - Feel better, live better
http://health.yahoo.com

Reply via email to