Differences

This shows you the differences between two versions of the page.

--- xml2rfc_examples [2020/10/28 14:28]
arusso
+++ xml2rfc_examples [2020/10/28 14:47]
arusso
@@ Line 1: / Line 1: @@
 ===== xml2rfc examples =====
-Considering "Is there a better way to do this?"
+When considering "Is there a better way to do this?"
 ==== Summary ====
@@ Line 11: / Line 11: @@
 ==== Details ====
-=== 1) xref to a section in another RFC and the authors want to include the section title ===
+==== 1) xref to a section in another RFC and the authors want to include the section title ====
 It requires 2 xrefs to get the desired output (using sectionFormat="bare" for the first one).
@@ Line 17: / Line 17: @@
 Note: As discussed with Henrik Nov. 2019.
-Example 1 (from rfc8658.notprepped.xml)
+Example A (from rfc8658.notprepped.xml)
 XML:
@@ Line 36: / Line 36: @@
 --------------
-Example 2 (from rfc8731.notprepped.xml)
+Example B (from rfc8731.notprepped.xml)
 XML:
@@ Line 55: / Line 55: @@
-=== 3) xref with format="title" doesn't work as expected ===
+==== 2) xref with format="title" doesn't work as expected ====
 bc it includes square brackets around the title in the text file
@@ Line 83: / Line 83: @@
-=== 4) use <contact> inside <t> when providing more information than fullname ===
+==== 3) use <contact> inside <t> when providing more information than fullname ====
-The functionality exists when <contact> is outside <t>  (e.g., a contributor listed in the style of an address block), but when the <contact> is in <t> in a list, it's not possible. So we end up putting data about the individual outside the <contact> element.
+It's possible to include more info when <contact> is outside <t> (e.g., a contributor listed in the style of an address block), but when the <contact> is in <t>, it's not possible. So we end up putting the data about the individual outside the <contact> element.
 a) name + org\\
-''<t><contact fullname="Fabio Maino"/>, Cisco Systems, Inc.</t>''\\
+XML: ''<t><contact fullname="Fabio Maino"/>, Cisco Systems, Inc.</t>''\\
-(file: draft-ietf-lisp-gpe-19.xml - in the queue)
+(file: draft-ietf-lisp-gpe-19.xml - in the queue)\\
+Original (in a list): ''   o  Fabio Maino, Cisco Systems, Inc.''
 b) name + email\\
-''<t><contact fullname="Ari Keränen"/> &lt;ari.keranen@ericsson.com&gt;</t>''\\
+XML: ''<t><contact fullname="Ari Keränen"/> &lt;ari.keranen@ericsson.com&gt;</t>''\\
-(file: rfc8790.notprepped.xml)
+(file: rfc8790.notprepped.xml)\\
+Original (in a registration template): ''Author:  Ari Keranen ari.keranen@ericsson.com''
 c) name + email + org\\
-''<t><contact fullname="Jiantao Fu"/> &lt;jianfu@cisco.com&gt; of Cisco Systems''\\
+XML: ''<t><contact fullname="Jiantao Fu"/> &lt;jianfu@cisco.com&gt; of Cisco Systems''\\
-(file: rfc8698.notprepped.xml)
+(file: rfc8698.notprepped.xml)\\
+Original (in a paragraph in "Contributors"): ''<nowiki> Jiantao Fu <jianfu@cisco.com> of Cisco Systems</nowiki>''
+Thinking aloud: ability to put the data in the contact element and have a decent rendering when in <t>.  (Currently, if we put additional data in the contact element when it's in <t>, the additional data doesn't appear in the output at all.)
-=== 5) get a <dl> with a blank line between <dt> and <dd> ===
+==== 4) get a <dl> with a blank line between <dt> and <dd> ====
 Mail sent 2020-10-15 with details.
@@ Line 110: / Line 114: @@
 file: rfc8940.xml (draft-ietf-emu-eap-session-id-07) in AUTH48 currently
-=== More on #1 ===

RSE Wiki Archive

User Tools

Site Tools

Differences

Page Tools