Re: [Rfc-markdown] Am I missing any tools for markdown -> RFC?

"Andrew G. Malis" <agmalis@gmail.com> Mon, 11 June 2018 14:04 UTC

Return-Path: <agmalis@gmail.com>
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 39521130E51 for <rfc-markdown@ietfa.amsl.com>; Mon, 11 Jun 2018 07:04:48 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.999
X-Spam-Level:
X-Spam-Status: No, score=-1.999 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.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 jhVoV6-6cZxq for <rfc-markdown@ietfa.amsl.com>; Mon, 11 Jun 2018 07:04:41 -0700 (PDT)
Received: from mail-oi0-x22e.google.com (mail-oi0-x22e.google.com [IPv6:2607:f8b0:4003:c06::22e]) (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 32F0B1294D0 for <Rfc-markdown@ietf.org>; Mon, 11 Jun 2018 07:04:38 -0700 (PDT)
Received: by mail-oi0-x22e.google.com with SMTP id 14-v6so17981725oie.3 for <Rfc-markdown@ietf.org>; Mon, 11 Jun 2018 07:04:38 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=iABur7BS7mgrrsyZWtTNMam1DOXo4y6/sNX1MQl7fVk=; b=N+pI7P3topF/ryhVKTlR+2uXgAePxTbsDrvQ3QumRVL5sBRpldRaGSUHW4otZZO7P7 Yk8tfAzk6K8vc0OdArfjXCbekASbeWOkv7VwrnDxGbPvjp2gPa/+A/A3fB8G5RgwmcqP Croo6PvQwpl96d2KT69Lo+oBq/Ij57BMhALMPZWSPRKbmfl2iZf/ihBop7HvS2mBeiVV ydPCt/M/eLh3naTD7mn0iaEwXQ59TQyf4fz3UtV0cG87Go+D/GUhhNQh09UK89oW6zOb SG608zThiMinqrTTQ+3edll3YkJhuwM4c2imdHgbS9WFlaBdZrxMXeIq9u/oYDdf2ddD LYCw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=iABur7BS7mgrrsyZWtTNMam1DOXo4y6/sNX1MQl7fVk=; b=unx27Nh9EV9isMQTUhp153B0ym0YfssjfnTWSv5ZBjOtZtekH+A9CzxOFffzOMB+ai 1gEy6Vpk3B8924bCDLTghmHYnZFL4Vs3sBWPdTdkN7aRiL3PLSyzGTGW6pUxyS3iUtlV HDXy7TEyUVO1nz+eNABkfenIM8+gCrKqTICy9WICyeEelW87JGSmoqztLyyJxgB/q/z8 XOmJGPA+QpnF3hsQU3CUlb9FsLm+v2a03rIN1fT6DLCVDMPnLJqC3aLr4jJbQPTcE8U1 sIbGjvG01Aet7xlkgFnexDJvFSFHIaVnLNGkfTOK0meLEr2X5usZaClXw5VZSJOBzE+P Mn6w==
X-Gm-Message-State: APt69E1zO/xboHtLvI6GHdM0fKXg1wUG4znEVRRCMo+3kUKuWAOhGTCv CoYQRVg39vlwAELMf7dYjYa3Id6/RYveid35XDA=
X-Google-Smtp-Source: ADUXVKJvsQBQNsqEiUGBbGP5VjCZFHkLwkpBO9P5cq54GVE9shy5ivaNK1Xt/O7B4cERD+c3ZUmog7SIq1+evCbjlt4=
X-Received: by 2002:aca:e6c2:: with SMTP id d185-v6mr3604983oih.154.1528725877505; Mon, 11 Jun 2018 07:04:37 -0700 (PDT)
MIME-Version: 1.0
Received: by 2002:a9d:30c3:0:0:0:0:0 with HTTP; Mon, 11 Jun 2018 07:04:16 -0700 (PDT)
In-Reply-To: <C398444D-18AD-443D-96DC-6E9B3A0B5125@isoc.org>
References: <C398444D-18AD-443D-96DC-6E9B3A0B5125@isoc.org>
From: "Andrew G. Malis" <agmalis@gmail.com>
Date: Mon, 11 Jun 2018 10:04:16 -0400
Message-ID: <CAA=duU0Htqo-0HjknEMPr67wVS=ssziS0=2H1oLerYrGwKT1vg@mail.gmail.com>
To: Dan York <york@isoc.org>
Cc: "Rfc-markdown@ietf.org" <Rfc-markdown@ietf.org>
Content-Type: multipart/alternative; boundary="000000000000e34409056e5e3a3a"
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/hNeeuG5_OGxijdTiFtfVzeCEXtw>
Subject: Re: [Rfc-markdown] Am I missing any tools for markdown -> RFC?
X-BeenThere: rfc-markdown@ietf.org
X-Mailman-Version: 2.1.26
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: Mon, 11 Jun 2018 14:04:49 -0000

Dan,

You can point people at https://xml2rfc.tools.ietf.org/experimental.html if
they would like to use the online tools rather than install them locally.

Unfortunately, I’m not going to be able to attend, a conflict came up. I
would be interested in seeing your slides, however.

Thanks,
Andy


On Sun, Jun 10, 2018 at 3:51 AM, Dan York <york@isoc.org> wrote:

> Hi,
>
> I volunteered to give a brief presentation on Tuesday evening to a group
> of IETFers in Boston about using markdown to write RFCs. As part of that, I
> want to present the different tools people can use. Right now I am aware of:
>
> - kramdown - https://github.com/cabo/kramdown-rfc2629
>
> - mmark - https://github.com/miekg/mmark (and the companion Docker tool:
> https://github.com/paulej/rfctools )
>
> - pandoc - https://www.rfc-editor.org/rfc/rfc7328.txt
>
> - draftr -  https://ipv.sx/draftr/
>
> I will also point out Martin’s excellent I-D template: https://github.com/
> martinthomson/i-d-template/
> <https://github.com/martinthomson/i-d-template/blob/master/README.md>
>
> Are there any other tools you are aware of people using to convert
> markdown to RFCs?
>
> On a related note, I am aware of this existing tutorial on kramdown:
>
> https://www.ietf.org/about/participate/tutorials/process/
> writing-rfcs-and-internet-drafts-markdown-and-bit-yaml/
>
> Are there other existing tutorials / presentations / slides out there to
> which I should point people?
>
> Thanks,
> Dan
>
> P.S. This talk is part of a “IETF hub Boston” meeting that Alia Atlas has
> been organizing in our region. It won’t be recorded or streamed... but I
> may write an article / blog post about this when I am done.
>
> --
> Dan York
> york@isoc.org
> +1-802-735-1624
> skype:danyork
> http://twitter.com/danyork
>
> _______________________________________________
> Rfc-markdown mailing list
> Rfc-markdown@ietf.org
> https://www.ietf.org/mailman/listinfo/rfc-markdown
>
>