provide an option to maintain angle brackets around URIs

[tedharrison-rpc]

We might be limited by the way markdown handles creating URLs, but wanted to see if the following was possible:

Currently when adding a URL to the text when using kramdown-rfc - for example:

This is the homepage for the RFC Editor: <https://www.rfc-editor.org/>

creates the following in xml:

<t>This is the homepage for the RFC Editor: <eref target="https://www.rfc-editor.org/">https://www.rfc-editor.org/</eref></t>

Yields the following:
In html output:

This is the homepage for the RFC Editor: https://www.rfc-editor.org/

In txt output:

This is the homepage for the RFC Editor: https://www.rfc-editor.org/ (https://www.rfc-editor.org/)

Note that Section 3.3 of RFC 7322 strongly recommends using angle brackets around URIs.

So the desired xml would use the brackets="angle" attribute for eref like so:

<t>This is the homepage for the RFC Editor: <eref brackets="angle" target="https://www.rfc-editor.org/"/></t>

which yields:

This is the homepage for the RFC Editor: <https://www.rfc-editor.org/>

Currently, we note instances of URIs in the markdown to be updated manually in the XML later in the publication process - which adds some unwanted tedium.

[cabo]

In kramdown, you have control over individual attributes.

E.g.,

Let's see
<https://www.rfc-editor.org/>
as well as
<https://www.rfc-editor.org/>{: brackets="angle"}

yields (XML):

<t>Let's see
<eref target="https://www.rfc-editor.org/">https://www.rfc-editor.org/</eref>
as well as
<eref brackets="angle" target="https://www.rfc-editor.org/">https://www.rfc-editor.org/</eref></t>

and (plaintext):

   Let's see https://www.rfc-editor.org/ (https://www.rfc-editor.org/)
   as well as https://www.rfc-editor.org/ <https://www.rfc-editor.org/>

I don't know why the URI is doubled in the brackets="angle" case, but that is an xml2rfc issue.

[cabo]

Note that you can add some syntactic sugar here, e.g.

<!-- Once per document: -->

{:uri: brackets="angle"}

Let's see
<https://www.rfc-editor.org/>
as well as
<https://www.rfc-editor.org/>{:uri}

(Search for "ALD" in the kramdown, not the kramdown-rfc, documentation.)

[tedharrison-rpc]

Thanks Carsten!

I was able use that solution to get the desired behavior using the standard markdown syntax for a link and leaving the text blank:

{:uri: brackets="angle"}
The RFC Editor homepage: [](https://www.rfc-editor.org/){:uri}

yields in xml

<t>The RFC Editor homepage: <eref brackets="angle" target="https://www.rfc-editor.org/"/></t>

and in txt

The RFC Editor homepage: <https://www.rfc-editor.org/>