IETF Logo Mail Archive

Re: [Rfc-markdown] [rfc-i] Problem with Kramdown tooling and figures?

Jay Daley <exec-director@ietf.org> Wed, 08 June 2022 15:36 UTC

Return-Path: <exec-director@ietf.org>
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 7A3D1C157901 for <rfc-markdown@ietfa.amsl.com>; Wed, 8 Jun 2022 08:36:00 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.909
X-Spam-Level:
X-Spam-Status: No, score=-1.909 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01] autolearn=ham autolearn_force=no
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 XsIKw_SAbstN for <rfc-markdown@ietfa.amsl.com>; Wed, 8 Jun 2022 08:35:59 -0700 (PDT)
Received: from ietfx.amsl.com (ietfx.amsl.com [50.223.129.196]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 7C0B2C15AAD0 for <rfc-markdown@ietf.org>; Wed, 8 Jun 2022 08:35:57 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by ietfx.amsl.com (Postfix) with ESMTP id 6578E4053E24; Wed, 8 Jun 2022 08:35:57 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
Received: from ietfx.amsl.com ([50.223.129.196]) by localhost (ietfx.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Y4SvGVLbNrC9; Wed, 8 Jun 2022 08:35:57 -0700 (PDT)
Received: from smtpclient.apple (host-92-27-125-209.static.as13285.net [92.27.125.209]) by ietfx.amsl.com (Postfix) with ESMTPSA id 877B54053E20; Wed, 8 Jun 2022 08:35:56 -0700 (PDT)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.100.31\))
From: Jay Daley <exec-director@ietf.org>
In-Reply-To: <28E28C6A-5C59-41AB-BB2C-A500CB48B89E@tzi.org>
Date: Wed, 08 Jun 2022 16:35:54 +0100
Cc: "Paul Duffy (paduffy)" <paduffy=40cisco.com@dmarc.ietf.org>, "rfc-markdown@ietf.org" <rfc-markdown@ietf.org>, RFC Interest <rfc-interest@rfc-editor.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <DE0DDA91-3982-4314-8709-150EA3F2B8EA@ietf.org>
References: <MN2PR11MB37570F4603464349B5DFFE5AB9A59@MN2PR11MB3757.namprd11.prod.outlook.com> <5E5D4003-E3D8-49B2-B14D-5D4AC7ADA0A3@tzi.org> <MN2PR11MB3757F2B3467FA1B188A1294DB9A49@MN2PR11MB3757.namprd11.prod.outlook.com> <7FFFF173-7D5F-4000-BDD1-9B407767C48E@ietf.org> <MN2PR11MB375776E0FFAA1023CFE4334AB9A49@MN2PR11MB3757.namprd11.prod.outlook.com> <99D6215E-50DA-422C-96D1-50949951394D@ietf.org> <MN2PR11MB3757A781285E16B585A6F841B9A49@MN2PR11MB3757.namprd11.prod.outlook.com> <MN2PR11MB375760E12BFCDEB0ABA516BAB9A49@MN2PR11MB3757.namprd11.prod.outlook.com> <28E28C6A-5C59-41AB-BB2C-A500CB48B89E@tzi.org>
To: Carsten Bormann <cabo@tzi.org>
X-Mailer: Apple Mail (2.3696.100.31)
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/LgUmAWsrnrS5cFY-pQ6A6JQC0oQ>
Subject: Re: [Rfc-markdown] [rfc-i] Problem with Kramdown tooling and figures?
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, 08 Jun 2022 15:36:00 -0000


> On 8 Jun 2022, at 16:12, Carsten Bormann <cabo@tzi.org> wrote:
> 
> On 2022-06-08, at 17:06, Paul Duffy (paduffy) <paduffy=40cisco.com@dmarc.ietf.org> wrote:
>> 
>> ... results in the following XML …
> 
> This is the one I fixed in kramdown-rfc 1.6.11, just pushed.
> (I’m not sure how quickly that is going up on author-tools.)
> 
> Grüße, Carsten
> 
> Oh, and:
> 
>> FYI a quick kramdown test using a correct example from the templates…
> 
> The example is not “correct” as far as current xml2rfc usage goes: it does not have an ascii-art branch in the artset.


The templates contain ascii-art as well as SVG.  Omitting the ascii-art is correct, but not recommended.  As noted in the documentation:

> If only SVG is provided then it is used in the HTML and PDF rendering but no diagram is included in the plaintext rendering, replaced with a message that says "Artwork only available as SVG". For this reason, providing only SVG is not recommended.

Jay

> 
> Grüße, Carsten
> 

-- 
Jay Daley
IETF Executive Director
exec-director@ietf.org

v2.23.0 | Report a Bug | By Email