search

ietf-tools / rfc2html

Convert text-format RFCs and Internet-Drafts to html
BSD 3-Clause "New" or "Revised" License
30 stars 23 forks source link

References in txt documents are not recognised at the beginning of para #29

Open smyslov opened 2 years ago

smyslov commented 2 years ago

Describe the issue

If an I-D is submitted in txt format, then html and pdf versions are automatically generated for it. With this process references in the text (in the form "[xxxx]") are recognised and replaces with links to the referenced documents. However, if the construction "[xxxx]" is at the beginning of a paragraph, then it is not recognised as a reference and is left out.

As an example see https://datatracker.ietf.org/doc/draft-ietf-ipsecme-rfc8229bis/07/

Section 7.4 starts with a reference to RFC6311, which is not replaced with appropriate link neither in the html, nor in pdf versions. The same situation is in Section 10 (page 22) with reference to RFC5961.

Code of Conduct

larseggert commented 2 years ago

This is an issue with https://github.com/ietf-tools/rfc2html, which has a lot of hacky regex code.

rjsparks commented 2 years ago

And to be quite specific, when you say html and pdf versions, you mean htmlized-text and pdfed-htmlized-text. (As opposed to the html and pdf output from v3 xml input).