Next in thread → Next in month →

Re: [docbook-apps] Imageobject choices for ROLE.

From
<>
Date
2009-03-24T17:57:36+00:00
ID
Thread
Re: [docbook-apps] Imageobject choices for ROLE.
Thanks for clearing that up, Bob.

 

Now what I read make sense ;-)

 

Dean

 

In a message dated 3/24/2009 10:13:53 A.M. Pacific Daylight Time, 
 writes:

  
Hi Dean,

  
Out of the box, the role values that work are established by the 
  global param named 'stylesheet.result.type', which is set in each 
  stylesheet.  It is not set in the param.xsl file because it is an 
  internal param that is not to be set by the user.  

  
 

  
- In fo/docbook.xsl, $stylehsheet.result.type is set to 'fo', so an 
  imageobject with role="fo" is matched there.

  
 

  
- In html/docbook.xsl, the param is set to 'html'. Since chunk.xsl 
  imports that file, it gets that value too.

  
 

  
- In xhtml/docbook.xsl and xhtml_1-1/docbook.xsl, it is set to 'xhtml', 
  but the selection process will fall back to an imageobject with role="html" if 
  there isn't an imageobject with role='xhtml'.  

  
 

  
- All the other stylesheets inherit the param value that they 
  import.  Since htmlhelp imports html/docbook.xsl, it selects for 'html' 
  too.  Same with eclipse and javahelp.  The epub stylesheet imports 
  xhtml_1.1, it selects for 'xhtml' (with fallback to 'html').

  
 

  
You mentioned role values of 'HTML', 'XHTML', 'fo-xep', and 
  'fo-fop'.  None of those would be recognized (it is case sensitive), and 
  the selection process falls back to looking at image filename extensions to 
  find one that is acceptable for the given output.

  
 

  
But you can override any of these by setting the param 
  'preferred.mediaobject.role' in your customization layer to some value other 
  than blank.  That param is checked first.  My example with 'fo-xep' 
  set that param as an example of customizing the selection process.

  
 

  
Bob Stayton
Sagehill Enterprises


  
 

  
 

  
    
----- Original Message ----- 

    
From: 
     

    
To:  
    

    
Sent: Monday, March 23, 2009 2:14 
    PM

    
Subject: [docbook-apps] Imageobject 
    choices for ROLE.

    

    
Hello Docbookers,

    
 

    
I have been moving some of my <graphic>'s over to 
    <mediaobject>'s.  This is mainly to support SVG for FOP and PNG 
    for HTML & XHTML. However, I was a bit baffled on the choice to use for 
    MSHELP outputs. Are the choices for "role" for imageobject only "fop, 
    HTML,XHTML, fo-xep, fo-fop"? 

    
 

    
Obviously "role" can be anything, but I am specifically asking about 
    the stock DocBook XSL processing when using these attributes. What is the 
    stylesheets capable of?

    
 

    
Thanks

    
Dean Nelson

    
 

    
PS: Most of the above info comes from Bob's book only, as I couldn't 
    find any info on this in the XSL reference doc or in the 
    TDG.

    
    A Good Credit Score is 700 or Above. See 
    yours in just 2 easy steps! 

 A Good Credit Score is 700 or Above.  See yours in just 2 easy steps!
Next in thread → Next in month →