Re: [netmod] looking for practical advice on managing YANG source in XML format RFCs
Ladislav Lhotka <ladislav.lhotka@nic.cz> Mon, 14 June 2021 07:40 UTC
Return-Path: <ladislav.lhotka@nic.cz>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 3CCFC3A192D; Mon, 14 Jun 2021 00:40:06 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.399
X-Spam-Level:
X-Spam-Status: No, score=-4.399 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_MED=-2.3, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=nic.cz
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 Qey_uGacUV5y; Mon, 14 Jun 2021 00:40:01 -0700 (PDT)
Received: from mail.nic.cz (mail.nic.cz [IPv6:2001:1488:800:400::400]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id B18A63A192A; Mon, 14 Jun 2021 00:39:59 -0700 (PDT)
Received: from localhost (unknown [IPv6:2001:1488:fffe:6:a88f:7eff:fed2:45f8]) by mail.nic.cz (Postfix) with ESMTPSA id E28E7140957; Mon, 14 Jun 2021 09:39:55 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=nic.cz; s=default; t=1623656396; bh=fVipS/i1U8L4hea/To3h6yyD46Of52wRPKvstZapnSc=; h=From:To:Date; b=XWI1fu5sr7v3imQLedPZTxEvOfmtY+aDzkkU+vQRGA4Kyx8BVwEN3+VhQl8rl649c R2SbkHqWrGkQZF4jDHsOEtlsjeOw/Hycmz02dKomcCYv3plD9jioASXKPA1gGLjjBH wncM9TanGWyPpu7sRxMm1TnrJgt9v8erHkNAQ82E=
From: Ladislav Lhotka <ladislav.lhotka@nic.cz>
To: Michael Richardson <mcr+ietf@sandelman.ca>, netmod@ietf.org
Cc: tools-discuss@ietf.org, anima@ietf.org
In-Reply-To: <6795.1623632992@localhost>
References: <6795.1623632992@localhost>
Mail-Followup-To: Michael Richardson <mcr+ietf@sandelman.ca>, netmod@ietf.org, tools-discuss@ietf.org, anima@ietf.org
Date: Mon, 14 Jun 2021 09:39:55 +0200
Message-ID: <87o8c87v3o.fsf@nic.cz>
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
X-Virus-Scanned: clamav-milter 0.102.2 at mail
X-Virus-Status: Clean
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/9CxG-aXMcy4k3dOIWpFpBuxQbTM>
Subject: Re: [netmod] looking for practical advice on managing YANG source in XML format RFCs
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 14 Jun 2021 07:40:07 -0000
Hi Michael, you can check my project YANG-I-D [1] for some ideas. The most elegant way of including YANG modules in RFCs would be to treat the RFC source as a compound XML document combining xml2rfc with YANG modules in the YIN syntax - if only xml2rfc could process it. Lada [1] https://github.com/llhotka/YANG-I-D Michael Richardson <mcr+ietf@sandelman.ca> writes: > Hi, I'm not a regular netmod reader. > I subscribe via IMAP to look into what's going on. If I'm asking a FAQ, I > appologize as I didn't find anything in the 25K messages archived. > I saw Christian's message in 2019 about org-rfc-export. > I'm not sure if I should Reply-To: tools or netmod. > > I'm looking for advice on how to manage things. > A summary of my questions: > > 1) how to process yang files with YYYY-DD-MM into XML. > 2) how to generate yang tree files. > 3) how do I get my YANG includes downloaded, and do I put them into my repo? > 4) how to do this with MT Makefiles? > > When we were working on RFC8995 and RFC8366, in the days before Martin > Thompson's makefile was around, I just put pyang processing into my simple > Makefile. It's here: https://github.com/anima-wg/anima-bootstrap/blob/master/Makefile > > The perl script at: https://github.com/anima-wg/anima-bootstrap/blob/master/insert-figures > was then developed to insert stuff into the XML. It's rather hacky in some ways. > It started it's life as just something to find the latest @YYYY-MM-DD yang > file which the Makefile created. (Kent wrote that sed line three quarters of > a decade ago, and the sed line now is old enough to trick-or-treat) > Over time, it grew the ability to insert other bits of code or diagrams. > I keep using it, even when I've moved to Markdown because it inserts the > right artwork stuff, and knows to deal with YANG stuff. I also keep using my > Makefile, because except for the simplest uses, the MT ones are too > complicated for me to hack. > > With kramdown source, I can mostly just add stuff to the MT Makefile to > generate the files I need, and then mostly (without insert-figures), I can > use the ::include mechanism in kramdown to get the right things. But, no > magic YYYY-MM-DD stuff. > > So now I am collaborating with some co-authors which want to stick to XMLv3 > rather than kramdown, and whose understanding of Makefiles is poor. I want > to stick with the normal stuff so that all the github/etc. tooling works for > everyone involved. > > I'm looking for advice on how do this this? > > -- > Michael Richardson <mcr+IETF@sandelman.ca> . o O ( IPv6 IøT consulting ) > Sandelman Software Works Inc, Ottawa and Worldwide > > > > > _______________________________________________ > netmod mailing list > netmod@ietf.org > https://www.ietf.org/mailman/listinfo/netmod -- Ladislav Lhotka Head, CZ.NIC Labs PGP Key ID: 0xB8F92B08A9F76C67
- Re: [netmod] [Anima] looking for practical advice… Michael Richardson
- [netmod] looking for practical advice on managing… Michael Richardson
- Re: [netmod] [Anima] looking for practical advice… Michael Richardson
- Re: [netmod] [Anima] looking for practical advice… Carsten Bormann
- Re: [netmod] looking for practical advice on mana… Ladislav Lhotka
- Re: [netmod] [Anima] looking for practical advice… Kent Watsen
- Re: [netmod] [Anima] looking for practical advice… Michael Richardson
- Re: [netmod] [Anima] looking for practical advice… Carsten Bormann
- Re: [netmod] [Anima] looking for practical advice… Michael Richardson
- Re: [netmod] [Anima] looking for practical advice… Carsten Bormann
- Re: [netmod] [Anima] looking for practical advice… Michael Richardson
- Re: [netmod] [Anima] looking for practical advice… Carsten Bormann
- Re: [netmod] [Tools-discuss] [Anima] looking for … Salz, Rich
- Re: [netmod] [Anima] looking for practical advice… Michael Richardson
- Re: [netmod] [Anima] looking for practical advice… Christian Hopps