Re: [tcpdump-workers] [pcap-ng-format] New Version Notification for draft-tuexen-opsawg-pcapng-02.txt
--- Begin Message --- On Oct 18, 2020, at 1:32 AM, Michael Tuexen wrote: > Just a note. I'm using the .xml format and put a link in the README.md, which > shows the .txt or .html file based on the current .xml. Yes, that's what we were doing for the pcapng draft before switching to kramdown-rfc2629, and what we're still doing for the pcap draft, because I haven't yet switched it to kramdown-rfc2629. That works for xml2rfc XML; it doesn't work for kramdown-rfc2629, because xml2rfc.tools.ietf.org doesn't have a converter that goes from kramdown-rfc2629 directly to HTML/PDF/text.--- End Message --- ___ tcpdump-workers mailing list tcpdump-workers@lists.tcpdump.org https://lists.sandelman.ca/mailman/listinfo/tcpdump-workers
Re: [tcpdump-workers] [pcap-ng-format] New Version Notification for draft-tuexen-opsawg-pcapng-02.txt
--- Begin Message --- On Oct 17, 2020, at 6:01 PM, Michael Richardson wrote: > Guy Harris via tcpdump-workers wrote: > >> So is there anything we do to arrange that the "Current committed >> version as ..." links on the GitHub repository home page work again? > > Yes, there is a travis-ci process that generated the gh-pages. > I haven't done that yet. It was slightly involved before, but it has gotten > significantly easier I'm told. Travis-CI does the work. > Oops, it is now "Circle" (CI) that is going it: > > https://github.com/martinthomson/i-d-template/blob/main/doc/REPO.md > _Automatic Update for Editor's Copy with Circle CI_ So, once that's done, there will be .xml files in the repository, built from the .md files? (File, currently, but at some point I'll convert the pcap spec to kramedown-rfc2629 as well.) >> Or is there some site that will run kramdown-rfc2629 on a Markdown file >> and run xml2rfc on the result, along the lines of what >> xml2rfc.tools.ietf.org does? I haven't gotten > >> https://xml2rfc.tools.ietf.org/experimental.html#kramdown > >> to work - I tried pasting >> https://raw.githubusercontent.com/pcapng/pcapng/master/draft-tuexen-opsawg-pcapng.md >> into the URL box, selecting "Window", and hitting Submit, but it didn't >> seem to work, it just popped up a blank > > generally, "gem install kramedown-rfc2629" is all you need to do. Yes, that worked for me on macOS Catalina. (I'm not sure whether Big Sur ships with Ruby or not; Apple wants to stop shipping the scripting language interpreters - or, at least, the ones not required by Single UNIX Spec conformance - probably because they don't want to be responsible for making it work *and* for keeping it up to date. That's the tradeoff with "OS vendor provides third-party software" - the good news is it's there without having to download it, the bad news is that you may not be getting the latest version.) But that means that I can generate the .xml files on my machine, for checking purposes. I was trying to find a Web server that could be handed a URL for a kramedown-rfc2629 document and that would return an HTML/PDF/txt version of the document, for display in the browser, similar to what the xml2rfc server does for URLs pointing to an xml2rfc XML document, so that we could add links to README.me.--- End Message --- ___ tcpdump-workers mailing list tcpdump-workers@lists.tcpdump.org https://lists.sandelman.ca/mailman/listinfo/tcpdump-workers
Re: [tcpdump-workers] [pcap-ng-format] New Version Notification for draft-tuexen-opsawg-pcapng-02.txt
--- Begin Message --- On Oct 17, 2020, at 4:19 PM, Guy Harris wrote: > Or is there some site that will run kramdown-rfc2629 on a Markdown file and > run xml2rfc on the result, along the lines of what xml2rfc.tools.ietf.org > does? I haven't gotten > > https://xml2rfc.tools.ietf.org/experimental.html#kramdown > > to work - I tried pasting > https://raw.githubusercontent.com/pcapng/pcapng/master/draft-tuexen-opsawg-pcapng.md > into the URL box, selecting "Window", and hitting Submit, but it didn't seem > to work, it just popped up a blank window. OK, that appears to go from kramdown-rfc2629 to xml2rfc XML format, but doesn't go the rest of the way; they don't appear to have a converter that takes kramdown-rfc2629 as input and gives you HTML/text/PDF as output.--- End Message --- ___ tcpdump-workers mailing list tcpdump-workers@lists.tcpdump.org https://lists.sandelman.ca/mailman/listinfo/tcpdump-workers
Re: [tcpdump-workers] [pcap-ng-format] New Version Notification for draft-tuexen-opsawg-pcapng-02.txt
--- Begin Message --- On Sep 28, 2020, at 4:28 PM, Michael Richardson wrote: > Guy Harris wrote: >> For 2), I note that > >> >> https://github.com/pcapng/pcapng/blob/master/draft-tuexen-opsawg-pcapng.md > >> has a bunch of stuff that GitHub isn't treating as markup, such as the >> stuff prior to the "Introduction" heading, and the tags such as >> "{::boilerplate bcp14}". Is that an extension of Markdown not >> supported by GitHub's Markdown renderer but supported by some >> Markdown-to-RFC XML converter > > Yes, kramdown-rfc2629. The MT Makefile does all the magic. (Presumably "the MT Makefile" is the currently checked-in Martin Thompson Makefile in GitHub.) So is there anything we do to arrange that the "Current committed version as ..." links on the GitHub repository home page work again? Should we, for now, put the XML documents back into the repository, and either 1) arrange, somehow, that GitHub automatically regenerate the XML documents if the Markdown documents are updated, if that's possible or 2) have everybody who modifies the Markdown documents update the XML documents and check them in with the updated Markdown documents? Or is there some site that will run kramdown-rfc2629 on a Markdown file and run xml2rfc on the result, along the lines of what xml2rfc.tools.ietf.org does? I haven't gotten https://xml2rfc.tools.ietf.org/experimental.html#kramdown to work - I tried pasting https://raw.githubusercontent.com/pcapng/pcapng/master/draft-tuexen-opsawg-pcapng.md into the URL box, selecting "Window", and hitting Submit, but it didn't seem to work, it just popped up a blank window.--- End Message --- ___ tcpdump-workers mailing list tcpdump-workers@lists.tcpdump.org https://lists.sandelman.ca/mailman/listinfo/tcpdump-workers