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

Jay Daley <exec-director@ietf.org> Wed, 08 June 2022 10:48 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 3C308C15D86C for <rfc-markdown@ietfa.amsl.com>; Wed, 8 Jun 2022 03:48:03 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.906
X-Spam-Level:
X-Spam-Status: No, score=-1.906 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, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=unavailable 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 R9UdwZ7CDZ8B for <rfc-markdown@ietfa.amsl.com>; Wed, 8 Jun 2022 03:47:58 -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 E85BFC15D862 for <rfc-markdown@ietf.org>; Wed, 8 Jun 2022 03:47:58 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by ietfx.amsl.com (Postfix) with ESMTP id D3F5040D10D8; Wed, 8 Jun 2022 03:47:58 -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 E_HgYYwQ8pib; Wed, 8 Jun 2022 03:47:58 -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 27C9840A55B4; Wed, 8 Jun 2022 03:47:58 -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: <MN2PR11MB3757F2B3467FA1B188A1294DB9A49@MN2PR11MB3757.namprd11.prod.outlook.com>
Date: Wed, 08 Jun 2022 11:47:54 +0100
Cc: "rfc-markdown@ietf.org" <rfc-markdown@ietf.org>, RFC Interest <rfc-interest@rfc-editor.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <7FFFF173-7D5F-4000-BDD1-9B407767C48E@ietf.org>
References: <MN2PR11MB37570F4603464349B5DFFE5AB9A59@MN2PR11MB3757.namprd11.prod.outlook.com> <5E5D4003-E3D8-49B2-B14D-5D4AC7ADA0A3@tzi.org> <MN2PR11MB3757F2B3467FA1B188A1294DB9A49@MN2PR11MB3757.namprd11.prod.outlook.com>
To: "Paul Duffy (paduffy)" <paduffy=40cisco.com@dmarc.ietf.org>
X-Mailer: Apple Mail (2.3696.100.31)
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/PUZN2zk3hZAi4Uvo5H8PCPgOh2o>
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 10:48:03 -0000

Hi Paul

> On 8 Jun 2022, at 05:23, Paul Duffy (paduffy) <paduffy=40cisco.com@dmarc.ietf.org> wrote:
> 
> Hi Carsten
> 
> Per our previous conversation, I will be incorporating SVG graphics into my kramdown draft.
> 
> But I first tested the tooling with a very simple figure example lifted from one of the XML draft templates.  

Can I ask which of the templates you used?

cheers
Jay

> 
> Cheers
> 
> -----Original Message-----
> From: rfc-interest <rfc-interest-bounces@rfc-editor.org> On Behalf Of Carsten Bormann
> Sent: Tuesday, June 7, 2022 6:51 PM
> To: Paul Duffy (paduffy) <paduffy=40cisco.com@dmarc.ietf.org>
> Cc: RFC Interest <rfc-interest@rfc-editor.org>
> Subject: Re: [rfc-i] Problem with Kramdown tooling and figures?
> 
> Hi Paul,
> 
>> On 7. Jun 2022, at 22:32, Paul Duffy (paduffy) <paduffy=40cisco.com@dmarc.ietf.org> wrote:
>> 
>> I have a Kramdown draft with the following figure attempt ...
>> 
>> <figure anchor="xml_happy">
>>  <artwork align="left" name="" type="" alt=""><![CDATA[
>> +-----------------------+
>> | Use XML, be Happy :-) |
>> |_______________________|
>>     ]]></artwork>
>> </figure>
>> 
>> XML result from  https://author-tools.ietf.org/ …
>> 
>> <figure anchor="xml_happy"/>
>> <artwork align="left" name="" type="" alt="">&lt;![CDATA[
>> +-----------------------+
>> | Use XML, be Happy :-) |
>> |_______________________|
>> ]]&gt;</artwork>
> 
> When I try this I get a couple of error messages:
> 
> - Found no end tag for 'figure' (line 575) - auto-closing it
> - Found invalidly used HTML closing tag for 'figure' on line 581
> 
> …and a different (similarly broken) XML output, too; I’d probably need the whole document to reproduce this.
> 
> Clearly, something isn’t working the way we want it to with the XML (HTML) parsing in kramdown here (kramdown is the markdown engine on which kramdown-rfc was built).
> 
> Of course, the fix is to just write:
> 
> ~~~
> +------------------------------+
> | Use markdown, be Happier :-) |
> |______________________________|
> ~~~
> {: #xml_happy}
> 
> But you probably had a reason why you wanted to put in your XML manually…
> 
> The mailing list to discuss this further is rfc-markdown@ietf.org (or maybe a GitHub issue on https://rfc.space).
> 
> Grüße, Carsten
> 
> _______________________________________________
> rfc-interest mailing list
> rfc-interest@rfc-editor.org
> https://mailman.rfc-editor.org/mailman/listinfo/rfc-interest
> _______________________________________________
> rfc-interest mailing list
> rfc-interest@rfc-editor.org
> https://mailman.rfc-editor.org/mailman/listinfo/rfc-interest

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