mirror of
https://github.com/moses-smt/mosesdecoder.git
synced 2025-01-02 17:09:36 +03:00
731 lines
22 KiB
Plaintext
731 lines
22 KiB
Plaintext
# Copyright 2003, 2004, 2005 Dave Abrahams
|
|
# Copyright 2003, 2004, 2005 Douglas Gregor
|
|
# Copyright 2005, 2006, 2007 Rene Rivera
|
|
# Copyright 2003, 2004, 2005 Vladimir Prus
|
|
# Distributed under the Boost Software License, Version 1.0.
|
|
# (See accompanying file LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txt)
|
|
|
|
# This module defines rules to handle generation of documentation
|
|
# from BoostBook sources.
|
|
#
|
|
# The type of output is controlled by the <format> feature which can
|
|
# have the following values::
|
|
#
|
|
# * html: Generates html documention. This is the default.
|
|
# * xhtml: Generates xhtml documentation
|
|
# * htmlhelp: Generates html help output.
|
|
# * onehtml: Generates a single html page.
|
|
# * man: Generates man pages.
|
|
# * pdf: Generates pdf documentation.
|
|
# * ps: Generates postscript output.
|
|
# * docbook: Generates docbook XML.
|
|
# * fo: Generates XSL formating objects.
|
|
# * tests: Extracts test cases from the boostbook XML.
|
|
#
|
|
# format is an implicit feature, so typing pdf on the command
|
|
# line (for example) is a short-cut for format=pdf.
|
|
|
|
import "class" : new ;
|
|
import common ;
|
|
import errors ;
|
|
import targets ;
|
|
import feature ;
|
|
import generators ;
|
|
import print ;
|
|
import property ;
|
|
import project ;
|
|
import property-set ;
|
|
import regex ;
|
|
import scanner ;
|
|
import sequence ;
|
|
import make ;
|
|
import os ;
|
|
import type ;
|
|
import modules path project ;
|
|
import build-system ;
|
|
|
|
import xsltproc : xslt xslt-dir ;
|
|
|
|
# Make this module into a project.
|
|
project.initialize $(__name__) ;
|
|
project boostbook ;
|
|
|
|
|
|
feature.feature format : html xhtml htmlhelp onehtml man pdf ps docbook fo tests
|
|
: incidental implicit composite propagated ;
|
|
|
|
type.register DTDXML : dtdxml ;
|
|
type.register XML : xml ;
|
|
type.register BOOSTBOOK : boostbook : XML ;
|
|
type.register DOCBOOK : docbook : XML ;
|
|
type.register FO : fo : XML ;
|
|
type.register PDF : pdf ;
|
|
type.register PS : ps ;
|
|
type.register XSLT : xsl : XML ;
|
|
type.register HTMLDIR ;
|
|
type.register XHTMLDIR ;
|
|
type.register HTMLHELP ;
|
|
type.register MANPAGES ;
|
|
type.register TESTS : tests ;
|
|
# Artificial target type, used to require invocation of top-level
|
|
# BoostBook generator.
|
|
type.register BOOSTBOOK_MAIN ;
|
|
|
|
|
|
# Initialize BoostBook support.
|
|
rule init (
|
|
docbook-xsl-dir ? # The DocBook XSL stylesheet directory. If not
|
|
# provided, we use DOCBOOK_XSL_DIR from the environment
|
|
# (if available) or look in standard locations.
|
|
# Otherwise, we let the XML processor load the
|
|
# stylesheets remotely.
|
|
|
|
: docbook-dtd-dir ? # The DocBook DTD directory. If not provided, we use
|
|
# DOCBOOK_DTD_DIR From the environment (if available) or
|
|
# look in standard locations. Otherwise, we let the XML
|
|
# processor load the DTD remotely.
|
|
|
|
: boostbook-dir ? # The BoostBook directory with the DTD and XSL subdirs.
|
|
)
|
|
{
|
|
|
|
if ! $(.initialized)
|
|
{
|
|
.initialized = true ;
|
|
|
|
check-boostbook-dir $(boostbook-dir) ;
|
|
find-tools $(docbook-xsl-dir) : $(docbook-dtd-dir) : $(boostbook-dir) ;
|
|
|
|
# Register generators only if we've were called via "using boostbook ; "
|
|
generators.register-standard boostbook.dtdxml-to-boostbook : DTDXML : XML ;
|
|
generators.register-standard boostbook.boostbook-to-docbook : XML : DOCBOOK ;
|
|
generators.register-standard boostbook.boostbook-to-tests : XML : TESTS ;
|
|
generators.register-standard boostbook.docbook-to-onehtml : DOCBOOK : HTML ;
|
|
generators.register-standard boostbook.docbook-to-htmldir : DOCBOOK : HTMLDIR ;
|
|
generators.register-standard boostbook.docbook-to-xhtmldir : DOCBOOK : XHTMLDIR ;
|
|
generators.register-standard boostbook.docbook-to-htmlhelp : DOCBOOK : HTMLHELP ;
|
|
generators.register-standard boostbook.docbook-to-manpages : DOCBOOK : MANPAGES ;
|
|
generators.register-standard boostbook.docbook-to-fo : DOCBOOK : FO ;
|
|
|
|
# The same about Jamfile main target rules.
|
|
IMPORT $(__name__) : boostbook : : boostbook ;
|
|
}
|
|
else
|
|
{
|
|
if $(docbook-xsl-dir)
|
|
{
|
|
modify-config ;
|
|
.docbook-xsl-dir = [ path.make $(docbook-xsl-dir) ] ;
|
|
check-docbook-xsl-dir ;
|
|
}
|
|
if $(docbook-dtd-dir)
|
|
{
|
|
modify-config ;
|
|
.docbook-dtd-dir = [ path.make $(docbook-dtd-dir) ] ;
|
|
check-docbook-dtd-dir ;
|
|
}
|
|
if $(boostbook-dir)
|
|
{
|
|
modify-config ;
|
|
check-boostbook-dir $(boostbook-dir) ;
|
|
local boostbook-xsl-dir = [ path.glob $(boostbook-dir) : xsl ] ;
|
|
local boostbook-dtd-dir = [ path.glob $(boostbook-dir) : dtd ] ;
|
|
.boostbook-xsl-dir = $(boostbook-xsl-dir[1]) ;
|
|
.boostbook-dtd-dir = $(boostbook-dtd-dir[1]) ;
|
|
check-boostbook-xsl-dir ;
|
|
check-boostbook-dtd-dir ;
|
|
}
|
|
}
|
|
}
|
|
|
|
rule lock-config ( )
|
|
{
|
|
if ! $(.initialized)
|
|
{
|
|
errors.user-error "BoostBook has not been configured." ;
|
|
}
|
|
if ! $(.config-locked)
|
|
{
|
|
.config-locked = true ;
|
|
}
|
|
}
|
|
|
|
rule modify-config ( )
|
|
{
|
|
if $(.config-locked)
|
|
{
|
|
errors.user-error "BoostBook configuration cannot be changed after it has been used." ;
|
|
}
|
|
}
|
|
|
|
rule find-boost-in-registry ( keys * )
|
|
{
|
|
local boost-root = ;
|
|
for local R in $(keys)
|
|
{
|
|
local installed-boost = [ W32_GETREG
|
|
"HKEY_LOCAL_MACHINE\\SOFTWARE\\$(R)"
|
|
: "InstallRoot" ] ;
|
|
if $(installed-boost)
|
|
{
|
|
boost-root += [ path.make $(installed-boost) ] ;
|
|
}
|
|
}
|
|
return $(boost-root) ;
|
|
}
|
|
|
|
rule check-docbook-xsl-dir ( )
|
|
{
|
|
if $(.docbook-xsl-dir)
|
|
{
|
|
if ! [ path.glob $(.docbook-xsl-dir) : common/common.xsl ]
|
|
{
|
|
errors.user-error "BoostBook: could not find docbook XSL stylesheets in:" [ path.native $(.docbook-xsl-dir) ] ;
|
|
}
|
|
else
|
|
{
|
|
if --debug-configuration in [ modules.peek : ARGV ]
|
|
{
|
|
ECHO "notice: BoostBook: found docbook XSL stylesheets in:" [ path.native $(.docbook-xsl-dir) ] ;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
rule check-docbook-dtd-dir ( )
|
|
{
|
|
if $(.docbook-dtd-dir)
|
|
{
|
|
if ! [ path.glob $(.docbook-dtd-dir) : docbookx.dtd ]
|
|
{
|
|
errors.user-error "error: BoostBook: could not find docbook DTD in:" [ path.native $(.docbook-dtd-dir) ] ;
|
|
}
|
|
else
|
|
{
|
|
if --debug-configuration in [ modules.peek : ARGV ]
|
|
{
|
|
ECHO "notice: BoostBook: found docbook DTD in:" [ path.native $(.docbook-dtd-dir) ] ;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
rule check-boostbook-xsl-dir ( )
|
|
{
|
|
if ! $(.boostbook-xsl-dir)
|
|
{
|
|
errors.user-error "error: BoostBook: could not find boostbook XSL stylesheets." ;
|
|
}
|
|
else if ! [ path.glob $(.boostbook-xsl-dir) : docbook.xsl ]
|
|
{
|
|
errors.user-error "error: BoostBook: could not find docbook XSL stylesheets in:" [ path.native $(.boostbook-xsl-dir) ] ;
|
|
}
|
|
else
|
|
{
|
|
if --debug-configuration in [ modules.peek : ARGV ]
|
|
{
|
|
ECHO "notice: BoostBook: found boostbook XSL stylesheets in:" [ path.native $(.boostbook-xsl-dir) ] ;
|
|
}
|
|
}
|
|
}
|
|
|
|
rule check-boostbook-dtd-dir ( )
|
|
{
|
|
if ! $(.boostbook-dtd-dir)
|
|
{
|
|
errors.user-error "error: BoostBook: could not find boostbook DTD." ;
|
|
}
|
|
else if ! [ path.glob $(.boostbook-dtd-dir) : boostbook.dtd ]
|
|
{
|
|
errors.user-error "error: BoostBook: could not find boostbook DTD in:" [ path.native $(.boostbook-dtd-dir) ] ;
|
|
}
|
|
else
|
|
{
|
|
if --debug-configuration in [ modules.peek : ARGV ]
|
|
{
|
|
ECHO "notice: BoostBook: found boostbook DTD in:" [ path.native $(.boostbook-dtd-dir) ] ;
|
|
}
|
|
}
|
|
}
|
|
|
|
rule check-boostbook-dir ( boostbook-dir ? )
|
|
{
|
|
if $(boostbook-dir) && ! [ path.glob $(boostbook-dir) : xsl ]
|
|
{
|
|
errors.user-error "error: BoostBook: could not find boostbook in:" [ path.native $(boostbook-dir) ] ;
|
|
}
|
|
}
|
|
|
|
rule find-tools ( docbook-xsl-dir ? : docbook-dtd-dir ? : boostbook-dir ? )
|
|
{
|
|
docbook-xsl-dir ?= [ modules.peek : DOCBOOK_XSL_DIR ] ;
|
|
docbook-dtd-dir ?= [ modules.peek : DOCBOOK_DTD_DIR ] ;
|
|
boostbook-dir ?= [ modules.peek : BOOSTBOOK_DIR ] ;
|
|
|
|
# Look for the boostbook stylesheets relative to BOOST_ROOT
|
|
# and Boost.Build.
|
|
local boost-build-root = [ path.make [ build-system.location ] ] ;
|
|
local boostbook-search-dirs = [ path.join $(boost-build-root) .. .. ] ;
|
|
|
|
local boost-root = [ modules.peek : BOOST_ROOT ] ;
|
|
if $(boost-root)
|
|
{
|
|
boostbook-search-dirs += [ path.join [ path.make $(boost-root) ] tools ] ;
|
|
}
|
|
boostbook-dir ?= [ path.glob $(boostbook-search-dirs) : boostbook* ] ;
|
|
|
|
# Try to find the tools in platform specific locations
|
|
if [ os.name ] = NT
|
|
{
|
|
# If installed by the Boost installer.
|
|
local boost-root = ;
|
|
|
|
local boost-installer-versions = snapshot cvs 1.33.0 ;
|
|
local boost-consulting-installer-versions = 1.33.1 1.34.0 1.34.1 ;
|
|
local boostpro-installer-versions =
|
|
1.35.0 1.36.0 1.37.0 1.38.0 1.39.0 1.40.0 1.41.0 1.42.0
|
|
1.43.0 1.44.0 1.45.0 1.46.0 1.47.0 1.48.0 1.49.0 1.50.0 ;
|
|
|
|
local old-installer-root = [ find-boost-in-registry Boost.org\\$(boost-installer-versions) ] ;
|
|
|
|
# Make sure that the most recent version is searched for first
|
|
boost-root += [ sequence.reverse
|
|
[ find-boost-in-registry
|
|
Boost-Consulting.com\\$(boost-consulting-installer-versions)
|
|
boostpro.com\\$(boostpro-installer-versions) ] ] ;
|
|
|
|
# Plausible locations.
|
|
local root = [ PWD ] ;
|
|
while $(root) != $(root:D) { root = $(root:D) ; }
|
|
root = [ path.make $(root) ] ;
|
|
local search-dirs = ;
|
|
local docbook-search-dirs = ;
|
|
for local p in $(boost-root) {
|
|
search-dirs += [ path.join $(p) tools ] ;
|
|
}
|
|
for local p in $(old-installer-root)
|
|
{
|
|
search-dirs += [ path.join $(p) share ] ;
|
|
docbook-search-dirs += [ path.join $(p) share ] ;
|
|
}
|
|
search-dirs += [ path.join $(root) Boost tools ] ;
|
|
search-dirs += [ path.join $(root) Boost share ] ;
|
|
docbook-search-dirs += [ path.join $(root) Boost share ] ;
|
|
|
|
docbook-xsl-dir ?= [ path.glob $(docbook-search-dirs) : docbook-xsl* ] ;
|
|
docbook-dtd-dir ?= [ path.glob $(docbook-search-dirs) : docbook-xml* ] ;
|
|
boostbook-dir ?= [ path.glob $(search-dirs) : boostbook* ] ;
|
|
}
|
|
else
|
|
{
|
|
# Plausible locations.
|
|
|
|
local share = /usr/local/share /usr/share /opt/share /opt/local/share ;
|
|
local dtd-versions = 4.2 ;
|
|
|
|
docbook-xsl-dir ?= [ path.glob $(share) : docbook-xsl* ] ;
|
|
docbook-xsl-dir ?= [ path.glob $(share)/sgml/docbook : xsl-stylesheets ] ;
|
|
docbook-xsl-dir ?= [ path.glob $(share)/xsl : docbook* ] ;
|
|
|
|
docbook-dtd-dir ?= [ path.glob $(share) : docbook-xml* ] ;
|
|
docbook-dtd-dir ?= [ path.glob $(share)/sgml/docbook : xml-dtd-$(dtd-versions)* ] ;
|
|
docbook-dtd-dir ?= [ path.glob $(share)/xml/docbook : $(dtd-versions) ] ;
|
|
|
|
boostbook-dir ?= [ path.glob $(share) : boostbook* ] ;
|
|
|
|
# Ubuntu Linux
|
|
docbook-xsl-dir ?= [ path.glob /usr/share/xml/docbook/stylesheet : nwalsh ] ;
|
|
docbook-dtd-dir ?= [ path.glob /usr/share/xml/docbook/schema/dtd : $(dtd-versions) ] ;
|
|
|
|
# SUSE
|
|
docbook-xsl-dir ?= [ path.glob /usr/share/xml/docbook/stylesheet/nwalsh : current ] ;
|
|
}
|
|
|
|
if $(docbook-xsl-dir)
|
|
{
|
|
.docbook-xsl-dir = [ path.make $(docbook-xsl-dir[1]) ] ;
|
|
}
|
|
if $(docbook-dtd-dir)
|
|
{
|
|
.docbook-dtd-dir = [ path.make $(docbook-dtd-dir[1]) ] ;
|
|
}
|
|
|
|
if --debug-configuration in [ modules.peek : ARGV ]
|
|
{
|
|
ECHO "notice: Boost.Book: searching XSL/DTD in" ;
|
|
ECHO "notice:" [ sequence.transform path.native : $(boostbook-dir) ] ;
|
|
}
|
|
local boostbook-xsl-dir ;
|
|
for local dir in $(boostbook-dir) {
|
|
boostbook-xsl-dir += [ path.glob $(dir) : xsl ] ;
|
|
}
|
|
local boostbook-dtd-dir ;
|
|
for local dir in $(boostbook-dir) {
|
|
boostbook-dtd-dir += [ path.glob $(dir) : dtd ] ;
|
|
}
|
|
.boostbook-xsl-dir = $(boostbook-xsl-dir[1]) ;
|
|
.boostbook-dtd-dir = $(boostbook-dtd-dir[1]) ;
|
|
|
|
check-docbook-xsl-dir ;
|
|
check-docbook-dtd-dir ;
|
|
check-boostbook-xsl-dir ;
|
|
check-boostbook-dtd-dir ;
|
|
}
|
|
|
|
rule xsl-dir
|
|
{
|
|
lock-config ;
|
|
return $(.boostbook-xsl-dir) ;
|
|
}
|
|
|
|
rule dtd-dir
|
|
{
|
|
lock-config ;
|
|
return $(.boostbook-dtd-dir) ;
|
|
}
|
|
|
|
rule docbook-xsl-dir
|
|
{
|
|
lock-config ;
|
|
return $(.docbook-xsl-dir) ;
|
|
}
|
|
|
|
rule docbook-dtd-dir
|
|
{
|
|
lock-config ;
|
|
return $(.docbook-dtd-dir) ;
|
|
}
|
|
|
|
rule dtdxml-to-boostbook ( target : source : properties * )
|
|
{
|
|
lock-config ;
|
|
xslt $(target) : $(source) "$(.boostbook-xsl-dir)/dtd/dtd2boostbook.xsl"
|
|
: $(properties) ;
|
|
}
|
|
|
|
rule boostbook-to-docbook ( target : source : properties * )
|
|
{
|
|
lock-config ;
|
|
local stylesheet = [ path.native $(.boostbook-xsl-dir)/docbook.xsl ] ;
|
|
xslt $(target) : $(source) $(stylesheet) : $(properties) ;
|
|
}
|
|
|
|
rule docbook-to-onehtml ( target : source : properties * )
|
|
{
|
|
lock-config ;
|
|
local stylesheet = [ path.native $(.boostbook-xsl-dir)/html-single.xsl ] ;
|
|
xslt $(target) : $(source) $(stylesheet) : $(properties) ;
|
|
}
|
|
|
|
rule docbook-to-htmldir ( target : source : properties * )
|
|
{
|
|
lock-config ;
|
|
local stylesheet = [ path.native $(.boostbook-xsl-dir)/html.xsl ] ;
|
|
xslt-dir $(target) : $(source) $(stylesheet) : $(properties) : html ;
|
|
}
|
|
|
|
rule docbook-to-xhtmldir ( target : source : properties * )
|
|
{
|
|
lock-config ;
|
|
local stylesheet = [ path.native $(.boostbook-xsl-dir)/xhtml.xsl ] ;
|
|
xslt-dir $(target) : $(source) $(stylesheet) : $(properties) : xhtml ;
|
|
}
|
|
|
|
rule docbook-to-htmlhelp ( target : source : properties * )
|
|
{
|
|
lock-config ;
|
|
local stylesheet = [ path.native $(.boostbook-xsl-dir)/html-help.xsl ] ;
|
|
xslt-dir $(target) : $(source) $(stylesheet) : $(properties) : htmlhelp ;
|
|
}
|
|
|
|
rule docbook-to-manpages ( target : source : properties * )
|
|
{
|
|
lock-config ;
|
|
local stylesheet = [ path.native $(.boostbook-xsl-dir)/manpages.xsl ] ;
|
|
xslt-dir $(target) : $(source) $(stylesheet) : $(properties) : man ;
|
|
}
|
|
|
|
rule docbook-to-fo ( target : source : properties * )
|
|
{
|
|
lock-config ;
|
|
local stylesheet = [ path.native $(.boostbook-xsl-dir)/fo.xsl ] ;
|
|
xslt $(target) : $(source) $(stylesheet) : $(properties) ;
|
|
}
|
|
|
|
rule format-catalog-path ( path )
|
|
{
|
|
local result = $(path) ;
|
|
if [ xsltproc.is-cygwin ]
|
|
{
|
|
if [ os.name ] = NT
|
|
{
|
|
drive = [ MATCH ^/(.):(.*)$ : $(path) ] ;
|
|
result = /cygdrive/$(drive[1])$(drive[2]) ;
|
|
}
|
|
}
|
|
else
|
|
{
|
|
if [ os.name ] = CYGWIN
|
|
{
|
|
local native-path = [ path.native $(path) ] ;
|
|
result = [ path.make $(native-path:W) ] ;
|
|
}
|
|
}
|
|
return [ regex.replace $(result) " " "%20" ] ;
|
|
}
|
|
|
|
rule generate-xml-catalog ( target : sources * : properties * )
|
|
{
|
|
print.output $(target) ;
|
|
|
|
# BoostBook DTD catalog entry
|
|
local boostbook-dtd-dir = [ boostbook.dtd-dir ] ;
|
|
if $(boostbook-dtd-dir)
|
|
{
|
|
boostbook-dtd-dir = [ format-catalog-path $(boostbook-dtd-dir) ] ;
|
|
}
|
|
|
|
print.text
|
|
"<?xml version=\"1.0\"?>"
|
|
"<!DOCTYPE catalog "
|
|
" PUBLIC \"-//OASIS/DTD Entity Resolution XML Catalog V1.0//EN\""
|
|
" \"http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd\">"
|
|
"<catalog xmlns=\"urn:oasis:names:tc:entity:xmlns:xml:catalog\">"
|
|
" <rewriteURI uriStartString=\"http://www.boost.org/tools/boostbook/dtd/\" rewritePrefix=\"file://$(boostbook-dtd-dir)/\"/>"
|
|
: true ;
|
|
|
|
local docbook-xsl-dir = [ boostbook.docbook-xsl-dir ] ;
|
|
if ! $(docbook-xsl-dir)
|
|
{
|
|
ECHO "BoostBook warning: no DocBook XSL directory specified." ;
|
|
ECHO " If you have the DocBook XSL stylesheets installed, please " ;
|
|
ECHO " set DOCBOOK_XSL_DIR to the stylesheet directory on either " ;
|
|
ECHO " the command line (via -sDOCBOOK_XSL_DIR=...) or in a " ;
|
|
ECHO " Boost.Jam configuration file. The DocBook XSL stylesheets " ;
|
|
ECHO " are available here: http://docbook.sourceforge.net/ " ;
|
|
ECHO " Stylesheets will be downloaded on-the-fly (very slow!) " ;
|
|
}
|
|
else
|
|
{
|
|
docbook-xsl-dir = [ format-catalog-path $(docbook-xsl-dir) ] ;
|
|
print.text " <rewriteURI uriStartString=\"http://docbook.sourceforge.net/release/xsl/current/\" rewritePrefix=\"file://$(docbook-xsl-dir)/\"/>" ;
|
|
}
|
|
|
|
local docbook-dtd-dir = [ boostbook.docbook-dtd-dir ] ;
|
|
if ! $(docbook-dtd-dir)
|
|
{
|
|
ECHO "BoostBook warning: no DocBook DTD directory specified." ;
|
|
ECHO " If you have the DocBook DTD installed, please set " ;
|
|
ECHO " DOCBOOK_DTD_DIR to the DTD directory on either " ;
|
|
ECHO " the command line (via -sDOCBOOK_DTD_DIR=...) or in a " ;
|
|
ECHO " Boost.Jam configuration file. The DocBook DTD is available " ;
|
|
ECHO " here: http://www.oasis-open.org/docbook/xml/4.2/index.shtml" ;
|
|
ECHO " The DTD will be downloaded on-the-fly (very slow!) " ;
|
|
}
|
|
else
|
|
{
|
|
docbook-dtd-dir = [ format-catalog-path $(docbook-dtd-dir) ] ;
|
|
print.text " <rewriteURI uriStartString=\"http://www.oasis-open.org/docbook/xml/4.2/\" rewritePrefix=\"file://$(docbook-dtd-dir)/\"/>" ;
|
|
}
|
|
|
|
print.text "</catalog>" ;
|
|
}
|
|
|
|
rule xml-catalog ( )
|
|
{
|
|
if ! $(.xml-catalog)
|
|
{
|
|
# The target is created as part of the root project. But ideally
|
|
# it would be created as part of the boostbook project. This is not
|
|
# current possible as such global projects don't inherit things like
|
|
# the build directory.
|
|
|
|
# Find the root project.
|
|
local root-project = [ project.current ] ;
|
|
root-project = [ $(root-project).project-module ] ;
|
|
while
|
|
[ project.attribute $(root-project) parent-module ] &&
|
|
[ project.attribute $(root-project) parent-module ] != user-config &&
|
|
[ project.attribute $(root-project) parent-module ] != project-config
|
|
{
|
|
root-project = [ project.attribute $(root-project) parent-module ] ;
|
|
}
|
|
.xml-catalog = [ new file-target boostbook_catalog
|
|
: XML
|
|
: [ project.target $(root-project) ]
|
|
: [ new action : boostbook.generate-xml-catalog ]
|
|
:
|
|
] ;
|
|
.xml-catalog-file = [ $(.xml-catalog).path ] [ $(.xml-catalog).name ] ;
|
|
.xml-catalog-file = $(.xml-catalog-file:J=/) ;
|
|
}
|
|
return $(.xml-catalog) $(.xml-catalog-file) ;
|
|
}
|
|
|
|
class boostbook-generator : generator
|
|
{
|
|
import feature ;
|
|
import virtual-target ;
|
|
import generators ;
|
|
import boostbook ;
|
|
|
|
|
|
rule __init__ ( * : * )
|
|
{
|
|
generator.__init__ $(1) : $(2) : $(3) : $(4) : $(5) : $(6) : $(7) : $(8) : $(9) ;
|
|
}
|
|
|
|
rule run ( project name ? : property-set : sources * )
|
|
{
|
|
# Generate the catalog, but only once...
|
|
local global-catalog = [ boostbook.xml-catalog ] ;
|
|
local catalog = $(global-catalog[1]) ;
|
|
local catalog-file = $(global-catalog[2]) ;
|
|
local targets ;
|
|
|
|
# Add the catalog to the property set
|
|
property-set = [ $(property-set).add-raw <catalog>$(catalog-file) ] ;
|
|
|
|
local type = none ;
|
|
local manifest ;
|
|
local format = [ $(property-set).get <format> ] ;
|
|
switch $(format)
|
|
{
|
|
case html :
|
|
{
|
|
type = HTMLDIR ;
|
|
manifest = HTML.manifest ;
|
|
}
|
|
case xhtml :
|
|
{
|
|
type = XHTMLDIR ;
|
|
manifest = HTML.manifest ;
|
|
}
|
|
case htmlhelp :
|
|
{
|
|
type = HTMLHELP ;
|
|
manifest = HTML.manifest ;
|
|
}
|
|
|
|
case onehtml : type = HTML ;
|
|
|
|
case man :
|
|
{
|
|
type = MANPAGES ;
|
|
manifest = man.manifest ;
|
|
}
|
|
|
|
case docbook : type = DOCBOOK ;
|
|
case fo : type = FO ;
|
|
case pdf : type = PDF ;
|
|
case ps : type = PS ;
|
|
case tests : type = TESTS ;
|
|
}
|
|
|
|
if $(manifest)
|
|
{
|
|
# Create DOCBOOK file from BOOSTBOOK sources.
|
|
local base-target = [ generators.construct $(project)
|
|
: DOCBOOK : $(property-set) : $(sources) ] ;
|
|
base-target = $(base-target[2]) ;
|
|
$(base-target).depends $(catalog) ;
|
|
|
|
# Generate HTML/PDF/PS from DOCBOOK.
|
|
local target = [ generators.construct $(project) $(name)_$(manifest)
|
|
: $(type)
|
|
: [ $(property-set).add-raw
|
|
<xsl:param>manifest=$(name)_$(manifest) ]
|
|
: $(base-target) ] ;
|
|
local name = [ $(property-set).get <name> ] ;
|
|
name ?= $(format) ;
|
|
$(target[2]).set-path $(name) ;
|
|
$(target[2]).depends $(catalog) ;
|
|
|
|
targets += $(target[2]) ;
|
|
}
|
|
else {
|
|
local target = [ generators.construct $(project)
|
|
: $(type) : $(property-set) : $(sources) ] ;
|
|
|
|
if ! $(target)
|
|
{
|
|
errors.error "Cannot build documentation type '$(format)'" ;
|
|
}
|
|
else
|
|
{
|
|
$(target[2]).depends $(catalog) ;
|
|
targets += $(target[2]) ;
|
|
}
|
|
}
|
|
|
|
return $(targets) ;
|
|
}
|
|
}
|
|
|
|
generators.register [ new boostbook-generator boostbook.main : : BOOSTBOOK_MAIN ] ;
|
|
|
|
# Creates a boostbook target.
|
|
rule boostbook ( target-name : sources * : requirements * : default-build * )
|
|
{
|
|
local project = [ project.current ] ;
|
|
|
|
targets.main-target-alternative
|
|
[ new typed-target $(target-name) : $(project) : BOOSTBOOK_MAIN
|
|
: [ targets.main-target-sources $(sources) : $(target-name) ]
|
|
: [ targets.main-target-requirements $(requirements) : $(project) ]
|
|
: [ targets.main-target-default-build $(default-build) : $(project) ]
|
|
] ;
|
|
}
|
|
|
|
#############################################################################
|
|
# Dependency scanners
|
|
#############################################################################
|
|
# XInclude scanner. Mostly stolen from c-scanner :)
|
|
# Note that this assumes an "xi" prefix for XIncludes. This isn't always the
|
|
# case for XML documents, but we'll assume it's true for anything we encounter.
|
|
class xinclude-scanner : scanner
|
|
{
|
|
import virtual-target ;
|
|
import path ;
|
|
import scanner ;
|
|
|
|
rule __init__ ( includes * )
|
|
{
|
|
scanner.__init__ ;
|
|
self.includes = $(includes) ;
|
|
}
|
|
|
|
rule pattern ( )
|
|
{
|
|
return "xi:include[ ]*href=\"([^\"]*)\"" ;
|
|
}
|
|
|
|
rule process ( target : matches * : binding )
|
|
{
|
|
local target_path = [ NORMALIZE_PATH $(binding:D) ] ;
|
|
|
|
NOCARE $(matches) ;
|
|
INCLUDES $(target) : $(matches) ;
|
|
SEARCH on $(matches) = $(target_path) $(self.includes:G=) ;
|
|
|
|
scanner.propagate $(__name__) : $(matches) : $(target) ;
|
|
}
|
|
}
|
|
|
|
scanner.register xinclude-scanner : xsl:path ;
|
|
type.set-scanner XML : xinclude-scanner ;
|
|
|
|
rule boostbook-to-tests ( target : source : properties * )
|
|
{
|
|
lock-config ;
|
|
local boost_root = [ modules.peek : BOOST_ROOT ] ;
|
|
local native-path =
|
|
[ path.native [ path.join $(.boostbook-xsl-dir) testing Jamfile ] ] ;
|
|
local stylesheet = $(native-path:S=.xsl) ;
|
|
xslt $(target) : $(source) $(stylesheet)
|
|
: $(properties) <xsl:param>boost.root=$(boost_root)
|
|
;
|
|
}
|
|
|
|
|