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

Jay Daley <exec-director@ietf.org> Wed, 08 June 2022 10:48 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 2BDC4C138FBF for <ietfarch-rfc-interest-archive@ietfa.amsl.com>; Wed, 8 Jun 2022 03:48:05 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1654685285; bh=MAeIAfYqfPrHeCV2CqD4qKQmYOZ+sa4T+X0z70RtmcM=; h=From:In-Reply-To:Date:Cc:References:To:Subject:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe; b=sTNXRoi2qRlC2bAuG+Y8SbdB+MzjF6q/sgzTFjD49FmjBR9lJUtfLE/sq08+syfFT b25H3IBX7/jOfJRkDcpH/KQoB3Lmj9iHZWtHKzvi7bxK9dGgK7srXWOdB3zWIor1k0 dWEpCvcULERx6cntidt7HNe6G3RdSEdYbhG8Vmp8=
X-Mailbox-Line: From rfc-interest-bounces@rfc-editor.org Wed Jun 8 03:48:05 2022
Received: from ietfa.amsl.com (localhost [IPv6:::1]) by ietfa.amsl.com (Postfix) with ESMTP id C0AE3C15D876; Wed, 8 Jun 2022 03:48:04 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1654685284; bh=MAeIAfYqfPrHeCV2CqD4qKQmYOZ+sa4T+X0z70RtmcM=; h=From:In-Reply-To:Date:Cc:References:To:Subject:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe; b=gJyF0BngKOP4/8XQoSxuc6rwq+y7ReKUIrIqP0gj8/wLuWrk9e/Io/+fKO5gJPOMP emXfwdb62Eb375k+gU+8YQeIZZUOTUWyyzGWzMNnE6ulVoS4EOk9dEHQ2f0tsPgtfr VuCkku31QXMdtyHg3a4YABq2kdHy8QiiwwGu+NGs=
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 D7F45C15D86C for <rfc-interest@ietfa.amsl.com>; Wed, 8 Jun 2022 03:48:02 -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=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 8R0yDPXEr3wT for <rfc-interest@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 EF473C15D876 for <rfc-interest@rfc-editor.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)
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>
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-interest/gBe2L6s7ok9WZYOZ68-gmOjsHpw>
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>
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 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

_______________________________________________
rfc-interest mailing list
rfc-interest@rfc-editor.org
https://mailman.rfc-editor.org/mailman/listinfo/rfc-interest