Re: [docbook-apps] How to output html without TOC?

["Bob Stayton" <bobs@sagehill.net>]

Hi,
Looking at the output messages, it appears that you have an article whose id attribute 
value is "index".  When you set the stylesheet parameter 'use.id.as.filename' to 1, 
then that id is used for the filename.  That's where the first index.html comes from.

The second index.html is the default filename for the chunk that corresponds to the 
root element.  That just follows the long standing convention of naming the starting 
point for a directory of HTML files "index.html".  Unfortunately, the stylesheet does 
not check that the two names conflict, so one overwrites the other.  I would consider 
that a bug.  In the interim, as David suggests, you can use the 'root.filename' 
parameter to change the name of that file to something else to avoid the conflict with 
the article filename.

The root index.html file is used to contain the title page for the document root 
element, and the TOC if generate.toc specifies it.  So turning off the TOC for set and 
book would not turn off those chunk files.

There is no stylesheet parameter to suppress the book and set level chunks. There are 
a couple of methods that could be used to eliminate the output of those chunks, but 
the complication comes from the "Previous" link that would be generated in the files 
left behind.  The HTML file for the first article in a book would display a Prev link 
to the book level, which would not work if there is no book HTML file.  Customizing 
Next and Previous for exceptions like this has never been easy in DocBook XSL.

However, if your style is to turn off the standard navigational headers and footers 
(and eliminate the Next and Previous problem), then on Windows you can suppress the 
output by adding a dbhtml filename processing instruction set to "NUL".  On Windows, 
that is a special filename that disappears the output sent to it.  If you put this 
after the opening tag of book and set, then those chunks will not appear in the 
output.

<?dbhtml filename="NUL"?>

I'm not sure what other complications might arise from using this trick, though.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


----- Original Message ----- 
From: "David Cramer" <dcramer@motive.com>
To: "Tao Wang" <dancefire@gmail.com>; "Robert Fekete" <frobert@balabit.com>
Cc: <docbook-apps@lists.oasis-open.org>
Sent: Thursday, May 13, 2010 6:25 AM
Subject: RE: [docbook-apps] How to output html without TOC?


You might try setting root.filename to something other than index:
http://docbook.sourceforge.net/release/xsl/current/doc/html/root.filenam
e.html

I believe that controls the file name of the generated toc file. This
still isn't exactly what you want, which is no toc file and no "prev"
link in the header of the first non-toc file linking to the toc.

Now that you mention it, it's surprising that the file can't easily be
completely suppressed. Bob or someone will have to chime in.

David

> -----Original Message-----
> From: Tao Wang [mailto:dancefire@gmail.com]
> Sent: Thursday, May 13, 2010 1:34 AM
> To: Robert Fekete
> Cc: docbook-apps@lists.oasis-open.org
> Subject: Re: [docbook-apps] How to output html without TOC?
>
> I tried set 'nop' for my root element and others, and it
> doesn't stop generating 'index.html'.
>
> I set the param as
> ----------------------------------
> <xsl:param name="generate.toc">
> set nop
> set/book nop
> </xsl:param>
> ----------------------------------
>
> And the output is
> =========================
> Writing ../html/index.html for article(index) Writing
> ../html/books.html for article(books) Writing
> ../html/bugs.html for article(bugs) Writing
> ../html/commercial_support.html for
> article(commercial_support) Writing ../html/developers.html
> for article(developers) Writing ../html/documentation.html
> for article(documentation) Writing ../html/download.html for
> article(download) Writing ../html/extra.html for
> article(extra) Writing ../html/git.html for article(git)
> Writing ../html/license.html for article(license) Writing
> ../html/mailinglist.html for article(mailinglist) Writing
> ../html/news.html for article(news) Writing ../html/bk01.html
> for book Writing ../html/index.html for set =========================
>
> as you saw in the output, '../html/index.html' is generated
> twice, the first one is the one I want, and it overwrite by
> the second one, which is the TOC for set.
>
> If I set 'nop' to 'set', it doesn't stop generating the file,
> instead, it just generate an empty 'index.html' without TOC inside.
>
> I do not want to generate 'bk01.html' for <book> and
> 'index.html' for <set> above, how can I do that?
>
>
> On Thu, May 13, 2010 at 12:38 AM, Robert Fekete
> <frobert@balabit.com> wrote:
> > Hi,
> >
> > I think that you will need to customize the generate.toc
> template, and
> > possibly set nop for your root element:
> >
> > http://www.sagehill.net/docbookxsl/TOCcontrol.html
> >
> > Robert
> >
> > Tao Wang wrote:
> >
> >> Hi,
> >>
> >> I'm using docbook 4.5 (xhtml/trunk.xsl) to generate html
> files for a
> >> website. The problem is I don't want the Table of Content being
> >> output, especially as the file 'index.html'.
> >>
> >> I wrote a index file as an <article> in a <book>, which id is
> >> 'index', and it's supposed to be generated as
> 'index.html'. However,
> >> the default TOC will overwrite the 'index.html' file, so I
> cannot get
> >> my 'index.html'.
> >>
> >> And, actually, the TOC is meaning less for my usage, so I
> just want
> >> to turn the TOC off. How can I do that?
> >>
> >
> >
>
>
>
> --
> Regards
>
> Tao Wang
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail:
> docbook-apps-help@lists.oasis-open.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org