Re: [xml2rfc-dev] [Rfc-markdown] 1.3.7: supporting ditaa, mscgen in -3 mode

Miek Gieben <miek@miek.nl> Sun, 31 May 2020 06:00 UTC

Return-Path: <miek@miek.nl>
X-Original-To: xml2rfc-dev@ietfa.amsl.com
Delivered-To: xml2rfc-dev@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 73C9C3A125E for <xml2rfc-dev@ietfa.amsl.com>; Sat, 30 May 2020 23:00:51 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.897
X-Spam-Level:
X-Spam-Status: No, score=-1.897 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, SPF_HELO_NONE=0.001, SPF_NONE=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=miek-nl.20150623.gappssmtp.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 0opUFP9-mq52 for <xml2rfc-dev@ietfa.amsl.com>; Sat, 30 May 2020 23:00:49 -0700 (PDT)
Received: from mail-ed1-x529.google.com (mail-ed1-x529.google.com [IPv6:2a00:1450:4864:20::529]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 378823A1267 for <xml2rfc-dev@ietf.org>; Sat, 30 May 2020 23:00:44 -0700 (PDT)
Received: by mail-ed1-x529.google.com with SMTP id o26so1910805edq.0 for <xml2rfc-dev@ietf.org>; Sat, 30 May 2020 23:00:44 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=miek-nl.20150623.gappssmtp.com; s=20150623; h=date:from:to:cc:subject:message-id:mail-followup-to:references :mime-version:content-disposition:in-reply-to; bh=vBfOXFxiirJkx0x3WOxlmGBwZy5jxEoqf7LV0XSLGYY=; b=v/0MaStqnF+1loT/JlMz5OkoqO0vxWoQqs0B90rydcJTw+6P2vmjrGEaGhR4VsQUpW cVpab7LyAsncSbvwadtEY5Pd7pdKYjiiX8R4Nee4ukcbT8JiLnVQNyXQEWYuIFaqacl3 MaedvPpgqBqut3Lsvhm8ZRZoVceplkZXCJZiTvKFCXjiRDlZh+qpeYoqgo+PwfVdDahR xkzB9dSRUqyw9mffEgQepLVx6JgEyb+rNk22Wu5JbrzccZSdxe4dugT3pI15UKtKwzjb SZr/P+HffLjZRU6bTO1Cli0JHKHh9VtVSY4RzIzBkZq/9qZNJfhrrSsHX3tOuegvCt69 Edtg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id :mail-followup-to:references:mime-version:content-disposition :in-reply-to; bh=vBfOXFxiirJkx0x3WOxlmGBwZy5jxEoqf7LV0XSLGYY=; b=a1DkQrZa5gJEnnfYaoCTan1hvZ3vwQVjciPjdSzlOBbRddpju0pQGWmT+3RZGB2BVq Ke4sHNgJi1wI7SgiLzOKNJGJznjzwuNaSXMc65g1gMTIePd4LUDEn3g7qzsEmQF4YW4Y 67B3bjKgw2FflaH51UTbCKnFuxLh8139tUI5oqAt6nmj8Q9qHQ1Z/lqteyaJfrSyeaFx zLt+nahp2valUHPKPS3p/faxTOWyZ8ydqVILzQCguLt/YJQWLYsbVsGm3YyKICLOYJ/d FUK0GxqrNFdXYweipcH9xPiKoz2YV9XMhqEiS4t6CTQHuilRXaBOmtQ/4GxQa3ygmTxV Kmuw==
X-Gm-Message-State: AOAM530fL7gXc+KrWSRbSkQQ8u5Ta07ZdT0z2BA73D21tP5iYV3qA4V5 beS5gGjzBNudrzM7Mk4lSliYLg==
X-Google-Smtp-Source: ABdhPJxc6XvHgpdN8urWIyq5NCLaY9ldQviCEiaduiW9gP7tLbQSWJ6wyUOIcTU1Pf6EgPNFp6oH2w==
X-Received: by 2002:aa7:d999:: with SMTP id u25mr16081926eds.339.1590904843356; Sat, 30 May 2020 23:00:43 -0700 (PDT)
Received: from miek.nl (dhcp-077-251-206-012.chello.nl. [77.251.206.12]) by smtp.gmail.com with ESMTPSA id y13sm11503857ejm.107.2020.05.30.23.00.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 30 May 2020 23:00:42 -0700 (PDT)
Date: Sun, 31 May 2020 08:00:40 +0200
From: Miek Gieben <miek@miek.nl>
To: Carsten Bormann <cabo@tzi.org>
Cc: rfc-markdown@ietf.org, xml2rfc@ietf.org, xml2rfc-dev@ietf.org
Message-ID: <20200531060040.GA136848@miek.nl>
Mail-Followup-To: Carsten Bormann <cabo@tzi.org>, rfc-markdown@ietf.org, xml2rfc@ietf.org, xml2rfc-dev@ietf.org
References: <E1jduEw-0007if-7I@durif.tools.ietf.org> <93E5295E-CE96-4121-B3F5-C04540D542FD@tzi.org> <D6806E5D-2B6E-4464-9126-44F3F5C808F7@tzi.org> <1a5cfced-2718-0a4a-41ef-b366543ec5a2@gmail.com> <3E78C586-228A-457E-BADD-D66117FFD1C0@tzi.org> <D00FAAF2-E308-462C-9E35-825DB8DC2710@tzi.org>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"; format="flowed"
Content-Disposition: inline
In-Reply-To: <D00FAAF2-E308-462C-9E35-825DB8DC2710@tzi.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc-dev/xC37xs1khPPpNow_G83Sl3o7aAI>
Subject: Re: [xml2rfc-dev] [Rfc-markdown] 1.3.7: supporting ditaa, mscgen in -3 mode
X-BeenThere: xml2rfc-dev@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Discussion about particulars of xml2rfc V3 design, development and code." <xml2rfc-dev.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml2rfc-dev>, <mailto:xml2rfc-dev-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml2rfc-dev/>
List-Post: <mailto:xml2rfc-dev@ietf.org>
List-Help: <mailto:xml2rfc-dev-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml2rfc-dev>, <mailto:xml2rfc-dev-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sun, 31 May 2020 06:00:52 -0000

[ Quoting <cabo@tzi.org> in "[Rfc-markdown] 1.3.7: supporting di..." ]
>So, for instance, you can now write
>
>~~~ mscgen
>msc {
>  a,b,c;
>
>}
>~~~

I've had a similar idea and implemented it as a separate binary that manipulates
the markdown: https://mmark.miek.nl/post/markdown-filter/

This allows you to create pipelines, example one that uses a python program called
'protocol': https://github.com/mmarkdown/filter/tree/master/plugins/protocol

``` protocol
Source:16,TTL:8,Reserved:40
```
Figure: This is a protocol.

Will be transformed with `filter -p protocol < protocol.md | mmark -markdown`, to:

We describe the following protocol:

```
  0                   1                   2                   3
  0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|             Source            |      TTL      |               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+               +
|                            Reserved                           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
```
Figure: This is a protocol.

/Miek

--
Miek Gieben