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

Carsten Bormann <cabo@tzi.org> Tue, 07 June 2022 22:51 UTC

Return-Path: <rfc-interest-bounces@rfc-editor.org>
X-Original-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Delivered-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Received: from ietfa.amsl.com (localhost [IPv6:::1]) by ietfa.amsl.com (Postfix) with ESMTP id F3919C15AAE3 for <ietfarch-rfc-interest-archive@ietfa.amsl.com>; Tue, 7 Jun 2022 15:51:08 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1654642268; bh=G2Kkx7BaJx8p5bz0R7tgLWYC8uSuepWMn+hdVD6dwk0=; h=From:In-Reply-To:Date:Cc:References:To:Subject:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: Reply-To; b=i4Zx639xMWnE8s8nQKuzHPu2kmN65g/G6hLfgUAwQeXs+cA6Id/OArezQGBZ284sl /O3mwXsBNfkCaEz3Txhn7PcpJu50kFu3WfaC4/fAxju0I34vb2qovGMhNFClaWC97v Emge0Hd9pfmErqA37TH+8odMF4DKHAU0kM9bvkPM=
X-Mailbox-Line: From rfc-interest-bounces@rfc-editor.org Tue Jun 7 15:51:08 2022
Received: from ietfa.amsl.com (localhost [IPv6:::1]) by ietfa.amsl.com (Postfix) with ESMTP id 874F2C14F74B; Tue, 7 Jun 2022 15:51:08 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1654642268; bh=G2Kkx7BaJx8p5bz0R7tgLWYC8uSuepWMn+hdVD6dwk0=; h=From:In-Reply-To:Date:Cc:References:To:Subject:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: Reply-To; b=i4Zx639xMWnE8s8nQKuzHPu2kmN65g/G6hLfgUAwQeXs+cA6Id/OArezQGBZ284sl /O3mwXsBNfkCaEz3Txhn7PcpJu50kFu3WfaC4/fAxju0I34vb2qovGMhNFClaWC97v Emge0Hd9pfmErqA37TH+8odMF4DKHAU0kM9bvkPM=
X-Original-To: rfc-interest@ietfa.amsl.com
Delivered-To: rfc-interest@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 2AF25C14F74B for <rfc-interest@ietfa.amsl.com>; Tue, 7 Jun 2022 15:51:08 -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, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=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 VhcXvifBPLFu for <rfc-interest@ietfa.amsl.com>; Tue, 7 Jun 2022 15:51:02 -0700 (PDT)
Received: from gabriel-smtp.zfn.uni-bremen.de (gabriel-smtp.zfn.uni-bremen.de [134.102.50.15]) (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 AD8A5C14F733 for <rfc-interest@rfc-editor.org>; Tue, 7 Jun 2022 15:50:59 -0700 (PDT)
Received: from smtpclient.apple (p5089ad4f.dip0.t-ipconnect.de [80.137.173.79]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by gabriel-smtp.zfn.uni-bremen.de (Postfix) with ESMTPSA id 4LHlvN15W0zDCc5; Wed, 8 Jun 2022 00:50:56 +0200 (CEST)
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.100.31\))
From: Carsten Bormann <cabo@tzi.org>
In-Reply-To: <MN2PR11MB37570F4603464349B5DFFE5AB9A59@MN2PR11MB3757.namprd11.prod.outlook.com>
Date: Wed, 08 Jun 2022 00:50:55 +0200
Cc: RFC Interest <rfc-interest@rfc-editor.org>
Message-Id: <5E5D4003-E3D8-49B2-B14D-5D4AC7ADA0A3@tzi.org>
References: <MN2PR11MB37570F4603464349B5DFFE5AB9A59@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-interest/O9Qt65IezGi8GaRjo5EdQBOILlI>
Subject: Re: [rfc-i] Problem with Kramdown tooling and figures?
X-BeenThere: rfc-interest@rfc-editor.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: "A list for discussion of the RFC series and RFC Editor functions." <rfc-interest.rfc-editor.org>
List-Unsubscribe: <https://mailman.rfc-editor.org/mailman/options/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-interest/>
List-Post: <mailto:rfc-interest@rfc-editor.org>
List-Help: <mailto:rfc-interest-request@rfc-editor.org?subject=help>
List-Subscribe: <https://mailman.rfc-editor.org/mailman/listinfo/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=subscribe>
Reply-To: rfc-markdown@ietf.org
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
Errors-To: rfc-interest-bounces@rfc-editor.org
Sender: rfc-interest <rfc-interest-bounces@rfc-editor.org>

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