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