fixed hugo upgrade to 0.19 regression, moving the RRA uml deployment diagram sources to public_src. added a note to the README about the process of generating from such sources, including the nudge to make the generation repeatable via a script.

Author: James Gorlick

README.md

@@ -68,6 +68,13 @@ for our scripting and styling needs, and we convert those files to `.js` and
 `.css` as a pre-render step. We put those `.coffee` and `.scss` files into the
 `dynamic/` directory.
 
+>**Note:** For files manually generated, place the source of the generation in
+a directory parallel to the generated file(s), rooted in `public_src/`. If
+possible, include a script to generate the output. For example, the uml
+deployment diagram images in `static/images/redis/` were generated by the .uml
+files in `public_src/images/redis/` via the script `gen_diagrams.sh` w/ the list
+of source files for generation explicitly listed in `diagrams.lst`.
+
 To convert the Coffee and Sass into `.js` and `.css` files, you'll need to:
 
 1. **Install [RVM][rvm]** or equivalent.  

public_src/images/redis/diagrams.lst

@@ -0,0 +1,3 @@
+rra_deployment_local.uml
+rra_deployment_colocated.uml
+rra_deployment_distributed.uml

public_src/images/redis/gen_diagrams.sh

@@ -0,0 +1,18 @@
+#!/bin/sh
+function assert_dependencies () {
+    assert_dependency_plantuml
+}
+
+function assert_dependency_plantuml () {
+    if [ -z $(which plantuml) ]; then
+        echo "plantuml is required, \`brew install plantuml\` or equivalent" >&2
+        exit 1
+    fi
+}
+assert_dependencies
+
+# generate uml diagrams to parallel static dir
+for uml_src in $(cat diagrams.lst); do
+    uml_dest=$(echo "${uml_src%.*}.png")
+    cat $uml_src |plantuml -pipe >../../../static/images/redis/$uml_dest
+done