Makefile
144 lines
| 4.6 KiB
| text/x-makefile
|
MakefileLexer
/ docs / Makefile
Brian E Granger
|
r1256 | # Makefile for Sphinx documentation | ||
# | ||||
# You can set these variables from the command line. | ||||
SPHINXOPTS = | ||||
SPHINXBUILD = sphinx-build | ||||
PAPER = | ||||
Fernando Perez
|
r1850 | SRCDIR = source | ||
Rustam Safin
|
r8944 | BUILDDIR = build | ||
Thomas Kluyver
|
r22915 | PYTHON = python3 | ||
Brian E Granger
|
r1256 | |||
# Internal variables. | ||||
PAPEROPT_a4 = -D latex_paper_size=a4 | ||||
PAPEROPT_letter = -D latex_paper_size=letter | ||||
Fernando Perez
|
r1850 | ALLSPHINXOPTS = -d build/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) $(SRCDIR) | ||
Brian E Granger
|
r1256 | |||
Fernando Perez
|
r1850 | .PHONY: help clean html web pickle htmlhelp latex changes linkcheck api | ||
Brian E Granger
|
r1256 | |||
Fernando Perez
|
r2339 | default: html | ||
Brian E Granger
|
r1256 | help: | ||
@echo "Please use \`make <target>' where <target> is one of" | ||||
Paul Ivanov
|
r12940 | @echo " html standalone HTML files" | ||
@echo " html_noapi same as above, without the time consuming API docs" | ||||
@echo " pickle pickle files (usable by e.g. sphinx-web)" | ||||
@echo " htmlhelp HTML files and a HTML help project" | ||||
@echo " latex LaTeX files, you can set PAPER=a4 or PAPER=letter" | ||||
@echo " texinfo Texinfo files" | ||||
@echo " info Texinfo files and run them through makeinfo" | ||||
@echo " changes an overview over all changed/added/deprecated items" | ||||
@echo " linkcheck check all external links for integrity (takes a long time)" | ||||
Fernando Perez
|
r1525 | @echo | ||
@echo "Compound utility targets:" | ||||
@echo "pdf latex and then runs the PDF generation" | ||||
@echo "all html and pdf" | ||||
@echo "dist all, and then puts the results in dist/" | ||||
Brian E Granger
|
r1256 | |||
Thomas Kluyver
|
r13458 | clean_api: | ||
-rm -rf $(SRCDIR)/api/generated | ||||
clean: clean_api | ||||
-rm -rf build/* dist/* | ||||
klonuo
|
r22516 | -rm -f $(SRCDIR)/config/options/config-generated.txt | ||
klonuo
|
r22590 | -rm -f $(SRCDIR)/config/shortcuts/*.csv | ||
Thomas Kluyver
|
r18294 | -rm -f $(SRCDIR)/interactive/magics-generated.txt | ||
Brian E Granger
|
r1256 | |||
Fernando Perez
|
r1525 | pdf: latex | ||
cd build/latex && make all-pdf | ||||
all: html pdf | ||||
Fernando Perez
|
r4453 | # For final distribution, only build HTML (our pdf is now so large as to be | ||
# unusable, takes forever to build and just bloats the downloads). We leave | ||||
# them hardlinked at the top-level so users find them easily, though the | ||||
# original build/html dir is left in-place (useful to reload builds while | ||||
# testing). | ||||
dist: html | ||||
rm -rf html | ||||
cp -al build/html . | ||||
@echo "Build finished. Final docs are in html/" | ||||
Fernando Perez
|
r1525 | |||
klonuo
|
r22590 | html: api autoconfig automagic autogen_shortcuts | ||
html_noapi: clean_api autoconfig automagic autogen_shortcuts | ||||
Dav Clark
|
r12532 | |||
Dav Clark
|
r12551 | html html_noapi: | ||
Brian E Granger
|
r1256 | mkdir -p build/html build/doctrees | ||
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) build/html | ||||
@echo | ||||
@echo "Build finished. The HTML pages are in build/html." | ||||
Thomas Kluyver
|
r18294 | automagic: source/interactive/magics-generated.txt | ||
Thomas Kluyver
|
r18296 | source/interactive/magics-generated.txt: autogen_magics.py | ||
r21749 | $(PYTHON) autogen_magics.py | |||
Thomas Kluyver
|
r18294 | @echo "Created docs for line & cell magics" | ||
klonuo
|
r22516 | autoconfig: source/config/options/config-generated.txt | ||
Thomas Kluyver
|
r13459 | |||
klonuo
|
r22590 | source/config/options/config-generated.txt: | ||
r21749 | $(PYTHON) autogen_config.py | |||
Thomas Kluyver
|
r13459 | @echo "Created docs for config options" | ||
Paul Ivanov
|
r11758 | api: source/api/generated/gen.txt | ||
Fernando Perez
|
r2535 | |||
Paul Ivanov
|
r11758 | source/api/generated/gen.txt: | ||
r21749 | $(PYTHON) autogen_api.py | |||
Fernando Perez
|
r1850 | @echo "Build API docs finished." | ||
Matthias Bussonnier
|
r22623 | autogen_shortcuts: autogen_shortcuts.py ../IPython/terminal/interactiveshell.py source/config/shortcuts/index.rst | ||
klonuo
|
r22590 | $(PYTHON) autogen_shortcuts.py | ||
@echo "Created docs for shortcuts" | ||||
Brian E Granger
|
r1256 | pickle: | ||
mkdir -p build/pickle build/doctrees | ||||
$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) build/pickle | ||||
@echo | ||||
@echo "Build finished; now you can process the pickle files or run" | ||||
@echo " sphinx-web build/pickle" | ||||
@echo "to start the sphinx-web server." | ||||
web: pickle | ||||
htmlhelp: | ||||
mkdir -p build/htmlhelp build/doctrees | ||||
$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) build/htmlhelp | ||||
@echo | ||||
@echo "Build finished; now you can run HTML Help Workshop with the" \ | ||||
".hhp project file in build/htmlhelp." | ||||
Thomas Kluyver
|
r13459 | latex: api autoconfig | ||
Brian E Granger
|
r1256 | mkdir -p build/latex build/doctrees | ||
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) build/latex | ||||
@echo | ||||
@echo "Build finished; the LaTeX files are in build/latex." | ||||
@echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \ | ||||
"run these through (pdf)latex." | ||||
changes: | ||||
mkdir -p build/changes build/doctrees | ||||
$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) build/changes | ||||
@echo | ||||
@echo "The overview file is in build/changes." | ||||
linkcheck: | ||||
mkdir -p build/linkcheck build/doctrees | ||||
$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) build/linkcheck | ||||
@echo | ||||
@echo "Link check complete; look for any errors in the above output " \ | ||||
Paul Ivanov
|
r11730 | "or in build/linkcheck/output.rst." | ||
Fernando Perez
|
r2599 | |||
Takafumi Arakaki
|
r10009 | texinfo: | ||
mkdir -p $(BUILDDIR)/texinfo | ||||
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo | ||||
@echo | ||||
@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo." | ||||
@echo "Run \`make' in that directory to run these through makeinfo" \ | ||||
"(use \`make info' here to do that automatically)." | ||||
info: | ||||
mkdir -p $(BUILDDIR)/texinfo | ||||
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo | ||||
@echo "Running Texinfo files through makeinfo..." | ||||
make -C $(BUILDDIR)/texinfo info | ||||
@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo." | ||||