Re: [Tools-discuss] mangled ToC in RFC 8784

Henrik Levkowetz <henrik@levkowetz.com> Wed, 28 October 2020 18:48 UTC

Return-Path: <henrik@levkowetz.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B58523A0AE7 for <tools-discuss@ietfa.amsl.com>; Wed, 28 Oct 2020 11:48:36 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.146
X-Spam-Level:
X-Spam-Status: No, score=-2.146 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, NICE_REPLY_A=-0.247, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id sp5fPJP6POhE for <tools-discuss@ietfa.amsl.com>; Wed, 28 Oct 2020 11:48:35 -0700 (PDT)
Received: from zinfandel.tools.ietf.org (zinfandel.tools.ietf.org [64.170.98.42]) (using TLSv1.2 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id CD3873A0B02 for <tools-discuss@ietf.org>; Wed, 28 Oct 2020 11:48:16 -0700 (PDT)
Received: from h-202-242.a357.priv.bahnhof.se ([158.174.202.242]:64295 helo=tannat.localdomain) by zinfandel.tools.ietf.org with esmtpsa (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.80) (envelope-from <henrik@levkowetz.com>) id 1kXqUV-0000ig-V3; Wed, 28 Oct 2020 11:48:12 -0700
To: Paul Wouters <paul@nohats.ca>, tools-discuss@ietf.org
References: <alpine.LRH.2.23.451.2010281420240.2537787@bofh.nohats.ca>
From: Henrik Levkowetz <henrik@levkowetz.com>
Message-ID: <438c0bc7-ceed-c77b-4846-75f26e477ae9@levkowetz.com>
Date: Wed, 28 Oct 2020 19:48:04 +0100
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.11; rv:45.0) Gecko/20100101 Thunderbird/45.8.0
MIME-Version: 1.0
In-Reply-To: <alpine.LRH.2.23.451.2010281420240.2537787@bofh.nohats.ca>
Content-Type: multipart/signed; micalg="pgp-sha256"; protocol="application/pgp-signature"; boundary="TssLNt4vjFsgkRBVncnv0lpV4QGIvImxM"
X-SA-Exim-Connect-IP: 158.174.202.242
X-SA-Exim-Rcpt-To: tools-discuss@ietf.org, paul@nohats.ca
X-SA-Exim-Mail-From: henrik@levkowetz.com
X-SA-Exim-Version: 4.2.1 (built Mon, 26 Dec 2011 16:24:06 +0000)
X-SA-Exim-Scanned: Yes (on zinfandel.tools.ietf.org)
X-Clacks-Overhead: GNU Terry Pratchett
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/10VIU1W6TJFr3pDoelyQ2vIUJ2I>
Subject: Re: [Tools-discuss] mangled ToC in RFC 8784
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 28 Oct 2020 18:48:37 -0000

Hi Paul,

On 2020-10-28 19:21, Paul Wouters wrote:
> 
> Hi,
> 
> https://tools.ietf.org/html/rfc8784
> 
> This RFC seems to have a mangled ToC that cannot be clicked at.
> 
> Is that something that can be fixed?

Probably yes.  The biggest stumbling block is that with the current
un-paginated RFC text format, there is nothing or not much to distinguish
ToC lines from start-of-section lines later in the document, which is
an issue for the regex-based (~ stateless) htmlization script.

The line of spaced dots between section name and page number in earlier
ToCs were used to identify ToC entries.

I think I can figure out a way to deal with this, but it will require some
coding, testing, and a new release of my htmlization lib.


Best regards,

	Henrik