From a316b1ff6d765fe0d3631282e750c94470612e97 Mon Sep 17 00:00:00 2001
From: Amar Takhar <amar@rtems.org>
Date: Tue, 19 Jan 2016 20:37:04 -0500
Subject: Add support for singlehtml (inlined) HTML file, plus some other
 fixes.

  * This is still broken.
  * Rename sphinx_rtd_theme so it doesn't pickup locally installed ones
  * Add a hack to theme.css to get around inliner bug.
  * Some unrelated fixups in common/waf.py

Unfortunatly several dozen fixes got merged into this.
---
 common/waf.py | 98 +++++++++++++++++++++++++++++++++++++----------------------
 1 file changed, 62 insertions(+), 36 deletions(-)

(limited to 'common/waf.py')

diff --git a/common/waf.py b/common/waf.py
index cf679c9..8369900 100644
--- a/common/waf.py
+++ b/common/waf.py
@@ -1,9 +1,9 @@
 import sys, os
 from waflib.Build import BuildContext
 
-
 sphinx_min_version = (1,3)
 
+
 def cmd_spell(ctx):
 	from waflib import Options
 	from sys import argv
@@ -35,29 +35,25 @@ class spell(BuildContext):
 	fun = 'cmd_spell'
 
 
-
 def check_sphinx_version(ctx, minver):
-#	try:
 	version = ctx.cmd_and_log(ctx.env.BIN_SPHINX_BUILD + ['--version']).split(" ")[-1:][0]
 	ver = tuple(map(int, version.split(".")))
-#	except Exception:
-#		ctx.fatal("Version check failed please report")
 
 	if ver < minver:
 		ctx.fatal("Sphinx version is too old: %s" % ".".join(map(str, ver)))
 
 	return ver
 
+
 def cmd_configure(ctx):
 	ctx.load('tex')
 
-
 	if not ctx.env.PDFLATEX or not ctx.env.MAKEINDEX:
 		ctx.fatal('The programs pdflatex and makeindex are required')
 
 	ctx.find_program("sphinx-build", var="BIN_SPHINX_BUILD", mandatory=True)
 	ctx.find_program("aspell", var="BIN_ASPELL", mandatory=False)
-
+	ctx.find_program("inliner", var="BIN_INLINER", mandatory=False)
 
 	ctx.start_msg("Checking if Sphinx is at least %s.%s" % sphinx_min_version)
 	ver = check_sphinx_version(ctx, sphinx_min_version)
@@ -65,42 +61,72 @@ def cmd_configure(ctx):
 	ctx.end_msg("yes (%s)" % ".".join(map(str, ver)))
 
 
+def doc_pdf(ctx, source_dir, conf_dir):
+	ctx(
+		rule	= "${BIN_SPHINX_BUILD} -b latex -c %s -j %d -d build/doctrees %s build/latex" % (conf_dir, ctx.options.jobs, source_dir),
+		cwd		= ctx.path.abspath(),
+		source	= ctx.path.ant_glob('**/*.rst'),
+		target	= "latex/%s.tex" % ctx.path.name
+	)
 
-def cmd_build(ctx, conf_dir=".", source_dir="."):
-	srcnode = ctx.srcnode.abspath()
+	ctx.add_group()
 
-	if ctx.options.pdf:
+	ctx(
+		features	= 'tex',
+		cwd			= "%s/latex/" % ctx.path.get_bld().abspath(),
+		type		= 'pdflatex',
+		source		= ctx.bldnode.find_or_declare("latex/%s.tex" % ctx.path.name),
+		prompt		= 0
+	)
 
-		ctx(
-			rule	= "${BIN_SPHINX_BUILD} -b latex -c %s -j %d -d build/doctrees %s build/latex" % (conf_dir, ctx.options.jobs, source_dir),
-			cwd		= ctx.path.abspath(),
-			source	= ctx.path.ant_glob('**/*.rst'),
-			target	= "latex/%s.tex" % ctx.path.name
-		)
 
-		ctx.add_group()
+def doc_singlehtml(ctx, source_dir, conf_dir):
+	if not ctx.env.BIN_INLINER:
+		ctx.fatal("Node inliner is required install with 'npm install -g inliner' (https://github.com/remy/inliner)")
+
+	ctx(
+		rule	= "${BIN_SPHINX_BUILD} -b singlehtml -c %s -j %d -d build/doctrees %s build/singlehtml" % (conf_dir, ctx.options.jobs, source_dir),
+		cwd		= ctx.path.abspath(),
+		source	= ctx.path.ant_glob('**/*.rst'),
+		target	= "singlehtml/index.html"
+	)
+
+	ctx.add_group()
+
+	ctx(
+		rule	= "${BIN_INLINER} ${SRC} > ${TGT}",
+		source	= "singlehtml/index.html",
+		target	= "singlehtml/%s.html" % ctx.path.name
+	)
+
+
+def html_resources(ctx):
+	for dir in ["_static", "_templates"]:
+		files = ctx.path.parent.find_node("common").ant_glob("%s/*" % dir)
+		ctx.path.get_bld().make_node(dir).mkdir() # dirs
 
 		ctx(
-			features	= 'tex',
-			cwd			= "%s/latex/" % ctx.path.get_bld().abspath(),
-			type		= 'pdflatex',
-			source		= ctx.bldnode.find_or_declare("latex/%s.tex" % ctx.path.name),
-			prompt		= 0
+			features    = "subst",
+			is_copy     = True,
+			source      = files,
+			target      = [ctx.bldnode.find_node(dir).get_bld().make_node(x.name) for x in files]
 		)
 
-	else:
-	# Copy HTML resources.
-		for dir in ["_static", "_templates"]:
-			files = ctx.path.parent.find_node("common").ant_glob("%s/*" % dir)
-			ctx.path.get_bld().make_node(dir).mkdir() # dirs
-
-			ctx(
-				features    = "subst",
-				is_copy     = True,
-				source      = files,
-				target      = [ctx.bldnode.find_node(dir).get_bld().make_node(x.name) for x in files]
-			)
 
+def cmd_build(ctx, conf_dir=".", source_dir="."):
+	srcnode = ctx.srcnode.abspath()
+
+	if not ctx.env.PDFLATEX or not ctx.env.MAKEINDEX:
+		ctx.fatal('The programs pdflatex and makeindex are required')
+
+
+	if ctx.options.pdf:
+		doc_pdf(ctx, source_dir, conf_dir)
+	elif ctx.options.singlehtml:
+		html_resources(ctx)
+		doc_singlehtml(ctx, source_dir, conf_dir)
+	else:
+		html_resources(ctx)
 		ctx(
 			rule   = "${BIN_SPHINX_BUILD} -b html -c %s -j %d -d build/doctrees %s build/html" % (conf_dir, ctx.options.jobs, source_dir),
 			cwd	= ctx.path.abspath(),
@@ -110,6 +136,8 @@ def cmd_build(ctx, conf_dir=".", source_dir="."):
 
 def cmd_options(ctx):
 	ctx.add_option('--pdf', action='store_true', default=False, help="Build PDF.")
+	ctx.add_option('--singlehtml', action='store_true', default=False, help="Build Single HTML file, requires Node Inliner")
+
 
 def cmd_options_path(ctx):
 	cmd_options(ctx)
@@ -151,5 +179,3 @@ def cmd_build_path(ctx):
     )
 
 	cmd_build(ctx, conf_dir="build", source_dir="build")
-
-
-- 
cgit v1.2.3