Re: [Boost-docs] QuickBook for non boost project

Subject: Re: [Boost-docs] QuickBook for non boost project
From: John Maddock (john_at_[hidden])
Date: 2010-01-15 09:46:48

> I am new to boost QuickBook and consider using it for documentation of
> a non boost project. It looks very nice indeed, but I have come across
> a couple of problems :
>
> 1) Image and css paths seems to be hard to replace. For html I ended
> up just fixing the paths with a notfile call that replaces all the
> paths with the correct one, which works fine and is okey with me. But
> in pdf files problems arise, because it fails with trying to fetch my
> images from a url...how do I correct this ? I have the following set :
>
>    <xsl:param>boost.root=..
>    <xsl:param>boost.image.src=../images/myproject.png
>    <xsl:param>boost.image.alt="\"Myproject\""
>    <xsl:param>boost.image.w=162
>    <xsl:param>boost.image.h=46
>    <xsl:param>nav.layout=none

I think Daniel has mostly answered this, but:

* Grep through our stylesheet layer in tools/boostbook/xsl for xsl:params 
you can alter.
* Take a look at the Jamfile in libs/math/doc/sf_and_dist - this alters just 
about everything that can be altered complete with comments.
* The main xsl param reference for docbook is here: 
http://docbook.sourceforge.net/release/xsl/current/doc/

Otherwise please do come back to us with more specific questions... we 
really should write a guide on how to do this :-(

HTH, John.