view docs/makefile @ 6847:f0a052aa924d

ci: run tests-py3 jobs on v2.0 images

We can't use v1.0 images because they still have Python 3.7.

Let's switch to using pip to install the extensions to avoid a
SetuptoolsDeprecationWarning about running setup.py directly. This also avoid
the warning about python_requires apparently.

The "running as root" warning cannot be simply avoided by using a different CI
image. We do have v2.1 images that default to ci-runner user, but no one
forbids people from running the test locally as a root user, one way or
another. Running pip as root shouldn't matter in this case, since it's not a
real system install, so this particular warning is always irrelevant.

SPHINXBUILD ?= python3 -m sphinx -b html

.PHONY: all
all: tutorials/tutorial.rst tutorials/topic-tutorial.rst static/logo-evolve.ico
	$(SPHINXBUILD) . ../html/

tutorials/tutorial.rst: tutorials/tutorial.t test2rst.py
	python3 test2rst.py $<

tutorials/topic-tutorial.rst: tutorials/topic-tutorial.t test2rst.py
	python3 test2rst.py $<

static/logo-evolve.ico: static/logo-evolve.svg
	convert -resize 36x36 $< $@

.PHONY: clean
clean:
	rm -rf ../html
	rm -f static/logo-evolve.ico
	rm -f tutorials/tutorial.rst
	rm -f tutorials/topic-tutorial.rst