From 0431f9335557b6af0167e0be21210dacf8e606d2 Mon Sep 17 00:00:00 2001
From: Ralph Giles <giles@mozilla.com>
Date: Wed, 16 Jan 2013 14:14:32 -0800
Subject: [PATCH] Improve Content Type figure placement.

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 | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/doc/draft-ietf-codec-oggopus.xml b/doc/draft-ietf-codec-oggopus.xml
index 7d55af908..8f55be142 100644
--- a/doc/draft-ietf-codec-oggopus.xml
+++ b/doc/draft-ietf-codec-oggopus.xml
@@ -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'.
-- 
GitLab