blob: 5752ce427515a349dc5beea38c011f4d9d30837b [file] [log] [blame]
OVERVIEW
_scripts/jekyll-debug.sh will launch the docs for viewing at http://localhost:4000/
_scripts/build.sh will build the site in _site including javadoc
GO LIVE
to make the docs live you build.sh then push _site to github brooklyncentral/brooklyncentral.github.com
the following instructions cover this, assuming brooklyncentral.github.com is a sibling dir to the brooklyn project
updating a snapshot version, in /v/VERSION/ on the server:
export TARGET=`pwd -P`/../../brooklyncentral.github.com
export BV=0.4.0-SNAPSHOT # BROOKLYN_VERSION
# build, copy
if [ ! -f $TARGET/index.html ] ; then echo "could not find docs in $TARGET" ; exit 1 ; fi
_scripts/build.sh || { echo "failed to build docs" ; exit 1 ; }
rm -rf $TARGET/v/$BV
mkdir $TARGET/v/$BV
cp -r _site/* $TARGET/v/$BV/
# and push
pushd $TARGET
git add -A .
git commit -m "updated version docs for version $BV"
git push
popd
when we do a RELEASE we'll run the above for e.g. BV=0.4.0
AND update the files in the root dir as well, with the process below
(kinda like the process above but with / in place of /v/$BV
and overriding url in _config.yml with the --url arg below):
# remove old root files
pushd $TARGET
if [ -f start/index.html ] ; then
for x in * ; do if [[ $x != "v" ]] ; then rm -rf $x ; fi ; done
else
echo IN WRONG DIRECTORY $TARGET - export TARGET to continue
exit 1
fi
popd
# build for hosting of / rather than /v/VERSION/
_scripts/build.sh --url "" || { echo "failed to build docs" ; exit 1 ; }
cp -r _site/* $TARGET/
# and git push
pushd $TARGET
git add -A .
git commit -m "updated root docs for version $BV"
git push
popd