Re: [Boost-docs] [quickbook] setting boost.root as an absolute URL

Subject: Re: [Boost-docs] [quickbook] setting boost.root as an absolute URL
From: Daniel James (dnljms_at_[hidden])
Date: 2016-10-15 12:59:59

On 15 October 2016 at 11:15, Joaquin M López Muñoz
<joaquinlopezmunoz_at_[hidden]> wrote:
>
> So, I changed the Jamfile to this (following what I found in Antony's code)
>
> boostbook standalone
>   : poly_collection
>   :
> <xsl:param>boost.root=http://www.boost.org/doc/libs/1_62_0
>   ;
>
> but, to my dismay, this fails to produce docs properly linking to absolute
> CSS and images in boost.org.
>
> Any clue? Thank you very much

It's set up to only use the main boost stylesheets when being built
inside the boost tree, outside of the tree the default is just
'boostbook.css'. To use the boost tree settings, I think you need to
do:

   boostbook standalone
      : poly_collection
      :
          <xsl:param>boost.root=http://www.boost.org/doc/libs/1_62_0
          <xsl:param>boost.defaults=Boost
      ;

Also, it might be better to set
'boost.root=http://www.boost.org/doc/libs/release' to always get the
latest version.

'boost.defaults' is normally set in the main boost tree's Jamroot, the
idea being that libraries built outside of the boost tree will want a
local copy of the stylesheets and images so that the documentation can
work offline, and won't want the home, libraries, etc. links at the
top of the page. This is what I use to get a copy the css files and
images:

    boostbook fully-standalone
        :
            doc-guide
        :
           <dependency>css
           <dependency>images
           <xsl:param>boost.root=http://www.boost.org
           <xsl:param>html.stylesheet=boostbook.css
           <xsl:param>img.src.path=images/
           <xsl:param>boost.graphics.root=images/
       ;
   explicit fully-standalone ;

   install css : [ glob $(BOOST_ROOT)/doc/src/*.css ]
       : <location>html ;
   install images : [ glob $(BOOST_ROOT)/doc/src/images/*.png ]
       : <location>html/images ;
   explicit css ;
   explicit images ;