RE: [docbook-apps] TOC on every page of DocBook HTML Chunked output

From
David Cramer <>
Date
2010-07-07T19:15:41+00:00
ID
Thread
RE: [docbook-apps] TOC on every page of DocBook HTML Chunked output
You mean something like this? http://www.thingbag.net/docbook/gsoc2010/doc/content/ch01.html

 

That happens to be a GSOC project that Kasun Gajasinghe is 
working on right now :-) (Note: I'm his gsoc mentor)

 

Each page in the webhelp is a single html page. The toc and 
search tabs are divs. There are some interesting problems Kasun had to 
address. For example, when you go from page to page using the Next button or 
crossreferences, you want the toc to preserve its state. So Kasun stores the 
state of the toc in a cookie and restores it when you get to the next page. 
Likewise with the search. If you did a search and click on a link in the 
results, you still want to see the same results on a new page. With all that 
going on, performance is an issue for large docs. We're using the Definitive 
Guide as our test case for that and have gotten things working pretty well 
considering the size of the document: http://www.thingbag.net/docbook/gsoc2010/defguideout/content/ch01.html

 

The code is in subversion on the webhelp branch if you want to 
play with it. 

 

Currently, Kasun is working on adding stemming and Chinese and 
Japanese support to the search. This is a very challenging portion of the 
project, so wish him luck! If anyone has expertise in the stemming or in 
tokenizing CJKV, we'd love to hear from you :-)

 

Btw., you may also be interested in the website customization, 
which is also a gsoc project and similarly uses a <div> to produce a table 
of contents. In the case of website, however, you're content is an instance of a 
customized version of the DocBook schema that is optimized for creating 
websites. 

 

David

  

  
  From:  [mailto:] 
  
Sent: Wednesday, July 07, 2010 1:40 PM
To: 
  
Subject: [docbook-apps] TOC on 
  every page of DocBook HTML Chunked output

  

  
Hello all: 

  
 

  
I saw a brief thread about this topic in the list 
  here, but I still don't understand how this can be easily accomplished. 
  

  

I am trying to get a persistent TOC to output on 
  every page of my Chunked DocBook HTML output. Preferably as a DIV 
  alongside a div of the relevant content.  

  
I guess it would be somewhat like the page header or 
  footer generated with the standard stylesheets when creating chunked HTML. 
  Only instead of being at the top or bottom of each page I am looking for it to 
  appear along the left side, like a navigation bar showing the contents 
  and of course linking to them. 

  
It seems to me like this is not a unique 
  request, and someone could be doing this without excessive 
  customization. 

  
Is there any way to accomplish this using the 
  standard docbook tools?? (stock stylesheets, xsltproc)

  
If so I would greatly appreciate a pointer in 
  the right direction - even if only to some further documentation.

  
I would really appreciate it! 

  
Thanks in advance!

  
 

  
/Gregorio