1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55
|
# Minimal makefile for Sphinx documentation
# Environment variables
SPHINXOPTS ?=
SPHINXBUILD ?= sphinx-build
SPHINXAPIDOC ?= sphinx-apidoc
APIOPTS = -d 8 -H SasData -a
DOCSDIR = docs
SOURCEDIR = source
BUILDDIR = build
DEVDIR = dev
LIBDIR = lib
GENDIR = generated
UP = ..
ifdef ComSpec
RMDIR = rmdir /s/q
MKDIR = mkdir
PATHSEP = $(strip \)
else
RMDIR = rm -rf
MKDIR = mkdir -p
PATHSEP = $(strip /)
endif
SASDATABUILD = ../sasdata
DOCSSRC = $(SOURCEDIR)
DEV = $(DOCSSRC)$(PATHSEP)$(DEVDIR)
DEVGEN = $(DEV)$(PATHSEP)$(GENDIR)
DOCSBUILD = $(DOCSSRC)$(PATHSEP)$(BUILDDIR)
# Put it first so that "make" without argument is like "make help".
help:
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
clean:
-$(RMDIR) "$(DEVGEN)" "$(DOCSBUILD)"
dir:
-$(MKDIR) "$(DEVGEN)"
-$(MKDIR) "$(DOCSBUILD)"
.PHONY: help Makefile
# Generate the api docs
api:
$(SPHINXAPIDOC) -o "$(DEVGEN)" $(APIOPTS) "$(SASDATABUILD)"
html: dir api
@$(SPHINXBUILD) -M $@ "$(DOCSSRC)" "$(DOCSBUILD)" $(SPHINXOPTS) $(O)
# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
%: Makefile
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
|