From 080e59ed7c74e7a31ef2bc8c75000b0081837f3a Mon Sep 17 00:00:00 2001 From: drebs Date: Wed, 11 Oct 2017 08:19:02 -0300 Subject: [doc] add script to build docs --- scripts/docs/build-soledad-doc.sh | 47 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100755 scripts/docs/build-soledad-doc.sh (limited to 'scripts') diff --git a/scripts/docs/build-soledad-doc.sh b/scripts/docs/build-soledad-doc.sh new file mode 100755 index 00000000..ee4e8bd0 --- /dev/null +++ b/scripts/docs/build-soledad-doc.sh @@ -0,0 +1,47 @@ +#!/bin/sh + +# This script builds the Soledad documentation using a virtual environment. +# You can pass the target directory as the first command line argument: +# +# ./build-soledad-doc.sh [target-dir] +# +# If you no directory is passed, documentation will be built on the default +# place used by sphinx: /docs/_build + +set -eu +set -o xtrace + +BUILDDIR=${1:-_build} +REPO="http://0xacab.org/leap/soledad" +REPO=/tmp/soledad +TEMPDIR=$(mktemp -d) +VENVDIR=${TEMPDIR}/venv +REPODIR=${TEMPDIR}/soledad +TARGET=html + +if [[ ${BUILDDIR} = /* ]]; then + type="absolute" + docdir=${BUILDDIR}/${TARGET} +else + type="relative" + docdir=${REPODIR}/docs/${BUILDDIR}/${TARGET} +fi + +echo "Documentation will be written to ${type} path ${BUILDDIR}." + +# build and activate the virtual environment +if [ ! -d ${VENVDIR} ]; then + virtualenv ${VENVDIR} +fi +. ${VENVDIR}/bin/activate + +# clone the canonical repository +git clone ${REPO} ${REPODIR} + +# install deps +pip install -U pip wheel +pip install -r ${REPODIR}/docs/requirements.pip + +# build documentation +make -C ${REPODIR}/docs ${TARGET} BUILDDIR=${BUILDDIR} +ls -1 ${docdir} -- cgit v1.2.3