xml2rfc
xml2rfc copied to clipboard
<blockquote> not allowed inside of <dd>
type_defect
| by [email protected]
Example of where
insideseems 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
@[email protected] changed status from new
to under_review
@[email protected] commented
This would require a schema change and is awaiting review from the v3 team
@[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.,
(( artset | artwork | aside | dl | figure | ol |
sourcecode | t | table | ul)+
while
(( artset | artwork | blockquote | dl | figure | ol |
sourcecode | t | table | ul)+
(Since blockquote and aside render almost the same, the end result is particularly comical.)
@[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.
@[email protected] changed _comment0 which not transferred by tractive
@[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.
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)