Improve Content Type figure placement.
authorRalph Giles <giles@mozilla.com>
Wed, 16 Jan 2013 22:14:32 +0000 (14:14 -0800)
committerRalph Giles <giles@mozilla.com>
Wed, 16 Jan 2013 22:14:32 +0000 (14:14 -0800)
With xml2rfc 2.3.9, I was getting the 'audio/ogg; codecs=opus'
figure hoisted out of the the containing paragraph, which was
very confusing.

I've tried to improve this by moving the surrounding paragraph
into the figure using the <preamble> and <postamble> tags, as
in the example in draft-mrose-writting-rfcs.

Unfortunately this still isn't perfect. Since the surrounding
paragraph is part of the figure we can't set align="center" on
the figure itself, and the processor seems to ignore it on the
artwork element. I've compensated by adding some leading
whitespace.

doc/draft-ietf-codec-oggopus.xml

index 7d55af9..8f55be1 100644 (file)
@@ -1219,16 +1219,18 @@ An "Ogg Opus file" consists of one or more sequentially multiplexed segments,
 The RECOMMENDED mime-type for Ogg Opus files is "audio/ogg".
 </t>
 
-<t>
+<figure>
+<preamble>
 If more specificity is desired, one MAY indicate the presence of Opus streams
  using the codecs parameter defined in <xref target="RFC6381"/>, e.g.,
-<figure align="center">
-<artwork align="left"><![CDATA[
-audio/ogg; codecs=opus
+</preamble>
+<artwork align="center"><![CDATA[
+    audio/ogg; codecs=opus
 ]]></artwork>
-</figure>
+<postamble>
  for an Ogg Opus file.
-</t>
+</postamble>
+</figure>
 
 <t>
 The RECOMMENDED filename extension for Ogg Opus files is '.opus'.