Add generated docs to Jekyll tree build target. Add script for bringing up

local instance of bazel.io site.

* Add a new genrule rule that runs the new jekyll-tree.sh to do the following:
  * Combine the generated docs for the Build Encyclopedia and Skylark Library
    with the static site docs
  * Combine the README.md files for the Docker and Packaging rules with the
    Jekyll tree
  * Process the generated docs, replaces instances of "blaze" with "bazel",
    etc.
* Add scripts/serve-docs.sh script that can be used to bring up a local
  instance of the bazel.io website.

As of this patch, it is possible to construct the full Bazel.io site tree from
the master branch.

--
MOS_MIGRATED_REVID=121813688

1 files changed, 110 insertions, 0 deletions

diff --git a/site/jekyll-tree.sh b/site/jekyll-tree.sh
new file mode 100755
index 0000000000..abd33236fe
--- /dev/null
+++ b/site/jekyll-tree.sh
@@ -0,0 +1,110 @@
+#!/bin/bash
+# Copyright 2016 The Bazel Authors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -eu
+
+readonly OUTPUT=${PWD}/$1
+shift
+readonly JEKYLL_BASE=${PWD}/$1
+shift
+readonly SKYLARK_RULE_DOCS=${PWD}/$1
+shift
+readonly BE_ZIP=${PWD}/$1
+shift
+readonly SL_ZIP=${PWD}/$1
+
+# Create temporary directory that is removed when this script exits.
+readonly TMP=$(mktemp -d)
+readonly OUT_DIR="$TMP/out"
+trap "rm -rf ${TMP}" EXIT
+
+function setup {
+  mkdir -p "$OUT_DIR"
+  cd "$OUT_DIR"
+  tar -xf "${JEKYLL_BASE}"
+}
+
+# Unpack the Build Encyclopedia into docs/be
+function unpack_build_encyclopedia {
+  local be_dir="$OUT_DIR/docs/be"
+  mkdir -p "$be_dir"
+  unzip -qq "$BE_ZIP" -d "$be_dir"
+  mv "$be_dir/be-nav.html" "$OUT_DIR/_includes"
+}
+
+# Unpack the Skylark Library into docs/skylark/lib
+function unpack_skylark_library {
+  local sl_dir="$OUT_DIR/docs/skylark/lib"
+  mkdir -p "$sl_dir"
+  unzip -qq "$SL_ZIP" -d "$sl_dir"
+  mv "$sl_dir/skylark-nav.html" "$OUT_DIR/_includes"
+}
+
+function copy_skylark_rule_doc {
+  local rule_family=$1
+  local rule_family_name=$2
+  local be_dir="$OUT_DIR/docs/be"
+  local tempf=$(mktemp -t bazel-skylark-XXXXXX)
+
+  ( cat <<EOF
+---
+layout: documentation
+title: ${rule_family_name} Rules
+---
+EOF
+    cat "$TMP/skylark/$rule_family/README.md"; ) > "$be_dir/${rule_family}.md"
+}
+
+function unpack_skylark_rule_docs {
+  local tmp_dir=$TMP/skylark
+  mkdir -p $tmp_dir
+  cd "$tmp_dir"
+  tar -xf "${SKYLARK_RULE_DOCS}"
+  copy_skylark_rule_doc docker "Docker"
+  copy_skylark_rule_doc pkg "Packaging"
+}
+
+function process_doc {
+  local f=$1
+  local tempf=$(mktemp -t bazel-doc-XXXXXX)
+
+  chmod +w $f
+  cat "$f" | sed 's,\.md,.html,g;s,Blaze,Bazel,g;s,blaze,bazel,g' > "$tempf"
+  cat "$tempf" > "$f"
+}
+
+function process_docs {
+  for f in $(find "$OUT_DIR/docs" -name "*.html"); do
+    process_doc $f
+  done
+  for f in $(find "$OUT_DIR/docs" -name "*.md"); do
+    process_doc $f
+  done
+}
+
+function package_output {
+  cd "$OUT_DIR"
+  tar -hcf $OUTPUT $(find . -type f | sort)
+}
+
+function main {
+  setup
+  unpack_build_encyclopedia
+  unpack_skylark_library
+  unpack_skylark_rule_docs
+  process_docs
+  package_output
+}
+main