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 > >
- [Rfc-markdown] Am I missing any tools for markdow… Dan York
- Re: [Rfc-markdown] Am I missing any tools for mar… Carsten Bormann
- Re: [Rfc-markdown] Am I missing any tools for mar… Carsten Bormann
- Re: [Rfc-markdown] Am I missing any tools for mar… Andrew G. Malis