[Fedora Release Notes] #29: Remove whitespace trigger ugly PDF formatting

[fedora-badges]

#29: Remove whitespace trigger ugly PDF formatting
---------------------+------------------------------------------------------
 Reporter:  quaid    |       Owner:  quaid   
     Type:  task     |      Status:  new     
 Priority:  major    |   Milestone:  RC-ready
Component:  Content  |     Version:  10      
 Keywords:           |  
---------------------+------------------------------------------------------
 Just in case we cannot get this fixed in the PDF toolchain, we need to
 remove all the leading whitespace for tags that display CDATA or other
 content verbatim.

 This could be done as part of a general run of a tool such as docbook-lint
 or xmlformat.  Before doing that, we need to assess the risk of the tool
 chaining line numbers and causing translation stats to go fuzzy.

-- 
Ticket URL: <https://fedorahosted.org/release-notes/ticket/29>
Fedora Release Notes <https://fedorahosted.org/release-notes/>
Fedora Release Notes

[fedora-badges]

#29: Remove whitespace trigger ugly PDF formatting
----------------------+-----------------------------------------------------
  Reporter:  quaid    |       Owner:  quaid   
      Type:  task     |      Status:  new     
  Priority:  major    |   Milestone:  RC-ready
 Component:  Content  |     Version:  10      
Resolution:           |    Keywords:          
----------------------+-----------------------------------------------------
Comment (by pfrields):

 CDATA shouldn't generate any translation strings, so we're OK there.  I
 completely disagree with certain parties who think CDATA is a hack -- on
 the contrary, it's been part of the XML standard since day one.

 Are we back to this problem of flush-left content again?  That just seems
 like a stupid bug to me and I can't believe we as writers and editors
 still have to use this kind of manual workaround.  Argh!

-- 
Ticket URL: <https://fedorahosted.org/release-notes/ticket/29#comment:1>
Fedora Release Notes <https://fedorahosted.org/release-notes/>
Fedora Release Notes

[fedora-badges]

#29: Remove whitespace trigger ugly PDF formatting
----------------------+-----------------------------------------------------
  Reporter:  quaid    |       Owner:  quaid   
      Type:  task     |      Status:  new     
  Priority:  major    |   Milestone:  RC-ready
 Component:  Content  |     Version:  10      
Resolution:           |    Keywords:          
----------------------+-----------------------------------------------------
Comment (by pfrields):

 Ah, I think I recall that it was extra markup inside <screen> that made
 this occur.  This markup would be problematic:

 <screen>
   <computeroutput>too much spacing</computeroutput>
 </screen>

 This might work better:

 <screen><![CDATA[spacing OK but maybe not so syntactically
 correct]]></screen>

 Perhaps standardizing on this usage in the markup howto would help?

-- 
Ticket URL: <https://fedorahosted.org/release-notes/ticket/29#comment:2>
Fedora Release Notes <https://fedorahosted.org/release-notes/>
Fedora Release Notes

[fedora-badges]

#29: Remove whitespace trigger ugly PDF formatting
----------------------+-----------------------------------------------------
  Reporter:  quaid    |       Owner:  quaid   
      Type:  task     |      Status:  new     
  Priority:  major    |   Milestone:  RC-ready
 Component:  Content  |     Version:  10      
Resolution:           |    Keywords:          
----------------------+-----------------------------------------------------
Comment (by quaid):

 I'd rather munge our XML formatting than lose the contextual markup.

 Markup inside of <screen> is explicitly allowed.  If <screen> also
 explicitly displays all whitespace as-is, then our having the whitespace
 there is a formatting mistake.  Just because Emacs indents by default :)
 ...

-- 
Ticket URL: <https://fedorahosted.org/release-notes/ticket/29#comment:3>
Fedora Release Notes <https://fedorahosted.org/release-notes/>
Fedora Release Notes

#29: Remove whitespace trigger ugly PDF formatting

[Fedora Release Notes]

#29: Remove whitespace trigger ugly PDF formatting
----------------------+-----------------------------------------------------
  Reporter:  quaid    |       Owner:  quaid   
      Type:  task     |      Status:  closed  
  Priority:  major    |   Milestone:  RC-ready
 Component:  Content  |     Version:  10.0.0  
Resolution:  fixed    |    Keywords:          
----------------------+-----------------------------------------------------
Changes (by pfrields):

  * status:  new => closed
  * resolution:  => fixed

-- 
Ticket URL: <https://fedorahosted.org/release-notes/ticket/29#comment:4>
Fedora Release Notes <https://fedorahosted.org/release-notes/>
Fedora Release Notes