[Boost-commit] svn:boost r40114 - sandbox/SOC/2007/visualization/libs/svg_plot/doc

From: pbristow_at_[hidden]
Date: 2007-10-17 06:37:29

Author: pbristow
Date: 2007-10-17 06:37:28 EDT (Wed, 17 Oct 2007)
New Revision: 40114
URL: http://svn.boost.org/trac/boost/changeset/40114

Log:
update to generate pdf as well as html
Text files modified: 
   sandbox/SOC/2007/visualization/libs/svg_plot/doc/Jamfile.v2 |    97 +++++++++++++++++++++++++++++++++------ 
   1 files changed, 82 insertions(+), 15 deletions(-)

Modified: sandbox/SOC/2007/visualization/libs/svg_plot/doc/Jamfile.v2
==============================================================================
--- sandbox/SOC/2007/visualization/libs/svg_plot/doc/Jamfile.v2	(original)
+++ sandbox/SOC/2007/visualization/libs/svg_plot/doc/Jamfile.v2	2007-10-17 06:37:28 EDT (Wed, 17 Oct 2007)
@@ -1,20 +1,87 @@
-#   Copyright (c) 2002 Douglas Gregor <doug.gregor -at- gmail.com>
+#   Copyright Paul A. Bristow 2007
+#   Copyright Jake Voytko 2007
   
 #   Distributed under the Boost Software License, Version 1.0.
-#   (See accompanying file LICENSE_1_0.txt or copy at
-#   http://www.boost.org/LICENSE_1_0.txt)
+#   (See accompanying file LICENSE_1_0.txt
+#   or copy at http://www.boost.org/LICENSE_1_0.txt)
 
-project boost/doc ;
-import boostbook : boostbook ;
+# SVG plot documentation as html and pdf from Quickbook.
 
-boostbook function-doc : svg_plot.xml 
- : <xsl:param>project.root=http://beta.boost.org/development
-   <xsl:param>annotation.support=1
-   <xsl:param>quickbook.source.style.show="'true'"
-   <xsl:param>chunk.first.sections=2
-   <xsl:param>chunk.section.depth=10
-   <xsl:param>toc.section.depth=3
-   <xsl:param>toc.max.depth=3
-   <xsl:param>generate.section.toc.level=4
- ;
+# project boost/doc ;
+# import boostbook : boostbook ;
+
+using quickbook ;
+
+path-constant images_location : html ;
+# location of SVG images referenced by Quickbook.
+
+xml svg_plot
+  :
+    svg_plot.qbk
+  :
+;
+
+boostbook standalone 
+  :  
+    svg_plot
+  :
+ 
+	# Path for links to Boost:
+	<xsl:param>boost.root=../../../../../../../../trunk
+	# Path for libraries index:
+	<xsl:param>boost.libraries=$(boost-root)/libs/libraries.htm
+	# Use the main Boost stylesheet:
+	<xsl:param>html.stylesheet=../../../../../../../../trunk/doc/html/boostbook.css
+	# Use the svg_plot local Boost stylesheet:
+	# <xsl:param>html.stylesheet=./html/boostbook.css
+
+	# Some general style settings:
+	<xsl:param>table.footnote.number.format=1
+	<xsl:param>footnote.number.format=1
+        
+	# HTML options first:
+	# Use graphics not text for navigation:
+	<xsl:param>navig.graphics=1
+	# How far down we chunk nested sections, basically all of them:
+	<xsl:param>chunk.section.depth=10
+	# Don't put the first section on the same page as the TOC:
+	<xsl:param>chunk.first.sections=1
+	# How far down sections get TOC's
+	<xsl:param>toc.section.depth=10
+	# Max depth in each TOC:
+	<xsl:param>toc.max.depth=4
+	# How far down we go with TOC's
+	<xsl:param>generate.section.toc.level=10
+	#<xsl:param>root.filename="sf_dist_and_tools"
+        
+  # <xsl:param>project.root=http://beta.boost.org/development
+  # <xsl:param>annotation.support=1
+  # <xsl:param>quickbook.source.style.show="'true'"
+  
+	# PDF Options:
+	# TOC Generation: this is needed for FOP-0.9 and later:
+	# <xsl:param>fop1.extensions=1
+	<format>pdf:<xsl:param>xep.extensions=1
+	# TOC generation: this is needed for FOP 0.2, but must not be set to zero for FOP-0.9!
+	<format>pdf:<xsl:param>fop.extensions=0
+	# No indent on body text:
+	<format>pdf:<xsl:param>body.start.indent=0pt
+	# Margin size:
+	<format>pdf:<xsl:param>page.margin.inner=0.5in
+	# Margin size:
+	<format>pdf:<xsl:param>page.margin.outer=0.5in
+	# Paper type = A4
+	<format>pdf:<xsl:param>paper.type=A4
+	# Yes, we want graphics for admonishments:
+	<xsl:param>admon.graphics=1
+	# Set this one for PDF generation *only*:
+	# default pnd graphics are awful in PDF form,
+	# better use SVG's instead:
+	<format>pdf:<xsl:param>admon.graphics.extension=".svg"
+	<format>pdf:<xsl:param>use.role.for.mediaobject=1 
+	<format>pdf:<xsl:param>preferred.mediaobject.role=print
+	<format>pdf:<xsl:param>img.src.path=$(images_location)/
+	<format>pdf:<xsl:param>admon.graphics.path=$(images_location)/images/
+	<format>pdf:<xsl:param>draft.mode="no"
+	;