Makefile (1053B)
1 # Minimal makefile for Sphinx documentation 2 # 3 4 # You can set these variables from the command line, and also 5 # from the environment for the first two. 6 SPHINXOPTS ?= 7 SPHINXBUILD ?= sphinx-build 8 SOURCEDIR := source 9 BUILDDIR := build 10 11 #Own Settings 12 PORT ?= 2000 13 HOST ?= 0.0.0.0 14 BROWSER ?= xdg-open 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 20 .PHONY: help Makefile installRequirements localView 21 22 # Catch-all target: route all unknown targets to Sphinx using the new 23 # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). 24 %: Makefile 25 @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) 26 27 installRequirements: 28 pip install -r requirements.txt 29 30 31 livehtml: 32 @echo "Start sphinx-autobuild at http://$(HOST):$(PORT)" 33 @trap 'kill $$PID' INT; \ 34 sphinx-autobuild $(SOURCEDIR) $(BUILDDIR)/html --host $(HOST) --port $(PORT) & \ 35 PID=$$!; \ 36 sleep 1; \ 37 xdg-open http://$(HOST):$(PORT); \ 38 wait $$PID