Commit dddbdd13 authored by Mark Meredith's avatar Mark Meredith
Browse files

Build both Doxygen and Sphinx in the Makefile

parent a17bf3c7

.travis.yml

+1 −1
Changes for .travis.yml: 1 added line, 1 removed line.
Original line number Diff line number Diff line
@@ -26,7 +26,7 @@ addons: 
deploy:

  provider: pages

  target-branch: gh-pages

  local-dir: docs/build

  local-dir: docs/webroot

  skip-cleanup: true

  github-token: $GITHUB_TOKEN  # Set in travis-ci.org dashboard, marked secure

  keep-history: true

build_and_deploy.sh

+3 −41
Changes for build_and_deploy.sh: 3 added lines, 41 removed lines.
Original line number Diff line number Diff line 
#!/bin/bash

#!/bin/bash -ex

set -e # Exit with nonzero exit code if anything fails



# Then we build and deploy the sphinx / doxygen documentation
@@ -16,43 +16,5 @@ fi 
#SSH_REPO=${REPO/https:\/\/github.com\//git@github.com:}

#SHA=`git rev-parse --verify HEAD`



# Change working directory to /docs

cd docs    # ..................................... now we're in /docs 





############################# DOXYGEN  ########################################





cd doxygen # ..................................... now we're in /docs/doxygen



# create temporary clone of MFiX-Exa SOURCE_BRANCH

git clone https://gitlab-ci-token:$GITLAB_TOKEN@mfix.netl.doe.gov/gitlab/exa/mfix.git



# build the Doxygen documentation

doxygen doxygen.conf



cd ..      # ..................................... now we're in /docs



# move it to the deploy directory: /docs/build

mkdir build

mv doxygen/html build/doxygen





############################# SPHINX   ########################################





# now do sphinx

make html

cd build   # ..................................... now we're in /docs/build

mv html docs_html





############################# WEB SERVER STUFF ################################





# Sphinx is set up to treat build/html (and by mv, build/docs_html) as the

# webroot. Hence the .nojekyll file is in the wrong place

mv docs_html/.nojekyll .



# PWD is currently /docs/build, we want to move /docs/webroot into /docs/build

mv ../webroot/* .
 
# build Doxygen docs and Sphinx docs

make -C docs

docs/Makefile

+12 −2
Changes for docs/Makefile: 12 added lines, 2 removed lines.
Original line number Diff line number Diff line
@@ -6,9 +6,14 @@ SPHINXOPTS = 
SPHINXBUILD   = python -msphinx

SPHINXPROJ    = amrex

SOURCEDIR     = source

BUILDDIR      = build

BUILDDIR      = webroot



all: html webroot/doxygen

	mv webroot/html webroot/docs_html

# Sphinx is set up to treat its build directory as the webroot, hence the

# .nojekyll file is in the wrong place

	mv webroot/docs_html/.nojekyll webroot



# Put it first so that "make" without argument is like "make help".

help:

	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
@@ -18,3 +23,8 @@ help: 
# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).

%: Makefile

	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)



webroot/doxygen:

	git clone https://gitlab-ci-token:$GITLAB_TOKEN@mfix.netl.doe.gov/gitlab/exa/mfix.git doxygen/mfix

	cd doxygen && doxygen doxygen.conf

	mv doxygen/html $@