xml2rfc icon indicating copy to clipboard operation
xml2rfc copied to clipboard

<blockquote> not allowed inside of <dd>

Open ietf-svn-bot opened this issue 4 years ago • 7 comments

type_defect | by [email protected]


Example of where

inside
seems useful in the following text.

(The workaround is to just use quotation marks, as in the original - which is readable; it's just not how the same quote would be handled if it were in a .)

Original (draft-ietf-hip-native-nat-traversal-33):

   Locator:
      As defined in [RFC8046]: "A name that controls how the packet is
      routed through the network and demultiplexed by the end-host.  It
      may include a concatenation of traditional network addresses such
      as an IPv6 address and end-to-end identifiers such as an ESP
      Security Parameter Index (SPI).  It may also include transport
      port numbers or IPv6 Flow Labels as demultiplexing context, or it
      may simply be a network address."

Attempted to use

- envisioning output along the lines of:
   Locator:
      As defined in [RFC8046]: 
      |  A name that controls how the packet is routed through the
      |  network and demultiplexed by the end host.  It may include a
      |  concatenation of traditional network addresses such as an IPv6
      |  address and end-to-end identifiers such as an ESP SPI.  It may
      |  also include transport port numbers or IPv6 Flow Labels as
      |  demultiplexing context, or it may simply be a network address.

File: https://www.rfc-editor.org/v3test/test_blockquote.xml

yields (234): Error: Element dd has extra content: blockquote, at /rfc/middle/section9ec338d81e4f22a396878fc78da1259c713489a2/dl/dd581394b850b8186c0bd36f7dddcae5d3ba5371e4/blockquote


Issue migrated from trac:570 at 2022-02-08 07:11:06 +0000

ietf-svn-bot avatar Nov 16 '20 19:11 ietf-svn-bot

@[email protected] changed status from new to under_review

ietf-svn-bot avatar Nov 25 '20 17:11 ietf-svn-bot

@[email protected] commented


This would require a schema change and is awaiting review from the v3 team

ietf-svn-bot avatar Nov 25 '20 17:11 ietf-svn-bot

@[email protected] commented


The origin of several such bugs is that the Relax-NG repeats itself incessantly, inconsistently. There should be single Relax-NG names for block-level and span-level elements, and they should be used everywhere these are needed.

E.g.,

says:
       (( artset | artwork | aside | dl | figure | ol | 
          sourcecode | t | table | ul)+

while

  • says:
           (( artset | artwork | blockquote | dl | figure | ol |
               sourcecode | t | table | ul)+
    

    (Since blockquote and aside render almost the same, the end result is particularly comical.)

  • ietf-svn-bot avatar Jan 04 '21 13:01 ietf-svn-bot

    @[email protected] commented


    There should be single Relax-NG names for block-level and span-level elements, and they should be used everywhere these are needed.

    Not convinced. There may be valid cases where the available elements differ. For instance, does it make sense to allow sourcecode in the abstract?

    And yes, if there are oversights we should fix those.

    ietf-svn-bot avatar Apr 27 '21 14:04 ietf-svn-bot

    @[email protected] changed _comment0 which not transferred by tractive

    ietf-svn-bot avatar Apr 27 '21 14:04 ietf-svn-bot

    @[email protected] commented


    I've added a ticket at https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/200 to track the wider issue.

    ietf-svn-bot avatar Apr 28 '21 00:04 ietf-svn-bot

    Another example: Section 5.1 of draft-ietf-tsvwg-l4s-arch-20 contains a block quote from RFC 3168 within a <dd> (https://www.ietf.org/archive/id/draft-ietf-tsvwg-l4s-arch-20.html#section-5.1-1.2.5.1)

    alicerusso avatar Oct 07 '22 17:10 alicerusso