Merge pull request #59 from dseevr/trailing_slashessssssssssssssssssssssssss

Added trailing slashes to all RAML HTML output

Author: dseevr

scripts/build.sh

@@ -15,7 +15,24 @@ docker run --rm \
 mv spec/netmaster.raml ./spec/contiv/libraries/netmaster.raml
 
 # run the raml2html tool to generate docs under spec/docs
-cd spec
+pushd spec
 make docs
 mkdir -p docs
 mv contiv.html docs/
+popd
+
+# RAML doesn't currently support trailing slashes so we add them manually here
+
+# altering the HTML requires a gem called Nokogiri
+# create a tiny docker image so we don't have to reinstall Nokogiri every time
+IMAGE_NAME="raml_trailing_slashes"
+
+if [[ "$(docker images -q $IMAGE_NAME:latest 2>/dev/null)" == "" ]]; then
+    docker build -t $IMAGE_NAME -f spec/Dockerfile.raml_trailing_slashes .
+fi
+
+docker run --rm \
+       -u $(id -u):$(id -g) \
+       -v $(pwd):/files \
+       -w /files/spec \
+       $IMAGE_NAME /usr/local/bin/ruby raml_trailing_slashes.rb

spec/Dockerfile.raml_trailing_slashes

@@ -0,0 +1,5 @@
+FROM ruby:2.4.0-slim
+
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update && apt-get -y install build-essential && gem install nokogiri