Re: [boost] [quickbook] changing paths

Subject: Re: [boost] [quickbook] changing paths
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2011-10-21 12:36:01

> -----Original Message-----
> From: boost-bounces_at_[hidden] [mailto:boost-bounces_at_[hidden]] On Behalf Of lcaminiti
> Sent: Friday, October 21, 2011 4:57 PM
> To: boost_at_[hidden]
> Subject: [boost] [quickbook] changing paths
> 
> Hello all,
> 
> How can I change the paths were Boost.QuickBook looks for the following files?

path-constant nav_images : html/images/ ; # png and svg images for home, next, note, tip...

path-constant images_location : html ; # location of SVG and PNG images referenced by Quickbook.

and may find helpful to show these

echo "images_location" $(images_location) ; 
echo "nav_images" $(nav_images) ;

  # Links are relative and trying to make absolute does NOT work.
  # And remember that all links MUST use  backslash / , not forward \ - that is the trip char!
 # Using enclosing quotes is safest. 
 # Trailing / may be needed for folder names.

  # Grep through our stylesheet layer in $(local-boost-root)/tools/boostbook/xsl for xsl:params you
can alter.
  #  main xsl param reference for docbook http://docbook.sourceforge.net/release/xsl/current/doc/

> 1) CSS and icon images by default from BOOST_ROOT/doc.

In jamfile,

boostbook standalone
:
your library
:

  <xsl:param>boost.root=.  # Your choice
  <xsl:param>html.stylesheet=../../doc/html/boostbook.css    # or your choice

> 2) Navigation bar by default from BOOST_ROOT/tools/boostbook/xls.

  #<xsl:param>nav.layout=none # No navigation bar (home, prev, next).
  # defining creates a runtime error: Global parameter nav.layout already defined.
  <xsl:param>nav.layout=horizontal # to get a horizontal navigation bar (you probably DO want this).

  <xsl:param>boost.image=Boost # options are: none (no logo), Boost (for boost.png), or your own
logo like inspired_by_boost.png
  <xsl:param>boost.image.src=./images/yourlogo.png # Instead of boost, or proposed_for_boost?
  <xsl:param>boost.image.w=180 # Width of logo in pixels. (JM has W = 162, h = 46)
  <xsl:param>boost.image.h=90 # Height of logo in pixels.

HTH

Paul