Re: [Boost-docs] building non-Boost documentation

Subject: Re: [Boost-docs] building non-Boost documentation
From: Cromwell Enage (sponage_at_[hidden])
Date: 2007-09-20 17:30:49


--- Frank Mori Hess wrote:
> On Tuesday 18 September 2007 17:52 pm, Cromwell
> Enage wrote:
> > > > * I wanted multiple pages.
> >
> > Which XSL parameter controls this option?
>
> I've never gotten a single page. The only way
> I am able to do that is to use html-single.xsl
> instead of html.xsl. For me, I get separate
> pages for each of the top-level <section>s in
> my <library>. Docbook does have a bunch of
> customizable chunking parameters though:

I thought it was chunk.section.depth, but setting it
to different values had no effect.

> > > > * I don't see my custom logo anywhere.
> >
> > I tried both "boost.image" and "boost.img" but
> > to no avail.
>
> There is a chapter.logo.img, but I'm guessing
> you're talking about the header image? I just
> overwrote images/header/background.png with my
> own image and deleted background-more.png. There
> doesn't appear to be a xsl parameter for it, as I
> found the path to background.png in
> style/html/header.css.

Sorry, I meant trying to replace boost.png with my own
logo. I've tried chapter.logo.img but also without
success.

> boostscript seems to be defined in
> boost_docs/doc/javascript/main.js ?

Mozilla Firefox's Error Console tells me otherwise. I
suspect that the inline scripts (defined within the
HTML <head> element) are taking precedence over the
external scripts (e.g. main.js), which IIRC is
web-standard behavior.

Here's my whole Jamfile, FWIW. Ellipses refer to
directories/filenames fully qualified by absolute
path.
=====================================================
import boostbook : boostbook ;
using quickbook ;

xml my_doc : my_doc.qbk ;

boostbook standalone
    :
        my_doc
    :
        <xsl:param>boost.root={...}
        <xsl:param>boost.img.src={...}
        <xsl:param>boost.img.alt="Alt Text"
        <xsl:param>boost.img.w=112
        <xsl:param>boost.img.h=71
        <xsl:param>navig.graphics=1
        <xsl:param>chunk.section.depth=3
        <xsl:param>use.id.as.filename=1
        <xsl:param>chunk.first.sections=1
        <xsl:param>toc.section.depth=2
        <xsl:param>toc.max.depth=2
        <xsl:param>generate.section.toc.level=3
        <xsl:param>google.search.box.show=false
    ;
=====================================================

                              Confoundedly yours,
                              Cromwell D. Enage

       
____________________________________________________________________________________
Looking for a deal? Find great prices on flights and hotels with Yahoo! FareChase.
http://farechase.yahoo.com/


This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:40 UTC