From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-0.0 required=5.0 tests=T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 22793 invoked from network); 5 Jul 2022 18:45:13 -0000 Received: from bsd.lv (HELO mandoc.bsd.lv) (66.111.2.12) by inbox.vuxu.org with ESMTPUTF8; 5 Jul 2022 18:45:13 -0000 Received: from fantadrom.bsd.lv (localhost [127.0.0.1]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id d7dd94b3 for ; Tue, 5 Jul 2022 13:45:11 -0500 (EST) Received: from scc-mailout-kit-02.scc.kit.edu (scc-mailout-kit-02.scc.kit.edu [129.13.231.82]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 73a60bec for ; Tue, 5 Jul 2022 13:45:10 -0500 (EST) Received: from hekate.asta.kit.edu ([2a00:1398:5:f401::77]) by scc-mailout-kit-02.scc.kit.edu with esmtps (TLS1.3:ECDHE_SECP256R1__RSA_PSS_RSAE_SHA256__AES_256_GCM:256) (envelope-from ) id 1o8nXo-00Ebfj-NG; Tue, 05 Jul 2022 20:45:09 +0200 Received: from login-1.asta.kit.edu ([2a00:1398:5:f400::72]) by hekate.asta.kit.edu with esmtp (Exim 4.94.2) (envelope-from ) id 1o8nXm-006KCh-KC; Tue, 05 Jul 2022 20:45:07 +0200 Received: from schwarze by login-1.asta.kit.edu with local (Exim 4.92) (envelope-from ) id 1o8nXn-0002Kj-0M; Tue, 05 Jul 2022 20:45:07 +0200 Date: Tue, 5 Jul 2022 20:45:06 +0200 From: Ingo Schwarze To: Anna Cc: tech@mandoc.bsd.lv Subject: Re: [PATCH 1/3] Wrap manual header in the "

" tag Message-ID: References: <20220628181844.15484-1-cyber@sysrq.in> <20220628181844.15484-2-cyber@sysrq.in>

X-Mailinglist: mandoc-tech Reply-To: tech@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: Hi Anna, Anna wrote on Tue, Jul 05, 2022 at 09:15:48PM +0500: > Whatever works Not really... :-( I have seen that attitude result in terrible markup too often, and not only in HTML/CSS, but also in other markup languages like mdoc(7), man(7), roff(7), even LaTeX... So i would really like to select markup that makes sense semantically and is also generally considered as decent style. > (but then we need to keep class="head" for styles). Not necessarily. CSS can also select by other attributes. For example, mandoc.css already contains input[name=expr] { width: 25%; } Maybe we could do something like: table[role=doc-pageheader] { ... } Then again, maybe nothing much is wrong with keeping the class for backward compatibility, at least for some time. > While we're at this, can we use something other than tables for > pageheader/pagefooter layout? > https://git.sr.ht/~devinprater/fossability/tree/master/item/user%20interface%20and%20experience/web.md#html Yes, i'm aware of that, and i have been wanting to move away from this abuse of for several years but never came round to it. There is also this very old entry in the TODO file: - The tables used to render the three-part page headers actually force the width of the to the max-width given for . Not yet sure how to fix that... Observed by an Anonymous Coward on undeadly.org: http://undeadly.org/cgi?action=article&sid=20140925064244&pid=1 loc * exist * algo ** size * imp *** That might possibly fix itself once we move away from

. In the context of your patches, i deliberately avoided bringing that up because i didn't want to cause a distraction from your work. Then again, since you bring it up, maybe we should fix this first. With a bit of luck, it might make assigning the proper ARIA role easier, too. So, which HTML element *should* we use instead of

would make sense from the semantic perspective but we already found out we cannot assign the doc-pageheader role to it.

seems clearly inappropriate. That leaves me more or less with

, but that is very weak semantically... And then the second question is how to style it. Do you think flexbox is the right CSS tool, or is there something that might fit better? Right now, the best i can come up with is

/* or without this if the validator complains again */

CHMOD(1) General Commands Manual CHMOD(1)

div[role=doc-pageheader] { display: flex; justify-content: space-between; border-bottom: 1px dotted #808080; margin-bottom: 1em; font-size: smaller; } Not tested yet! Do you have a better idea, or should i develop a patch for that, test it, and commit it if it works? Yours, Ingo -- To unsubscribe send an email to tech+unsubscribe@mandoc.bsd.lv