Thank you for bringing this up Benjamin, you saved me from a long wild goose
chase!
It' good to know that there's a new rfc format version, but I am a bit worried
about venturing there given that I am barely managing the v2 as it is __ v3
still feels pretty experimental, and other than this issue, this spec doesn't
give a lot of opportunities to take advantage of the new features (SVG etc).
Wondering whether I can find a periphrase to express the same notion without
triggering the script, e.g. omitting the word section or changing the order.
Thx
V.
On 4/24/20, 19:02, "Benjamin Kaduk" <ka...@mit.edu> wrote:
Just on the xml2rfc bits...
On Wed, Apr 22, 2020 at 07:26:40AM +0000, Vittorio Bertocci wrote:
>
> > Link to section 4.1.2 of SCIM Core is actually linking to section 4.1.2
of this doc.
> Oh wow. That’s a feature of XML2RFC,… my source simply says by section
4.1.2 of SCIM Core in a <t> block, and the processor interpret it as an
internal link. I’ll need to dig on how to prevent that from happening for this
instance. Good catch!
The short form is "you can't".
You're using the "v2" XML format for xml2rfc, which produces as various
output formats text, pdf, and "htmlized" output. The "htmlized" output is
called that and not "html" because it's the result of taking the text
output and running a script to turn common constructions in I-Ds and RFCs
into hopefully-useful HTML formatting. In this case, "Section N" outside
of "Section N of [bracketed-reference]" is assumed to be "Section N of the
current document", and that's all that the htmlization script is going to
give you, since it's not working with the semantic richness of the XML
source.
We do, however, as of fairly recently have a "v3" XML format, which is
capable of producing native HTML output that includes SVG figures and the
other exciting features of "v3 XML". For an example, see
https://www.ietf.org/id/draft-ietf-tsvwg-datagram-plpmtud-19.html .
I personally haven't done any v2-to-v3 conversions yet (too busy reading to
have time to do much writing), but the FAQ entry for doing so is at
https://www.rfc-editor.org/materials/FAQ-xml2rfcv3.html#name-how-do-i-convert-my-xml-fil
.
Hope that helps,
Ben
_______________________________________________
OAuth mailing list
OAuth@ietf.org
https://www.ietf.org/mailman/listinfo/oauth
