add book script

.ci/book.sh

@@ -0,0 +1,39 @@
+#!/bin/sh
+
+set -ex
+
+### Setup latest mdbook version ################################################
+
+INSTALLED=$(echo $(mdbook --version 2>/dev/null || echo "mdbook none") | cut -d' ' -f1)
+PINNED=0.2.1
+
+if [ "$PINNED" != "$INSTALLED" ]; then
+    URL=https://github.com/rust-lang-nursery/mdBook/releases/download/v${PINNED}/mdbook-v${PINNED}-x86_64-unknown-linux-gnu.tar.gz
+    curl -SsL $URL | tar xvz -C $HOME/.cargo/bin
+fi
+
+### Build the guide ################################################################
+# Build and then upload the guide to a specific folder on the gh-pages branch. This way we can have multiple versions
+# of the guide at the same time (See #165)
+
+# This builds the book in target/doc/guide. See https://github.com/rust-lang-nursery/mdBook/issues/698
+mkdir -p ../target/doc
+mdbook build -d ../target/doc/book
+
+# Get the lastest tag across all branches
+# https://stackoverflow.com/a/7261049/3549270
+git fetch --tags
+LATEST_TAG=$(git describe --tags $(git rev-list --tags --max-count=1 -l v*))
+
+git clone -b gh-pages https://$AUTH_TOKEN@github.com/$TRAVIS_REPO_SLUG.git gh_pages
+cd gh_pages
+
+echo "<meta http-equiv=refresh content=0;url='${LATEST_TAG}/'>" > index.html
+
+# For builds triggered by a tag, $TRAVIS_BRANCH will be set to the tag
+rm -rf "$TRAVIS_BRANCH"
+cp -r ../../target/doc/book "$TRAVIS_BRANCH"
+git add --all
+git commit -m "Upload documentation for $TRAVIS_BRANCH"
+
+git push -f

.travis.yml

@@ -5,10 +5,10 @@ services:
   - docker
 
 script:
-  - if [ -z "$TRAVIS_TAG" ]; then ./ci/run.sh check openctf; fi
+  - if [ -z "$TRAVIS_TAG" ]; then ./.ci/run.sh check openctf; fi
 
 before_deploy:
-  - ./ci/run.sh build openctf ${TRAVIS_TAG}-${TRAVIS_OS_NAME}
+  - ./.ci/run.sh build openctf ${TRAVIS_TAG}-${TRAVIS_OS_NAME}
 
 notifications:
   email: false
@@ -23,7 +23,7 @@ deploy:
     on:
       tags: true
   - provider: script
-    script: ./ci/book.sh
+    script: ./.ci/book.sh
     skip_cleanup: true
     on:
       tags: true