Re: [docbook-apps] markup for custom PDF bookmarks in Docbook 5



Hi Cynthia,

There is no specific markup in DocBook for PDF 
bookmarks, because they are a formatting artifact of the structure elements of 
the document.  The DocBook stylesheet adds a bookmark for each structural 
element contained in the document.

 

Since bookmarks are a formatting feature, they are 
subject to customization of the stylesheets.  Because bookmarks were not 
initially part of the XSL-FO 1.0 specification, each XSL-FO processor created 
their own extension to handle them.  The extensions for FOP 0.95 are in 
fo/fop1.xsl.  You can see in those templates how the bookmarks are created 
by processing the document in mode="fop1.outline", which generates 
a fo:bookmark element for each structural element.  You could 
customize the templates to add your additional links.

 

But I'm curious about these links.  
For example, when someone 
clicks on Search (all docs), what is supposed to happen?  They look 
like they might be external links, perhaps to a website? In that case, 
you would need to use <fo:bookmark 
external-destination="url(http://blah)"> (instead of 
internal-destination).

 

Bob Stayton
Sagehill Enterprises


 

 

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

  
From: 
  Cynthia 
  S 

  
To:  
  

  
Sent: Thursday, April 02, 2009 11:39 
  PM

  
Subject: [docbook-apps] markup for custom 
  PDF bookmarks in Docbook 5

  

  
    
    

      
        
Creating 
        individual PDF files from Docbook 5 XML files is, for the most part, 
        relatively straightforward (using FOP/Oxygen). What is not 
        straightforward is how to mark up custom PDF bookmarks in Docbook 5, 
        that is, in addition to the ones that are automatically 
        generated.
        

        
 
        

        
For example, 
        what we would like to have in the bookmark field:
        

        
 
        

        
Menu
        

        
Search (all 
        docs)
        

        
Find (single 
        doc)
        

        
Doc1
        

        
Doc2
        

        
Doc3
        

        
Etc.
        

        
News & 
        Changes
        

        
 
        

        
I’ve tried 
        searching for this information, but have not found anything other than 
        other people asking similar questions but not getting a useful 
        answer.
        

        
 
        

        
Cheers,
        

        
Cynthia
        

  
  

  
    
    

      Alt i ett. Få Yahoo! Mail med 
        adressekartotek, kalender og 
notisblokk.