Mailing-List: contact dev-help@forrest.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@forrest.apache.org
Received-SPF: pass (asf.osuosl.org: local policy)
Subject: Re: docbook documentation splittet in several chunk
From: Kevin <forrest@kegcl.demon.co.uk>
To: dev@forrest.apache.org
In-Reply-To: <4373C4D8.7010902@apache.org>
References: <87vez1i7ej.fsf@open-tk.de> <1131617640.8582.1.camel@localhost>
	 <87hdakiwjo.fsf@localhost.localdomain>  <4373C4D8.7010902@apache.org>
Content-Type: text/plain; charset=utf-8
Date: Thu, 10 Nov 2005 22:44:25 +0000
Message-Id: <1131662665.4063.26.camel@k2.flat5>
Mime-Version: 1.0
Content-Transfer-Encoding: quoted-printable

On Thu, 2005-11-10 at 22:08 +0000, Ross Gardler wrote:
> Fabian M=C3=BCller wrote:
> > Thorsten Scherler <thorsten@apache.org> writes:
> >=20
> >=20
> >>>Does anybody know how I can create splited html files from one
> >>>docbook source file? Thanx very much in advance.
> >>
> >>Please post the missing files to dev.
> >=20
> >=20
> > Thank you for your reply. I attached
> > /usr/share/apps/ksgmltools2/docbook/xsl/html/chunk.xsl and a shortened
> > version of tutorial.xml to this message.
>=20
> Since this XSL only includes other XSLs it doesn't really help much.

I have used this docbook chunk.xsl before. I don't think forrest could
do what Fabian wants out of the box. The chunk.xsl takes one big
wholedocument.xml and splits it into many sections and an index, eg.
ar01s02.html ar01s03.html ar01s04.html ar01s05.html index.html. These
documents contain their own per page navigation in a header and footer.=20
This navigation needs to be stripped and content converted to internal
xdoc format.

So in a forrest sitemap there is one wholedocument.xml request
delivering several responses? Then site.xml needs to reference the
generated files. I'm guessing an internal plugin along the lines of
IMSManifest is needed.

This my asumption of the requirement and a big hunch for the solution.=20

Kevin.

> However, if I remember corectly this XSL outputs HTML from a docbook=20
> source. If that is corect then you need to convert the output to our=20
> internal format of XDoc otherwise Forrest doesn't know what to do with it=
.
>=20
> We provide a stylesheet called html-to-document.xsl for this, so just=20
> add a transform after your transform using the above XSL.
>=20
> NOTE: HTML is not a very well structured document format (which is why=20
> we cannot use it internally), the html-to-document.xsl does a pretty=20
> good job of creating a structured document from HTML, but it has its=20
> limitations.
>=20
> Fortunately, docbook is a very well structured document format so you=20
> may find it works OK. Try it and see what you get. Let us know how you=20
> get on.
>=20
> Ross
>=20
>=20