| 1 |
# Makefile for Sphinx documentation |
| 2 |
# |
| 3 |
# NOTE: Best build it in another dir (i.e.: build.sphinx) |
| 4 |
# |
| 5 |
|
| 6 |
# You can set these variables from the command line. |
| 7 |
SPHINXOPTS = -a -E -n -t autobuild |
| 8 |
SPHINXBUILD = sphinx-build |
| 9 |
SPHINXAPIDOC = sphinx-apidoc |
| 10 |
SPHINXAPIDOCOPTS = --force --separate --private --follow-links |
| 11 |
SPHINXPROJ = isbg |
| 12 |
SOURCEDIR = . |
| 13 |
BUILDDIR = ../build/sphinx |
| 14 |
SOURCEPYDIR = ../isbg |
| 15 |
|
| 16 |
# Put it first so that "make" without argument is like "make help". |
| 17 |
help: |
| 18 |
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) |
| 19 |
@echo " " |
| 20 |
@echo " apidoc to run $(SPHINXAPIDOC)" |
| 21 |
@echo " clean-all to clean all generated files" |
| 22 |
|
| 23 |
.PHONY: help Makefile apidoc |
| 24 |
|
| 25 |
# Creates the apidoc |
| 26 |
apidoc: |
| 27 |
$(SPHINXAPIDOC) -o "$(SOURCEDIR)" "$(SOURCEPYDIR)" $(SPHINXAPIDOCOPTS) |
| 28 |
|
| 29 |
clean-all: |
| 30 |
@rm -fr "$(BUILDDIR)" |
| 31 |
|
| 32 |
# Catch-all target: route all unknown targets to Sphinx using the new |
| 33 |
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). |
| 34 |
%: Makefile |
| 35 |
$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) |