Re: HTML5

["Anthony J. Bentley" <anthony@cathet.us>]

Kristaps Dzonsons writes:
> Hi,
> 
> Most everybody supports HTML5 these days.  Do we really need to knock 
> around with XHTML and HTML-4.01?  Does anybody have a pressing need to 
> use one or the other?

I actively use HTML 4.01. I don't have a real objection against emitting
a HTML5 doctype, but I do think that it's a good idea for HTML output of
mandoc to validate against both HTML 4.01 and HTML5. And if we do that,
is there any point to switching doctypes?

> The enclosed ten-minute patch adds HTML5 support and makes it the 
> default for both modes.  It also adds a default CSS style (if one isn't 
> passed on the command line) identical to OpenBSD's man.cgi CSS.  I don't 
> like this--I think online manpages should take more advantage of 
> online-ness--but I'm just putting up the bikeshed so it's ready to 
> paint.

IMO, the status quo makes more sense here. We already separate content
and presentation by only making use of external stylesheets. Since the
output of mandoc -Thtml is something people are likely to try to parse,
we shouldn't emit CSS in the default case. If people do ask for CSS,
emitting a link tag instead of embedding it is the right thing to do.

I did talk to Ingo recently about man.cgi stylesheets. The stylesheet
visible on mdocml.bsd.lv is a lot more representative of mandoc's
abilities and I would like to push to remove the pseudo-man.cgi style
completely...

-- 
Anthony J. Bentley
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv