Re: [Rfc-markdown] RfcMarkup ToC has no links

Henrik Levkowetz <henrik@levkowetz.com> Mon, 01 June 2020 12:00 UTC

Return-Path: <henrik@levkowetz.com>
X-Original-To: rfc-markdown@ietfa.amsl.com
Delivered-To: rfc-markdown@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id D5CEF3A0FC4; Mon, 1 Jun 2020 05:00:30 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, 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 kH3s0izx3zw6; Mon, 1 Jun 2020 05:00:29 -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 5E5D83A0FC3; Mon, 1 Jun 2020 05:00:29 -0700 (PDT)
Received: from h-202-242.a357.priv.bahnhof.se ([158.174.202.242]:51620 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 1jfj7E-0001za-Mz; Mon, 01 Jun 2020 05:00:29 -0700
To: Anders Rundgren <anders.rundgren.net@gmail.com>, xml2rfc@ietf.org
References: <E1iNIwd-0006wR-VI@durif.tools.ietf.org> <abda3104-191c-8ca3-c254-64ed55ccd9dd@gmail.com>
Cc: rfc-markdown@ietf.org
From: Henrik Levkowetz <henrik@levkowetz.com>
Message-ID: <481b0289-f3d0-f10a-32d6-1b6f6f84a6f2@levkowetz.com>
Date: Mon, 1 Jun 2020 14:00:21 +0200
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: <abda3104-191c-8ca3-c254-64ed55ccd9dd@gmail.com>
Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="hFtQ6jdBnMjDXmSVJVOjOgojmHDECv7ob"
X-SA-Exim-Connect-IP: 158.174.202.242
X-SA-Exim-Rcpt-To: rfc-markdown@ietf.org, xml2rfc@ietf.org, anders.rundgren.net@gmail.com
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/rfc-markdown/mzZMRNwjZtDv6SrwRQVCCtbKsWk>
Subject: Re: [Rfc-markdown] RfcMarkup ToC has no links
X-BeenThere: rfc-markdown@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "rfc-markdown is a discussion list for people writing I-Ds and RFCs in Markdown and the authors of the tools used for that." <rfc-markdown.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-markdown/>
List-Post: <mailto:rfc-markdown@ietf.org>
List-Help: <mailto:rfc-markdown-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 01 Jun 2020 12:00:31 -0000

Hi Anders,

On 2020-05-30 04:43, Anders Rundgren wrote:
> sample RFC: https://tools.ietf.org/html/rfc8759
> 
> That the page number links are gone is understandable since there
> (fortunately) is no paging anymore but removing links for headers
> seem illogical in an HTML formatted document.
> 
> I understand that the IETF want to retire the RfcMarkup format but
> since the IETF apparently still publish in this format, shouldn't
> also stay useful?

The rfcmarkup generated documents are generated from the plain text
documents published by the RFC Editor, not directly from XML.  As
such, there are a lot of heuristics involved in recognizing different
parts of the document for what they are.  In particular, the spaced
dots (periods) which are part of the ToC, are used to recognize the
entries as ToC entries, rather than section titles.

So rendering without pages and page numbers has the effect of depriving
the htmlizer of the cues it needs to generate links from the ToC.

> I'm currently in the auth48 state and the on-line xml2rfc tool
> produces ToC links for appendices(!).  Is that a bug or a feature?

Feature.


	Henrik