OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

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

Sure, and welcome to the GSOC2010 Webhelp project test team! ;-)
Your first task will be to test the installation instructions:
For step 3 "Download the package", you'll have to get the code from subversion. Use a subversion client to check out the following:
svn co https://docbook.svn.sourceforge.net/svnroot/docbook/branches/webhelp/xsl/webhelp 
Email Kasun and me with any questions.

From: gpevaco@aol.com [mailto:gpevaco@aol.com]
Sent: Wednesday, July 07, 2010 2:49 PM
To: David Cramer; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] TOC on every page of DocBook HTML Chunked output

Yes this is exactly what I am looking to do! Well the collapsable TOC and the Search menu there are extras above the scope of what I am looking for - but I am sure that would more than welcome if I could get that to happen.
It sure looks good, and I am sure Kasun put  a heck of a lot of effort into that.... and yes I looked at the source and it is exactly what I would like (no frames/iframes).... only thing I still haven't a clue how to do that. I have messed around with putting the toc in frames, and I really don't want that - nor do I like it.  
I can only guess it was extensive customizations, and nothing in the standard stylesheets. 
Is there anyway I can get a nudge in the direction of how I could go about generating something similar with my docbook XML?
It really is outstanding work!

-----Original Message-----
From: David Cramer <dcramer@motive.com>
To: gpevaco@aol.com; docbook-apps@lists.oasis-open.org
Sent: Wed, Jul 7, 2010 3:14 pm
Subject: 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.

From: gpevaco@aol.com [mailto:gpevaco@aol.com]
Sent: Wednesday, July 07, 2010 1:40 PM
To: docbook-apps@lists.oasis-open.org
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!

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]