GNU bug report logs - #54592
Render document title using <h1> in HTML engine

Previous Next

To reply to this bug, email your comments to 54592 AT debbugs.gnu.org.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Arun Isaac <arunisaac <at> systemreboot.net>
To: skribilo-bugs <at> nongnu.org
Subject: Render document title using <h1> in HTML engine
Date: Sun, 27 Mar 2022 14:10:00 +0530

The skribilo HTML engine renders the document title using a table as
follows:

--8<---------------cut here---------------start------------->8---
<table class="skribilo-title" width="100%" cellspacing="0"
cellpadding="0">
<tbody>
  <tr>
    <td align="center"><div class="skribilo-title">TITLE GOES HERE</div>
  </td></tr>
</tbody>
</table>
--8<---------------cut here---------------end--------------->8---

Not only is this very convoluted, it means that the document title is
much smaller than the section titles which are in h2. This
representation using a table goes back to a bygone era before CSS. We
should simply use a <h1> and allow the user to customize the CSS as they
please. Something like:

--8<---------------cut here---------------start------------->8---
<h1 class="skribilo-title">TITLE GOES HERE</h1>
--8<---------------cut here---------------end--------------->8---

This change has the downside is that it’ll “break someone’s workflow” as
xkcd puts it, but unfortunately, we need to move forward.

Message #8 received at 54592 <at> debbugs.gnu.org (full text, mbox):

From: Ludovic Courtès <ludo <at> gnu.org>
To: Arun Isaac <arunisaac <at> systemreboot.net>
Cc: 54592 <at> debbugs.gnu.org
Subject: Re: bug#54592: Render document title using <h1> in HTML engine
Date: Sun, 10 Apr 2022 21:59:24 +0200

Hi,

Arun Isaac <arunisaac <at> systemreboot.net> skribis:

> <h1 class="skribilo-title">TITLE GOES HERE</h1>
>
> This change has the downside is that it’ll “break someone’s workflow” as
> xkcd puts it, but unfortunately, we need to move forward.

I every much agree with such a change, ideally together with a default CSS.

Ludo’.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.