From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailout-webserver.scc.kit.edu (mailout-webmail.scc.kit.edu [129.13.185.232]) by krisdoz.my.domain (8.14.5/8.14.5) with ESMTP id s7AFIE7M016453 for ; Sun, 10 Aug 2014 11:18:14 -0400 (EDT) Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82]) by scc-mailout-02.scc.kit.edu with esmtp (Exim 4.72 #1) id 1XGUsu-0008AV-Jq; Sun, 10 Aug 2014 17:18:12 +0200 Received: from donnerwolke.usta.de ([172.24.96.3]) by hekate.usta.de with esmtp (Exim 4.77) (envelope-from ) id 1XGUsu-0000gz-I4; Sun, 10 Aug 2014 17:18:12 +0200 Received: from iris.usta.de ([172.24.96.5] helo=usta.de) by donnerwolke.usta.de with esmtp (Exim 4.72) (envelope-from ) id 1XGUst-0003aF-Uu; Sun, 10 Aug 2014 17:18:12 +0200 Received: from schwarze by usta.de with local (Exim 4.77) (envelope-from ) id 1XGUs9-0004dl-Ca; Sun, 10 Aug 2014 17:17:25 +0200 Date: Sun, 10 Aug 2014 17:17:25 +0200 From: Ingo Schwarze To: "Anthony J. Bentley" Cc: discuss@mdocml.bsd.lv Subject: Re: HTML5 Message-ID: <20140810151725.GC325@iris.usta.de> References: <53E6AFDD.8010001@bsd.lv> <8860.1407645228@cathet.us> X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <8860.1407645228@cathet.us> User-Agent: Mutt/1.5.21 (2010-09-15) 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