Re: HTML5

[Ingo Schwarze <schwarze@usta.de>]

Hi,

please take all i say in this thread with a grain of salt,
i'm not specialized in this area and may be wrong.
Hope you will figure it out and correct me.

Anthony J. Bentley wrote on Sat, Aug 09, 2014 at 10:33:48PM -0600:
> Kristaps Dzonsons writes:

>> 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.

Why not?  What downside do you see?

> And if we do that, is there any point to switching doctypes?

Yes, one minor and one major.

The minor is less doctype/content-type clutter.
The major is to get MathML for eqn.

That also explains why i think validating against both 5 and 4.01
(for non-eqn content) does have some merit.  Again, if that is
possible, but as far as i understand, it is.

>> 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.

That makes sense to me; i guess the only exception is cases where
CSS is the only way to make stuff render at all, like for the
header and footer tables, as mentioned by Kristaps.

> 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...

That's fine with me.  I don't worry about style changes to the OpenBSD
online man pages.  The style used should be friendly on the eye and
make the semantic markup stand out well, at least as well as for
terminal output, that's all that matters from my perspective.

Yours,
  Ingo
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv