xref: /petsc/doc/makefile (revision 997fbc66f680beab66c0aab0688547c360ef0fcb)
14754a72fSPatrick Sanan# Initially generated with sphinx-quickstart
24754a72fSPatrick Sanan
34754a72fSPatrick Sanan# You can set these variables from the command line, and also
44754a72fSPatrick Sanan# from the environment for the first two.
54754a72fSPatrick SananSPHINXOPTS    ?=
64754a72fSPatrick SananSPHINXBUILD   ?= sphinx-build
74754a72fSPatrick SananSOURCEDIR     = .
84754a72fSPatrick SananBUILDDIR      = _build
94754a72fSPatrick SananLINKCHECKDIR  = _build/linkcheck
104754a72fSPatrick Sanan
114754a72fSPatrick Sanan# First so that "make" without arguments is like "make help".
124754a72fSPatrick Sananhelp:
134754a72fSPatrick Sanan	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS)
144754a72fSPatrick Sanan
154754a72fSPatrick Sanan.PHONY: help makefile checklinks
164754a72fSPatrick Sanan
174754a72fSPatrick Sananchecklinks:
184754a72fSPatrick Sanan	@$(SPHINXBUILD) -b linkcheck "$(SOURCEDIR)" "$(LINKCHECKDIR)" $(SPHINXOPTS)
194754a72fSPatrick Sanan	@echo
204754a72fSPatrick Sanan	@echo "Check finished. Report is in $(LINKCHECKDIR)."
214754a72fSPatrick Sanan
224754a72fSPatrick Sananclean-classic-docs:
234754a72fSPatrick Sanan	./build_classic_docs.py --clean
244754a72fSPatrick Sanan
254754a72fSPatrick Sananclean: clean-classic-docs
264754a72fSPatrick Sanan
274754a72fSPatrick Sananimages:
284754a72fSPatrick Sanan	git clone https://gitlab.com/petsc/images.git -b main-1 --depth=1 images
294754a72fSPatrick Sanan
304754a72fSPatrick Sananwebsite-deploy: images
314754a72fSPatrick Sanan	$(SPHINXBUILD) -b dirhtml "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) -T -E -j auto
324754a72fSPatrick Sanan
33*997fbc66SBarry Smithsphinxhtml:
34*997fbc66SBarry Smith	cd .. ; python3 -m venv petsc-doc-env ; source petsc-doc-env/bin/activate ; python3 -m pip install -r doc/requirements.txt ; cd doc ; make html; deactivate
35*997fbc66SBarry Smith
364754a72fSPatrick Sanan# Catch-all target: route all unknown targets to Sphinx using the new
374754a72fSPatrick Sanan# "make mode" option.
384754a72fSPatrick Sanan%: makefile images
394754a72fSPatrick Sanan	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) -j auto
404754a72fSPatrick Sanan
41