This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: Manually Chunking with PIs
- From: Bob Stayton <bobs at caldera dot com>
- To: Janning Vygen <vygen at gmx dot de>, docbook-apps at lists dot oasis-open dot org
- Date: Tue, 03 Sep 2002 09:57:49 -0700
- Subject: Re: DOCBOOK-APPS: Manually Chunking with PIs
- References: <200209021418.g82EIJ600526@janning.planwerk6.local>
On Mon, Sep 02, 2002 at 04:18:18PM +0200, Janning Vygen wrote:
> Hi,
>
> after searching quite a bit i found the possibility to chunk docbook
> docs manually with maketoc.xsl and chunktoc.xsl and parse them into
> different subdirectories with <?dbhtml dir=..?> PIs (using
> docbook-xsl 1.53) now i have a few question after reading lots of
> stuff about docbook
>
> these questions all belong to the same topic so i post them in one
> message. i hope thats ok for you:
>
> 1. the toc file ist generated by maketoc.xsl
> but you always have to edit the toc file according to your needs.
>
> Wouldn't it be nice to have a processing instruction like
> <?dbhmtl chunk=0?> or <?dbhmtl chunk=1?>
> to place inside you xml and let maketoc.xsl generate a toc file
> respecting xsl parameters like chunk.section.depth and those PIs??
This is indeed an interesting suggestion. You should
file a Feature Request on the docbook SourceForge site.
> 2. Is there a doc about dbhtml attributes. I found "filename" and
> "dir". Are there more dbhtml attributes which can be used?
There are other dbhtml attributes, but mostly undocumented.
Those hidden gems are one of the reasons I decided to
write more XSL documentation. There are dbhtml instructions
for variablelist, table, qandaset, and line numbering.
So far I've only documented the ones for variablelist
(http://www.sagehill.net/xml/docbookxsl/HtmlOutput.html#VarListFormatting)
There are also some dbfo processing instructions for FO
output.
> 3. Directories cant be created by the XSLT Processor. Does anybody
> has written a stylesheet converting toc file to a shell script which
> creates all needed directories?
Do you mean it reads the 'dir' processing instructions
and generates a script to create them all?
I don't know of such a stylesheet, but
it sounds like a simple job.
--
Bob Stayton 400 Encinal Street
Publications Architect Santa Cruz, CA 95060
Technical Publications voice: (831) 427-7796
Caldera International, Inc. fax: (831) 429-1887
email: bobs@caldera.com