# Settings
MAKEFILES=Makefile $(wildcard *.mk)
JEKYLL=jekyll
-JEKYLL_VERSION=3.7.3
+JEKYLL_VERSION=3.8.5
PARSER=bin/markdown_ast.rb
DST=_site
+# Check Python 3 is installed and determine if it's called via python3 or python
+# (https://stackoverflow.com/a/4933395)
+ifneq (, $(shell which python3 2>/dev/null))
+ PYTHON := python3
+else ifneq (, $(shell which python 2>/dev/null))
+ PYTHON_VERSION_FULL := $(wordlist 2,4,$(subst ., ,$(shell python --version 2>&1)))
+ PYTHON_VERSION_MAJOR := $(word 1,${PYTHON_VERSION_FULL})
+ ifneq (3, ${PYTHON_VERSION_MAJOR})
+ $(error "Your system does not appear to have Python 3 installed.")
+ endif
+ PYTHON := python
+else
+ $(error "Your system does not appear to have any Python installed.")
+endif
+
+
# Controls
.PHONY : commands clean files
.NOTPARALLEL:
## commands : show all commands.
commands :
- @grep -h -E '^##' ${MAKEFILES} | sed -e 's/## //g'
+ @grep -h -E '^##' ${MAKEFILES} | sed -e "s/## //g"
## docker-serve : use docker to build the site
docker-serve :
## workshop-check : check workshop homepage.
workshop-check :
- @bin/workshop_check.py .
+ @${PYTHON} bin/workshop_check.py .
## ----------------------------------------
## Commands specific to lesson websites.
## lesson-md : convert Rmarkdown files to markdown
lesson-md : ${RMD_DST}
-# Use of .NOTPARALLEL makes rule execute only once
-${RMD_DST} : ${RMD_SRC}
- @bin/knit_lessons.sh ${RMD_SRC}
+_episodes/%.md: _episodes_rmd/%.Rmd
+ @bin/knit_lessons.sh $< $@
## lesson-check : validate lesson Markdown.
lesson-check : lesson-fixme
- @bin/lesson_check.py -s . -p ${PARSER} -r _includes/links.md
+ @${PYTHON} bin/lesson_check.py -s . -p ${PARSER} -r _includes/links.md
## lesson-check-all : validate lesson Markdown, checking line lengths and trailing whitespace.
lesson-check-all :
- @bin/lesson_check.py -s . -p ${PARSER} -r _includes/links.md -l -w --permissive
+ @${PYTHON} bin/lesson_check.py -s . -p ${PARSER} -r _includes/links.md -l -w --permissive
## unittest : run unit tests on checking tools.
unittest :
- @bin/test_lesson_check.py
+ @${PYTHON} bin/test_lesson_check.py
## lesson-files : show expected names of generated files for debugging.
lesson-files :