You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
33 lines
1.1 KiB
33 lines
1.1 KiB
# Minimal makefile for Sphinx documentation |
|
# |
|
|
|
# You can set these variables from the command line, and also |
|
# from the environment for the first two. |
|
SPHINXOPTS ?= |
|
SPHINXBUILD ?= sphinx-build |
|
SOURCEDIR = source |
|
BUILDDIR = build |
|
|
|
# Put it first so that "make" without argument is like "make help". |
|
help: |
|
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) |
|
|
|
.PHONY: help Makefile |
|
|
|
# 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) |
|
|
|
# We clear the html folder before rebuilding, otherwise some things are |
|
# not updated (like static files) |
|
html: |
|
rm -rf $(BUILDDIR)/html/* |
|
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) |
|
|
|
html_versions: |
|
rm -rf $(BUILDDIR)/html_versions/* |
|
sphinx-multiversion "$(SOURCEDIR)" "$(BUILDDIR)/html_versions" -D 'version_sourcedir=$${sourcedir}' $(SPHINXOPTS) $(O) |
|
|
|
pdf: weasyprint |
|
python3 sphinx-tools/make_pdf.py "$(SOURCEDIR)" "$(BUILDDIR)"
|
|
|