Hi Carsten,

We are unable to work with this file at this time as it does not work with our 
local install of kramdown-rfc or with author-tools.  author-tools does already 
support utftex and tex2svg: 
https://github.com/ietf-tools/author-tools/pull/368.  Additionally, we have 
opened an issue regarding kgt: 
https://github.com/ietf-tools/author-tools/issues/617. 

Please submit a markdown file that works with author-tools or let us know if 
you prefer to default to working with XML for this document.

Thank you,
Sarah Tarrant
RFC Production Center

> On Dec 2, 2025, at 5:01 PM, Carsten Bormann <[email protected]> wrote:
> 
> Hi Sarah,
> 
> apologies for my late reply.
> 
> On Nov 24, 2025, at 19:38, Sarah Tarrant <[email protected]> 
> wrote:
>> 
>> Hi Carsten,
>> 
>> Thank you for making the updates and providing a self-contained markdown 
>> file.
>> 
>> It appears that we are unable to generate the RFCXML from the markdown file. 
>> We haven't been able to identify the reason, but perhaps you are running a 
>> not-yet-deployed version of kramdown-rfc?
> 
> I’m using stock kramdown-rfc (1.7.29) on one of my two main working machines, 
> and just had success in trying to build the markdown file I submitted.
> 
>> Could you provide a self-contained markdown file that parses with the most 
>> current version of kramdown-rfc?
> 
> This is hard to diagnose without the actual error messages, but I’d check 
> that you have looked at my response to question 8, reproduced below.
> 
> You can either install kgt and tex2svg as described in [1], using 
> installation commands such as those reproduced below, or you can use Martin 
> Thomson’s “math” docker image "martinthomson/i-d-template@v1m” that already 
> includes these tools.
> 
> [1]: https://github.com/cabo/kramdown-rfc/wiki/SVG
> 
> Grüße, Carsten
> 
> 
> ## Tool installation commands
> 
> (Use a PREFIX appropriate on your machine.)
> 
> 
> # kgt
> brew install bmake
> git clone --recursive https://github.com/katef/kgt.git
> cd kgt
> PREFIX=$HOME bmake -r install
> 
> # utftex
> brew install utftex
> 
> # tex2svg
> npm install -g cabo/mathjax-node-cli
> 
> 
> ## Details about the tools needed
> 
>> 8) This document contains SVG. What tool did you use to make the svg?
> 
> kgt (Kate’s Grammar Tool) for the railroad diagram (Figure 1)
> tex2svg (part of mathjax-node-cli) for the formula (Section 5.1.1) [and 
> utftex for its text rendition] 
> 
> Please see
> https://github.com/cabo/kramdown-rfc/wiki/SVG
> for details on how to install and use these tools.
> 
> Note that kgt outputs tentative width/height values that need to be adjusted 
> for the height actually used (too much space is currently left unused), so 
> editing the SVG is required here.
> 

-- 
auth48archive mailing list -- [email protected]
To unsubscribe send an email to [email protected]

Reply via email to