Bug 707106

Summary: Turning Mediaobjects into Figures
Product: Red Hat Enterprise MRG Reporter: Alison Young <alyoung>
Component: Messaging_Programming_ReferenceAssignee: Joshua Wulf <jwulf>
Status: CLOSED WONTFIX QA Contact: ecs-bugs
Severity: low Docs Contact:
Priority: low    
Version: 2.0CC: jskeoch, jwulf, lcarlon
Target Milestone: 2.2   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-08-27 02:54:33 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Alison Young 2011-05-24 05:16:50 UTC
Description of problem: 
diagrams with unclear differentiation between captions and the paragraph that follows.
  
Actual results:
the current XML looks something like this....

<mediaobject>
	<imageobject>
		<imagedata fileref="images/producer-consumer.png" format="PNG" scalefit="1" width="444" />
	</imageobject>
	<textobject>
		<phrase>The AMQP 0-10 Model</phrase>
	</textobject>
	<caption> <para>
		The AMQP 0-10 Model: Message producers write messages to 	exchanges, message consumers read messages from queues
	</para>
	</caption>
</mediaobject>

Expected results:
XML should look more like this.

<figure id="AMQP_0-10_Model">
	<title>The AMQP 0-10 Model</title>
	<mediaobject>
		<imageobject>
			<imagedata fileref="images/producer-consumer.png" format="PNG" scalefit="1" width="444" />
		</imageobject>
	<textobject>
		<phrase>The AMQP 0-10 Model: Message producers write messages to exchanges, message consumers read messages from queues</phrase>
	</textobject>
	</mediaobject>
</figure>

Additional info:

Existing <textobject> to become new <title> and existing <caption> to become <textobject>. Textobject contents aren't shown in docs when the image is so check that the content in them won't be missed/is covered in paragraphs around image.

Comment 1 Joshua Wulf 2012-08-13 10:03:46 UTC
All images in the new books use <figure>

Comment 3 Joshua Wulf 2012-08-27 02:54:33 UTC
Fixed in new books in 2.2, not fixing for 2.