Makefile

# spec variables
SPEC_SRC_DIR	=	spec/src
SPEC_SRCS		=	$(shell find $(SPEC_SRC_DIR)/ -type f -name '*.spec')
SPEC_JS_DIR		=	spec/dst
SPEC_JS_CMD		=	./spec/build.py
SPEC_JS_DSTS 	= $(patsubst $(SPEC_SRC_DIR)/%.spec, $(SPEC_JS_DIR)/%.js, $(SPEC_SRCS))

# sphinx public variables (you can set these form the command line).
SPHINXOPTS	=
SPHINXBUILD	= sphinx-build
PAPER 		= n
BUILDDIR	= build

# sphinx internal.
PAPEROPT_a4 	= -D latex_paper_size=a4
PAPEROPT_letter = -D latex_paper_size=letter
ALLSPHINXOPTS 	= -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) overview

# the i18n builder cannot share the environment and doctrees with the others
I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) overview

# common variable
SITE_DIR = site

.PHONY: clean spec-clean api-clean all

all: spec api overview

clean: api-clean spec-clean overview-clean

# spec

$(SPEC_JS_DIR)/%.js: $(SPEC_SRC_DIR)/%.spec
	@mkdir -p $(@D)
	$(SPEC_JS_CMD) $< > $@

spec-js: $(SPEC_JS_DSTS)

spec: spec-js

spec-clean:
	-rm -rf $(SPEC_JS_DIR)

# api

api/html/index.html: $(SITE_DIR)/static/css/styles.css $(SITE_DIR)/static/js/compiled.js
	$(SPHINXBUILD) -b singlehtml -c api api api/html

$(SITE_DIR)/api-gen.html: api/html/index.html
	mv api/html/api.html ${SITE_DIR}/api-gen.html

api: $(SITE_DIR)/api-gen.html

api-clean:
	-rm -rf api/html
	-rm -f $(SITE_DIR)/api-gen.html
	-rm -f *.cache

# overview

overview/html/index.html: $(SITE_DIR)/static/css/styles.css $(SITE_DIR)/static/js/compiled.js
	$(SPHINXBUILD) -b singlehtml -c overview overview overview/html

$(SITE_DIR)/overview-gen.html: overview/html/index.html
	mv overview/html/overview.html ${SITE_DIR}/overview-gen.html

overview: $(SITE_DIR)/overview-gen.html

overview-clean:
	-rm -rf overview/html
	-rm  -f $(SITE_DIR)/overview-gen.html
	-rm -f *.cache

# static files

# --line-numbers=mediaquery <-- use this to debug the compiled less
$(SITE_DIR)/static/css/styles.css: $(wildcard $(SITE_DIR)/static/less/*.less)
	./node_modules/.bin/lessc  $(SITE_DIR)/static/less/bootstrap.less $@

$(SITE_DIR)/static/js/compiled.js: $(wildcard $(SITE_DIR)/static/js/*.js)
	cat 	$(SITE_DIR)/static/js/bootstrap.min.js 		\
		$(SITE_DIR)/static/js/lunr.min.js 		\
		$(SITE_DIR)/static/js/jquery.scrollTo-min.js 	\
		$(SITE_DIR)/static/js/search.js 		\
		$(SITE_DIR)/static/js/docs.js 			\
			> $@