User Tools

Site Tools


xml2rfc_examples

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
xml2rfc_examples [2020/10/28 14:28]
arusso
xml2rfc_examples [2020/10/28 15:14] (current)
arusso
Line 1: Line 1:
 ===== xml2rfc examples ===== ===== xml2rfc examples =====
  
-Considering "Is there a better way to do this?"+When considering "Is there a better way to do this?"
  
 ==== Summary ==== ==== Summary ====
Line 11: Line 11:
 ==== Details ==== ==== 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). 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. Note: As discussed with Henrik Nov. 2019.
  
-Example (from rfc8658.notprepped.xml)+Example (from rfc8658.notprepped.xml)
  
 XML: XML:
Line 36: Line 36:
  
 -------------- --------------
-Example (from rfc8731.notprepped.xml)+Example (from rfc8731.notprepped.xml)
  
 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 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\\ 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): ''    Fabio Maino, Cisco Systems, Inc.''
  
 b) name + email\\ 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\\ 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. Mail sent 2020-10-15 with details.
Line 108: Line 112:
 suggestion from Jean for dl's newline attribute: newline="false|break|space" suggestion from Jean for dl's newline attribute: newline="false|break|space"
  
-file: rfc8940.xml (draft-ietf-emu-eap-session-id-07) in AUTH48 currently+file: published as rfc8940.xml (draft-ietf-emu-eap-session-id-07) 
  
-=== More on #1 === 
  
  
xml2rfc_examples.1603920505.txt.gz · Last modified: 2020/10/28 14:28 by arusso