[Rfc-markdown] how to reference a draft, and a section within an RFC?
Paul Wouters <paul@nohats.ca> Wed, 25 January 2023 22:09 UTC
Return-Path: <paul@nohats.ca>
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 63FDAC14F6EB for <rfc-markdown@ietfa.amsl.com>; Wed, 25 Jan 2023 14:09:16 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.093
X-Spam-Level:
X-Spam-Status: No, score=-2.093 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_BLOCKED=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_NONE=0.001, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=nohats.ca
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id MAaVqgxlwzSM for <rfc-markdown@ietfa.amsl.com>; Wed, 25 Jan 2023 14:09:12 -0800 (PST)
Received: from mx.nohats.ca (mx.nohats.ca [193.110.157.85]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 0F670C14F721 for <rfc-markdown@ietf.org>; Wed, 25 Jan 2023 14:09:11 -0800 (PST)
Received: from localhost (localhost [IPv6:::1]) by mx.nohats.ca (Postfix) with ESMTP id 4P2J054xQ8zCfb for <rfc-markdown@ietf.org>; Wed, 25 Jan 2023 23:09:09 +0100 (CET)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nohats.ca; s=default; t=1674684549; bh=Bidqy3h43PfHisktrcf/o+ebniy2wn6lz2F3v42lCYs=; h=Date:From:To:Subject; b=GEJDjlI9C5QEshnRLtvkWqCorhirMIXT6rsfEa/XUzVFe43aPq94iwXcTNWtKVGdc zNfo+6D+J/fl4AjIQO6Vdl6OolHKXT7FYxvaCD/NAvR6ZLKk9RqWsTp3um4JeZ2CkC 7QGdcMZG1uF2B7liIO1EqQMVs6+oZjuaSSZdkNVw=
X-Virus-Scanned: amavisd-new at mx.nohats.ca
Received: from mx.nohats.ca ([IPv6:::1]) by localhost (mx.nohats.ca [IPv6:::1]) (amavisd-new, port 10024) with ESMTP id ShP-TWuDwL0Y for <rfc-markdown@ietf.org>; Wed, 25 Jan 2023 23:09:08 +0100 (CET)
Received: from bofh.nohats.ca (bofh.nohats.ca [193.110.157.194]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx.nohats.ca (Postfix) with ESMTPS for <rfc-markdown@ietf.org>; Wed, 25 Jan 2023 23:09:08 +0100 (CET)
Received: by bofh.nohats.ca (Postfix, from userid 1000) id 6A30167F2FE; Wed, 25 Jan 2023 17:09:06 -0500 (EST)
Received: from localhost (localhost [127.0.0.1]) by bofh.nohats.ca (Postfix) with ESMTP id 6639F67F2FD for <rfc-markdown@ietf.org>; Wed, 25 Jan 2023 17:09:06 -0500 (EST)
Date: Wed, 25 Jan 2023 17:09:06 -0500
From: Paul Wouters <paul@nohats.ca>
To: rfc-markdown@ietf.org
Message-ID: <b0161e83-b2d7-9edc-50d8-ef19e5cc408e@nohats.ca>
MIME-Version: 1.0
Content-Type: text/plain; format="flowed"; charset="US-ASCII"
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/7MyODX5H31koiP_98yZTGoso7yU>
Subject: [Rfc-markdown] how to reference a draft, and a section within an RFC?
X-BeenThere: rfc-markdown@ietf.org
X-Mailman-Version: 2.1.39
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: Wed, 25 Jan 2023 22:09:16 -0000
I've inherited a draft in this markdown format.
It seems to try to reference a section using:
({{rfcxxxx}}, Section x.y)
but that seems to not work? And this says you cannot do it:
https://github.com/cabo/kramdown-rfc/issues/21
Also, I can't find how to add a draft as reference. One would expect
that {{draft-ietf-foobar}} would work, but it doesn't.
I checked the examples/ dir and couldn't find examples either.
If there is documentation anywhere about the format, I would be
happy to read it.
Paul
- [Rfc-markdown] how to reference a draft, and a se… Paul Wouters
- Re: [Rfc-markdown] how to reference a draft, and … Carsten Bormann
- Re: [Rfc-markdown] how to reference a draft, and … Tim Wicinski
- Re: [Rfc-markdown] how to reference a draft, and … Carsten Bormann