# Top-level Makefile for creating the Spectral Python (SPy) website SPHINXDIR = sphinx SPHINXOPTS = -W PYTHON = python SPECTRAL_DATA := $(SPHINXDIR)/data:$(SPECTRAL_DATA) # The name of a sample data file so we know whether to init/update the git submodule IMAGE_FILE = $(SPHINXDIR)/data/92AV3C.lan .PHONY: sphinx-html, images, upload, clean, help, git-submodules help: @echo "Build targets:" @echo " sphinx-html Makes Sphinx HTML files without creating externally" @echo " generated images (faster and useful for debugging)." @echo " images Makes external images referenced by Sphinx." @echo " site Builds all website content." @echo " clean Removes all generated content." @echo " upload Uploads web site content to server." @echo "" sphinx-html: $(IMAGE_FILE) @echo "Building Sphinx files..." $(MAKE) -C $(SPHINXDIR) html SPHINXOPTS=$(SPHINXOPTS) images: @echo "Creating image files..." $(PYTHON) scripts/create_images.py -o $(SPHINXDIR)/images $(IMAGE_FILE): @echo "Retrieving sample data files from GitHub..." git submodule init git submodule update git-submodules: @echo "Retrieving sample data files from GitHub..." git submodule init git submodule update site: images sphinx-html cp static/CNAME sphinx/_build/html cp static/.nojekyll sphinx/_build/html upload: ghp-import sphinx/_build/html/ && \ git checkout master && git merge gh-pages -m "gh-pages merge" && \ git push origin --all && git checkout source clean: $(MAKE) -C $(SPHINXDIR) clean rm -rf $(SPHINXDIR)/images