[rtems-docs commit] waf: Add support to build PlantUML and Ditaa images.

Chris Johns chrisj at rtems.org
Sat Nov 3 06:01:26 UTC 2018


Module:    rtems-docs
Branch:    master
Commit:    21c1a4492a6c437d057c3af605278e9ba5edcac0
Changeset: http://git.rtems.org/rtems-docs/commit/?id=21c1a4492a6c437d057c3af605278e9ba5edcac0

Author:    Chris Johns <chrisj at rtems.org>
Date:      Fri Nov  2 14:05:51 2018 +1100

waf: Add support to build PlantUML and Ditaa images.

---

 README.txt        | 17 +++++++++++++-
 common/waf.py     | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 images/.gitignore |  1 +
 images/wscript    |  7 ++++++
 wscript           |  6 +++++
 5 files changed, 99 insertions(+), 2 deletions(-)

diff --git a/README.txt b/README.txt
index a7380a9..203c45d 100644
--- a/README.txt
+++ b/README.txt
@@ -115,6 +115,16 @@ Single HTML:
   # pkg install npm
   # npm install -g inliner
 
+Plant UML:
+
+Install NPM as shown in Single HTML then:
+
+  # npm install -g node-plantuml
+
+Ditaa:
+
+  # pkg install ditaa
+
 CentOS 6 and 7
 ~~~~~~~~~~~~~~
 
@@ -151,10 +161,15 @@ Single HTML:
 NOTE: npm appears to be part of the EPEL repository for RHEL and CentOS.
 You may have to add that repository to your configuration.
 
-
   # yum install npm
   # npm install -g inliner
 
+Plant UML:
+
+Install NPM as shown in Single HTML then:
+
+  # npm install -g node-plantuml
+
 Spell check:
 
   # yum install aspell
diff --git a/common/waf.py b/common/waf.py
index 3f0fcc1..692d4de 100644
--- a/common/waf.py
+++ b/common/waf.py
@@ -257,9 +257,37 @@ def cmd_configure(ctx):
             ctx.env.BUILD_SINGLEHTML = 'yes'
             ctx.find_program("inliner", var = "BIN_INLINER", mandatory = False)
             if not ctx.env.BIN_INLINER:
-                ctx.fatal("Node inliner is required install with 'npm install -g inliner' " +
+                ctx.fatal("Node.js inliner is required install with 'npm install -g inliner' " +
                           "(https://github.com/remy/inliner)")
 
+    ctx.envBUILD_PLANTUML = 'no'
+    if ctx.options.plantuml:
+        check_plantuml = not ctx.env.BIN_PUML
+        if check_plantuml:
+            ctx.env.BUILD_PLANTUML = 'yes'
+            ctx.find_program("puml", var = "BIN_PUML", mandatory = False)
+            if not ctx.env.BIN_PUML:
+                ctx.fatal("Node.js puml is required install with 'npm install -g node-plantuml' " +
+                          "(https://www.npmjs.com/package/node-plantuml)")
+
+    ctx.envBUILD_DITAA = 'no'
+    if ctx.options.ditaa:
+        #
+        # We use DITAA via PlantUML
+        #
+        if not ctx.env.BIN_PUML:
+            ctx.find_program("puml", var = "BIN_PUML", mandatory = False)
+            if not ctx.env.BIN_PUML:
+                ctx.fatal("DITAA uses PlantUML; " +
+                          "Node.js puml is required install with 'npm install -g node-plantuml' " +
+                          "(https://www.npmjs.com/package/node-plantuml)")
+        check_ditaa = not ctx.env.BIN_DITAA
+        if check_ditaa:
+            ctx.env.BUILD_DITAA = 'yes'
+            ctx.find_program("ditaa", var = "BIN_DITAA", mandatory = False)
+            if not ctx.env.BIN_DITAA:
+                ctx.fatal("DITAA not found, plase install")
+
 def doc_pdf(ctx, source_dir, conf_dir, extra_source):
     buildtype = 'latex'
     build_dir, output_node, output_dir, doctrees = build_dir_setup(ctx, buildtype)
@@ -353,6 +381,30 @@ def doc_html(ctx, source_dir, conf_dir, extra_source):
                       relative_trick = True,
                       quiet = True)
 
+def images_plantuml(ctx, source_dir, conf_dir, ext):
+    #
+    # Use a run command to handle stdout and stderr output from puml.
+    #
+    def run(task):
+        src = task.inputs[0].abspath()
+        tgt = task.outputs[0].abspath()
+        cmd = '%s generate %s -o %s' % (task.env.BIN_PUML[0], src, tgt)
+        so = open(tgt + '.out', 'w')
+        r = task.exec_command(cmd, stdout = so, stderr = so)
+        so.close()
+        return r
+
+    for src in ctx.path.ant_glob('**/*' + ext):
+        tgt = src.abspath()[: - len(ext)] + '.png'
+        ctx(
+            rule         = run,
+            inliner      = ctx.env.BIN_PUML,
+            source       = src,
+            target       = tgt,
+            install_path = None
+    )
+
+
 def cmd_build(ctx, extra_source = []):
     conf_dir = ctx.path.get_src()
     source_dir = ctx.path.get_src()
@@ -365,6 +417,14 @@ def cmd_build(ctx, extra_source = []):
 
     doc_html(ctx, source_dir, conf_dir, extra_source)
 
+def cmd_build_images(ctx):
+    conf_dir = ctx.path.get_src()
+    source_dir = ctx.path.get_src()
+    if ctx.env.BUILD_PLANTUML == 'yes':
+        images_plantuml(ctx, source_dir, conf_dir, '.puml')
+    if ctx.env.BUILD_DITAA == 'yes':
+        images_plantuml(ctx, source_dir, conf_dir, '.ditaa')
+
 def cmd_options(ctx):
     ctx.add_option('--disable-extra-fonts',
                    action = 'store_true',
@@ -382,6 +442,14 @@ def cmd_options(ctx):
                    action = 'store_true',
                    default = False,
                    help = "Build Single HTML file, requires Node Inliner")
+    ctx.add_option('--plantuml',
+                   action = 'store_true',
+                   default = False,
+                   help = "Build PlantUML images from source, need puml from npm")
+    ctx.add_option('--ditaa',
+                   action = 'store_true',
+                   default = False,
+                   help = "Build DITAA images using PlantUML from source, need ditaa and puml")
 
 def cmd_options_path(ctx):
     cmd_options(ctx)
diff --git a/images/.gitignore b/images/.gitignore
new file mode 100644
index 0000000..f47cb20
--- /dev/null
+++ b/images/.gitignore
@@ -0,0 +1 @@
+*.out
diff --git a/images/wscript b/images/wscript
new file mode 100644
index 0000000..41a9308
--- /dev/null
+++ b/images/wscript
@@ -0,0 +1,7 @@
+from sys import path
+from os.path import abspath
+path.append(abspath('../common/'))
+
+from waf import cmd_configure as configure
+from waf import cmd_build_images as build
+from waf import cmd_options as options
diff --git a/wscript b/wscript
index 8fd22ac..5ce7f0d 100644
--- a/wscript
+++ b/wscript
@@ -53,6 +53,12 @@ def coverpage_js(ctx):
         o.write(js.replace('@CATALOGUE', xml))
 
 def build(ctx):
+    #
+    # Generate any PlantUML images if enabled.
+    #
+    ctx.recurse('images')
+    ctx.add_group('images')
+
     for b in building:
         ctx.recurse(b)
 




More information about the vc mailing list