# -*- python -*- Import('env') import SENFSCons ########################################################################### import yaptu def modules(): global EXTRA_MODULES rv = [] ix = len(env.Dir('#').abspath)+1 ex = dict((env.Dir(p).abspath,True) for n,p in EXTRA_MODULES) for module in env.Alias('all_docs')[0].sources: if module.name != 'html.stamp' : continue if not ex.get(module.dir.abspath): rv.append(('lib%s' % module.dir.dir.dir.name, module.dir.abspath[ix:])) rv.sort() return [ (name, env.Dir(path).abspath[ix:]) for name,path in EXTRA_MODULES ] + rv def indices(): ix = len(env.Dir('#').abspath)+1 return [ doc.dir.abspath[ix:] for doc in env.Alias('all_docs')[0].sources if doc.name == "search.idx" ] def writeTemplate(target = None, source = None, env = None): file(target[0].abspath,"w").write(yaptu.process(str(env['TEMPLATE']), globals(), env.Dictionary())) writeTemplate = env.Action(writeTemplate, varlist = [ 'TEMPLATE' ]) ########################################################################### # Extra documentation modules which are handled (named) different from # library modules EXTRA_MODULES = [ ('Overview', '#/doc/html'), ('Examples', '#/Examples/doc/html'), ('SENFSCons', '#/senfscons/doc/html') ] HEADER = """ $title
    {{ for name, path in modules():
  • ${name}
    • }}
""" OVERVIEW_EXTRA_HEADER="" FOOTER = """
""" SEARCH_PHP=""" """ SEARCH_PATHS_PHP="""""" env.Command('doxy-header.html', 'SConscript', writeTemplate, TEMPLATE = Literal(HEADER), TITLE = "Documentation and API reference") env.Command('doxy-header-overview.html', 'SConscript', writeTemplate, TEMPLATE = Literal(HEADER+OVERVIEW_EXTRA_HEADER), TITLE = "Introduction and Overview") env.Command('doxy-footer.html', 'SConscript', writeTemplate, TEMPLATE = Literal(FOOTER)) env.Alias('all_docs', env.Command('search.php', [ 'html-munge.xsl', 'SConscript' ], [ writeTemplate, 'xsltproc --nonet --html --stringparam topdir .. -o - $SOURCE $TARGET 2>/dev/null' + "| sed" + r" -e 's/\[\[//g'" + r" -e 's/\$$projectname/Overview/g'" + r" -e 's/\$$title/Search results/g'" + "> ${TARGETS[0]}.tmp", 'mv ${TARGET}.tmp ${TARGET}' ], TEMPLATE = Literal(HEADER + OVERVIEW_EXTRA_HEADER + SEARCH_PHP.replace('',']]') + FOOTER), TITLE = "Search results")) env.Alias('all_docs', env.Command('search_paths.php', 'SConscript', writeTemplate, TEMPLATE = Literal(SEARCH_PATHS_PHP)))