- # Location of stylesheets and catalogs

- docbook_dir = "#/BuildTools/DocBook"

- docbook_xsl_style_dir = env.Dir(docbook_dir + "/Stylesheets").abspath

- docbook_xml_catalog = env.File("catalog.xml").abspath

- if "DOCBOOK_XML_DIR" in env :

- docbook_xml_dir = env.Dir("$DOCBOOK_XML_DIR").abspath

- else :

- docbook_xml_dir = env.Dir("#/3rdParty/DocBook/XML").abspath

- if "DOCBOOK_XSL_DIR" in env :

- docbook_xsl_dir = env.Dir("$DOCBOOK_XSL_DIR").abspath

- else :

- docbook_xsl_dir = env.Dir("#/3rdParty/DocBook/XSL").abspath

- fop_fonts_dir = env.Dir(docbook_dir + "/Fonts").abspath

-

- # Generates a catalog from paths to external tools

- def buildCatalog(target, source, env) :

- catalog = """<?xml version='1.0'?>

- <rewriteSystem

- systemIdStartString="http://www.oasis-open.org/docbook/xml/4.5/"

- rewritePrefix="%(docbook_xml_dir)s/" />

- <rewriteSystem

- systemIdStartString="docbook-xsl:/"

- rewritePrefix="%(docbook_xsl_dir)s/" />

-

- docbook_xml_dir = source[0].get_contents()

- docbook_xsl_dir = source[1].get_contents()

- if env["PLATFORM"] == "win32" :

- docbook_xml_dir = docbook_xml_dir.replace("\\","/")

- docbook_xsl_dir = docbook_xsl_dir.replace("\\","/")

- file = open(target[0].abspath, "w")

- file.write(catalog % {

- "docbook_xml_dir" : docbook_xml_dir,

- "docbook_xsl_dir" : docbook_xsl_dir,

- })

- file.close()

-

- # Generates a FOP config file

- def buildFopConfig(target, source, env) :

- fopcfg = """<fop version=\"1.0\">

- <renderers>

- <renderer mime=\"application/pdf\">

- <fonts>

- <directory recursive=\"true\">%(fonts_dir)s</directory>

- </fonts>

- </renderer>

- </renderers>

- file = open(target[0].abspath, "w")

- file.write(fopcfg % {

- "fonts_dir" : source[0].get_contents()

- })

- file.close()

-

- # Builds a DocBook file

- def buildDocBook(env, source) :

- db_env = env.Clone()

- db_env["XMLCATALOGS"] = [docbook_xml_catalog]

- db_env["ENV"].update({"OS" : os.environ.get("OS", "")})

-

- db_env["XMLLINT"] = env.WhereIs("xmllint")

- db_env["XSLT"] = env.WhereIs("xsltproc")

- db_env["FO"] = env.WhereIs("fop")

-

- if not db_env["XMLLINT"] or not db_env["XSLT"] :

- return

-

- # PDF generation

- if db_env["FO"] :

- fo = db_env.XSLT(os.path.splitext(source)[0] + ".fo", source,

- XSLTSTYLESHEET = db_env["DOCBOOK_XSL_FO"])

- pdf = db_env.FO(fo)

-

- # HTML generation

- db_env.XSLT(os.path.splitext(source)[0] + ".html", source,

- XSLTSTYLESHEET = db_env["DOCBOOK_XSL_HTML"])

-

- # Import tools

- env.Tool("FO", toolpath = [docbook_dir + "/SCons"])

- env.Tool("XSLT", toolpath = [docbook_dir + "/SCons"])

-

- # Catalog file generation

- env.Command("catalog.xml", [env.Value(docbook_xml_dir), env.Value(docbook_xsl_dir)], SCons.Action.Action(buildCatalog, cmdstr = "$GENCOMSTR"))

-

- # FO config file generation

- env["FOCFG"] = env.File("fop.cfg").abspath

- env.Command("fop.cfg", [env.Value(fop_fonts_dir)], SCons.Action.Action(buildFopConfig, cmdstr = "$GENCOMSTR"))

-

- # DocBook stylesheets

- env["DOCBOOK_XSL_FO"] = docbook_xsl_style_dir + "/fo/docbook.xsl"

- env["DOCBOOK_XSL_HTML"] = docbook_xsl_style_dir + "/html/docbook.xsl"

- env.AddMethod(buildDocBook, "DocBook")

-

- return True

- def generate_actions(source, target, env, for_signature) :

- if len(env["FOCFG"]) > 0 :

- cmd = "$FO -c $FOCFG $FOFLAGS $SOURCE $TARGET"

- else :

- cmd = "$FO $FOFLAGS $SOURCE $TARGET"

- return SCons.Action.Action(cmd, cmdstr = "$FOCOMSTR")

- def modify_sources(target, source, env) :

- if len(env["FOCFG"]) > 0 :

- source.append(env["FOCFG"])

- return target, source

- def scan_fo(node, env, path) :

- dependencies = set()

- try :

- document = xml.dom.minidom.parseString(node.get_contents())

- except xml.parsers.expat.ExpatError:

- return []

- for include in document.getElementsByTagNameNS("http://www.w3.org/1999/XSL/Format", "external-graphic") :

- m = re.match("url\((.*)\)", include.getAttribute("src"))

- if m :

- dependencies.add(m.group(1))

- return list(dependencies)

- env["FO"] = "fop"

- env["FOFLAGS"] = ""

- env["FOCFG"] = ""

- env["BUILDERS"]["FO"] = SCons.Builder.Builder(

- generator = generate_actions,

- emitter = modify_sources,

- source_scanner = SCons.Scanner.Scanner(function = scan_fo, skeys = [".fo"]),

- suffix = ".pdf",

- src_suffix = ".fo"

- )

- return True

- def generate_actions(source, target, env, for_signature) :

- if not env.has_key("XSLTSTYLESHEET") :

- raise SCons.Errors.UserError, "The XSLTSTYLESHEET construction variable must be defined"

-

- # Process the XML catalog files

- # FIXME: It's probably not clean to do an ENV assignment globally

- env["ENV"]["XML_CATALOG_FILES"] = " ".join(env.get("XMLCATALOGS", ""))

-

- # Build the XMLLint command

- xmllintcmd = ["$XMLLINT", "--nonet", "--xinclude", "--postvalid", "--noout", "$SOURCE"]

-

- # Build the XSLT command

- xsltcmd = ["$XSLT", "--nonet", "--xinclude"]

- for (param, value) in env["XSLTPARAMS"] :

- xsltcmd += ["--stringparam", param, value]

- xsltcmd += ["-o", "$TARGET", "$XSLTSTYLESHEET", "$SOURCE"]

-

- return [

- SCons.Action.Action([xmllintcmd], cmdstr = "$XMLLINTCOMSTR"),

- SCons.Action.Action([xsltcmd], cmdstr = "$XSLTCOMSTR")]

-

- def modify_sources(target, source, env) :

- if len(env["FOCFG"]) > 0 :

- source.append(env["FOCFG"])

- source.append(env.get("XMLCATALOGS", []))

- return target, source

-

- def scan_xml(node, env, path) :

- dependencies = set()

- nodes = [node]

- while len(nodes) > 0 :

- node = nodes.pop()

- try :

- document = xml.dom.minidom.parseString(node.get_contents())

- except xml.parsers.expat.ExpatError:

- continue

- for include in document.getElementsByTagNameNS("http://www.w3.org/2001/XInclude", "include") :

- include_file = include.getAttribute("href")

- dependencies.add(include_file)

- if include.getAttribute("parse") != "text" :

- nodes.append(env.File(include_file))

- return list(dependencies)

-

- env["XMLLINT"] = "xmllint"

- env["XSLT"] = "xsltproc"

- env["XSLTPARAMS"] = []

- env["BUILDERS"]["XSLT"] = SCons.Builder.Builder(

- generator = generate_actions,

- emitter = modify_sources,

- source_scanner = SCons.Scanner.Scanner(function = scan_xml),

- src_suffix = ".xml"

- )

- return True