Bug 689303

Summary: Admonitions with remarked out titles cause rendering issue.
Product: [Community] Publican Reporter: Stephen Gordon <sgordon>
Component: publicanAssignee: Jeff Fearn <jfearn>
Status: CLOSED WONTFIX QA Contact: Ruediger Landmann <rlandman>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 2.5CC: mmcallis, publican-list
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-04-18 02:14:25 EDT Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Attachments:
Description Flags
Example book none

Description Stephen Gordon 2011-03-20 22:09:38 EDT
Created attachment 486530 [details]
Example book

Description of problem:

When an admonition has a title set but that title is hidden by a remark tag the admonition title bar does not render correctly. If the hidden title had not been included at all a default title would have been used (for example Note) and thus this rendering issue would have been avoided.

Have tested in publican default and publican-redhat brands (see attached for example book).


Version-Release number of selected component (if applicable):

2.5

How reproducible:

Every time.

Steps to Reproduce:
1. Create an admonition with a title.
2. Add <remark> tags around the title (within the <title> tags)
3. Build the book.
4. View the admonition in both pdf and html views.
  
Actual results:

No admonition header bar is displayed, text and image alignment is off.

Expected results:

Default title, in my example book 'Note'.

Additional info:

The attached book contains an example of this behaviour in chapter 1 - have included both source and built output.
Comment 1 Stephen Gordon 2011-03-20 22:18:09 EDT
Happy to admit this is a nice to have at best, there was only one instance in the book I was working with so I just fixed the source...
Comment 2 Jeff Fearn 2011-04-18 02:14:25 EDT
It's impossible for us to know if the title being empty is deliberate or an accident. If you put the title in there then in addition to the remark add a real title.