Re: [rfc-i] Inserting SVG graphics into an IETF draft

Martin Thomson <mt@lowentropy.net> Wed, 25 May 2022 00:16 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 95B4CC397F4E for <ietfarch-rfc-interest-archive@ietfa.amsl.com>; Tue, 24 May 2022 17:16:38 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1653437798; bh=CeAM7sUIcB6fOeLrj+TZpv0BTNL/U2G+AyrOmx0Etc8=; h=In-Reply-To:References:Date:From:To:Subject:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe; b=QHG/FKIk1KNDFtjAQZOl1Vx+WUNxZSXO286WUk4gw/h8tLLf8JZXI/LKwvIeRSNUq GbMqR8pxM92K7RJ8CTJunfje6p4eZk0AkAIncxsnsoEbND8d1jaczrvsF72WDPdQMQ yF9cXQlpSDrGRCNTbwdeHBqKOiHcpncQtPitnGYY=
X-Mailbox-Line: From rfc-interest-bounces@rfc-editor.org Tue May 24 17:16:38 2022
Received: from ietfa.amsl.com (localhost [IPv6:::1]) by ietfa.amsl.com (Postfix) with ESMTP id 68BFEC20D69F; Tue, 24 May 2022 17:16:38 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1653437798; bh=CeAM7sUIcB6fOeLrj+TZpv0BTNL/U2G+AyrOmx0Etc8=; h=In-Reply-To:References:Date:From:To:Subject:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe; b=QHG/FKIk1KNDFtjAQZOl1Vx+WUNxZSXO286WUk4gw/h8tLLf8JZXI/LKwvIeRSNUq GbMqR8pxM92K7RJ8CTJunfje6p4eZk0AkAIncxsnsoEbND8d1jaczrvsF72WDPdQMQ yF9cXQlpSDrGRCNTbwdeHBqKOiHcpncQtPitnGYY=
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 4401DC20D69F for <rfc-interest@ietfa.amsl.com>; Tue, 24 May 2022 17:16:37 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.099
X-Spam-Level:
X-Spam-Status: No, score=-2.099 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, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=lowentropy.net header.b=qK5YORnP; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=EQwtICDN
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 DoJUX2JOd4_g for <rfc-interest@ietfa.amsl.com>; Tue, 24 May 2022 17:16:32 -0700 (PDT)
Received: from wout2-smtp.messagingengine.com (wout2-smtp.messagingengine.com [64.147.123.25]) (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 92C84C20D69E for <rfc-interest@rfc-editor.org>; Tue, 24 May 2022 17:16:32 -0700 (PDT)
Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.west.internal (Postfix) with ESMTP id 85A383200937 for <rfc-interest@rfc-editor.org>; Tue, 24 May 2022 20:16:31 -0400 (EDT)
Received: from imap41 ([10.202.2.91]) by compute3.internal (MEProxy); Tue, 24 May 2022 20:16:31 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lowentropy.net; h=cc:content-type:date:date:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:sender:subject :subject:to:to; s=fm2; t=1653437791; x=1653524191; bh=MGY71kUAvL uc+rYhwUigVtqRpmf76F5E2zgrEdUjME4=; b=qK5YORnPar7aFny9VCy79kYYcJ 9SkxpV1O5k/ZEQUNZh3OwFskJBZgjQ/WyO6EItdVYHQaqYJwHSqM32qC0u7FMsfJ 5oG3dAZZ12TJwH44Ym/aJZ2jEKZh7ArEFY+rUouRA/FgFHS9rvcoeIIbpOFGsoau BxIxvFKkxVT5kzLQvnBBomHAtOn01dkg+wDvI+vWLRUo9P4OnYSE6mr+BsVpdIDm VYxhLaEqMZZn2efh8NkuNDO5xrTjfFwO5ysk1LpQx4jW9x121QnTWpy3fo5+iN7+ zi9xmI198N4KAjB5vp3BPpcHHWzpUVRxt1vj6FHVvbuu/owpJ2R3EJzRvgyQ==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:date:feedback-id :feedback-id:from:from:in-reply-to:in-reply-to:message-id :mime-version:references:reply-to:sender:subject:subject:to:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm1; t=1653437791; x=1653524191; bh=MGY71kUAvLuc+rYhwUigVtqRpmf7 6F5E2zgrEdUjME4=; b=EQwtICDNWOlKIF7vvcq8hH6HnogKcxqzcAVYmYsY5aEo rpVuz2YKI8/jyfX4k0OANSXLsCP2ZvLpKsN9mnJ6mkER8EmArRYBdsBgB5BqTkWr onOcq8iD3tRZPt5uOTuh9NgWTooCmlgzEjtb2goCfnGAFZRcci6qM9foHmEuvlyh clJZVPAak3cJj38xxbAoVbbvUYcn/oGayQ8FYdgbG6GV33R6JyHh7pCfZMX52oDn oTlFIcg/nGy786LB+b2xS/nZiSJJtoaWEzN9Z3zpkTdhoC0HHSZ1JWMguxEnNAy7 2SJ0v0/Ccdban7Aw8Ks7Q6O5Ryq+weNT0ieLFJSHgg==
X-ME-Sender: <xms:XnWNYifgwx54gRNqWasCtwdtYSZ1mnpLaZLfUIoCPk04TSqlm0ZvBg> <xme:XnWNYsOWs9I0iuaT1qT-YfM-1kRQdLzxj4TWPz-icSIekHdQKOMtJDpQv9eJkRpye l1R1E87U_VHXSOIg8A>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrjeeggdefudcutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepofgfggfkjghffffhvffutgesthdtre dtreertdenucfhrhhomhepfdforghrthhinhcuvfhhohhmshhonhdfuceomhhtsehlohif vghnthhrohhphidrnhgvtheqnecuggftrfgrthhtvghrnhepledvgfdtheeugfdtjeevge egffduieelleeugefgieetveehfedvueduheehffeknecuffhomhgrihhnpehhthhtphif ghdrohhrghdpghhithhhuhgsrdgtohhmpdhrfhgtqdgvughithhorhdrohhrghdpihgvth hfrdhorhhgnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhho mhepmhhtsehlohifvghnthhrohhphidrnhgvth
X-ME-Proxy: <xmx:XnWNYji7Dh3qkwRrHjs4LDguZ7lzOTjUgONnH45uwwdbWvHiZHslmA> <xmx:XnWNYv9y_QdDgGlw7a50UlpKni_eZUZtIWomGZgAJMgIAHwVtGgKbA> <xmx:XnWNYuvUkn1drW28LUmQ8iS9mbBcbpCvE-vw7zlBBWVcui5vdcFCxg> <xmx:X3WNYs6Ia8rRrlqfiEmDbq4B3MCf3UZ9F-KVSwbofby_9KRUXXwVPg>
Feedback-ID: ic129442d:Fastmail
Received: by mailuser.nyi.internal (Postfix, from userid 501) id 93593234006D; Tue, 24 May 2022 20:16:30 -0400 (EDT)
X-Mailer: MessagingEngine.com Webmail Interface
User-Agent: Cyrus-JMAP/3.7.0-alpha0-591-gfe6c3a2700-fm-20220427.001-gfe6c3a27
Mime-Version: 1.0
Message-Id: <7089978b-71d2-481f-9043-a73db2bb7304@beta.fastmail.com>
In-Reply-To: <a8987247-ccd9-6dfb-d89c-95245366b9b1@gmail.com>
References: <MN2PR11MB375770AEBE5A992CC01156ACB9D79@MN2PR11MB3757.namprd11.prod.outlook.com> <A2C534F3-3162-4779-A637-BA42C5C44215@ietf.org> <MN2PR11MB37570AF809E4FA14CB3DFE3AB9D79@MN2PR11MB3757.namprd11.prod.outlook.com> <6031EEDF-C648-4492-97CC-CB0EDAB475D7@amsl.com> <a8987247-ccd9-6dfb-d89c-95245366b9b1@gmail.com>
Date: Wed, 25 May 2022 10:16:11 +1000
From: Martin Thomson <mt@lowentropy.net>
To: rfc-interest@rfc-editor.org
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-interest/8vKro6XTwjHJ_mslS0BcPQFlUvc>
Subject: Re: [rfc-i] Inserting SVG graphics into an IETF draft
X-BeenThere: rfc-interest@rfc-editor.org
X-Mailman-Version: 2.1.34
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="us-ascii"
Content-Transfer-Encoding: 7bit
Errors-To: rfc-interest-bounces@rfc-editor.org
Sender: rfc-interest <rfc-interest-bounces@rfc-editor.org>

I still draw ASCII art.  It seems like you could do the same for this example.

aasvg [1] produces acceptable SVG from ASCII art that is guaranteed to be acceptable to svgcheck and RFC 7996 [2].  Example: https://httpwg.org/http2-spec/draft-ietf-httpbis-http2bis.html#figure-2

[1] https://github.com/martinthomson/aasvg
[2] With default options and one caveat: it puts width and height attributes on the <svg> element, which xml2rfc doesn't like.  But xml2rfc is wrong to complain.

On Wed, May 25, 2022, at 09:11, Brian E Carpenter wrote:
> In my experience, dia is just about the only tool that gets close to 
> meeting RFC7996 requirements. Whatever tool Paul used generates 
> constructs that RFC7996 disallows, and svgcheck therefore removes.
>
> Even Alice's version doesn't scale properly. My personal fixup tool 
> produced the attached from Alice's, which does allow scaling.
>
> Major surgery is needed rather than fixup tools.
>
> Regards
>     Brian
>
> On 25-May-22 05:02, Alice Russo wrote:
>> Hi Paul,
>> 
>> I ran your file through svgcheck [1] w/ the -r repair option, edited the output in Dia bc it had removed all the text, ran svgcheck -r again to get a file for which it says 'File conforms to SVG requirements.' Here's the file in case it's useful:
>> https://www.rfc-editor.org/v3test/AliceBobSample_alt.svg
>> 
>> Alice
>> 
>> [1] https://github.com/ietf-tools/RfcEditor/tree/master/svgcheck
>> 
>>> On May 24, 2022, at 9:21 AM, Paul Duffy (paduffy) <paduffy=40cisco.com@dmarc.ietf.org> wrote:
>>>
>>> Thanks Jay, but I've already been there.
>>>
>>> The SVG generated by my production tool is not accepted by the IETF validators (despite the fact it is fine with any other SVG viewer I have tried).
>>>
>>>
>>> -----Original Message-----
>>> From: Jay Daley <exec-director@ietf.org>
>>> Sent: Tuesday, May 24, 2022 12:14 PM
>>> To: Paul Duffy (paduffy) <paduffy@cisco.com>
>>> Cc: RFC Interest <rfc-interest@rfc-editor.org>
>>> Subject: Re: [rfc-i] Inserting SVG graphics into an IETF draft
>>>
>>> Hi Paul
>>>
>>>> On 24 May 2022, at 17:01, Paul Duffy (paduffy) <paduffy=40cisco.com@dmarc.ietf.org> wrote:
>>>>
>>>> Greetings all
>>>>
>>>> After much material review and head scratching, I have an intentionally open-ended question to ask.
>>>>
>>>> Please find attached a sample Kramdown draft and related SVG graphic.  This SVG displays corrected on all of the 12 or so viewers I have tried.
>>>>
>>>> How do I incorporate this SVG into the RFC draft?
>>>
>>>
>>> See the documentation at https://authors.ietf.org/en/diagrams
>>>
>>> kind regards
>>> Jay
>>>
>>>
>>>>
>>>> Cheers
>>>>
>>>>
>>>>
>>>> <AliceBobSample.svg><AliceAndBob.md>_______________________________________________
>>>> 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
>>>
>> 
>> _______________________________________________
>> 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
>
> Attachments:
> * AB_alt_fixed.svg

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