2018-04-20 15:27:59 +00:00
|
|
|
#!/usr/bin/make -f
|
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
## Configure this part if you wish to
|
|
|
|
DEPLOY_REPO=
|
|
|
|
DEPLOY_OPTS=
|
|
|
|
BUILD_DIR=_build
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
## Find slides
|
|
|
|
SLIDES_MD=$(shell find slides \( -name '*.md' ! -name '_*' \))
|
|
|
|
SLIDES_PDF=$(patsubst slides/%.md,$(BUILD_DIR)/slides/%.pdf,$(SLIDES_MD))
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
all: help
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
##
|
|
|
|
## Install prerequisites
|
|
|
|
##
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
prepare: prepare-slides prepare-docs ## install prerequisites
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
prepare-slides: ## install prerequisites for PDF slides only
|
|
|
|
npm install
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
prepare-docs: ## install prerequisites for static docs site only
|
|
|
|
pipenv install
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
.PHONY: prepare prepare-slides prepare-docs
|
2018-04-20 15:27:59 +00:00
|
|
|
|
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
watch: ## run development server
|
|
|
|
pipenv run honcho start
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
watch-slides: ## run development server for PDF slides
|
|
|
|
npx marp --engine $$(pwd)/.marp/engine.js --html --theme $$(pwd)/.marp/theme.css -w slides -s
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
watch-docs: ## run development server for static docs site
|
|
|
|
pipenv run mkdocs serve --dev-addr 0.0.0.0:5001
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
serve: watch
|
|
|
|
serve-slides: watch-slides
|
|
|
|
serve-docs: watch-docs
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
.PHONY: watch watch-slides watch-docs serve serve-docs serve-slides
|
2018-04-20 15:27:59 +00:00
|
|
|
|
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
tocupdate:
|
|
|
|
while inotifywait -q -e move -e modify -e create -e attrib -e delete -r docs ; do \
|
|
|
|
sleep 1 ; \
|
|
|
|
pipenv run ./scripts/update-toc ; \
|
|
|
|
done
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
$(BUILD_DIR)/slides/%.pdf: slides/%.md
|
|
|
|
mkdir -p $(BUILD_DIR)/slides
|
|
|
|
npx marp --allow-local-files \
|
|
|
|
--engine $$(pwd)/engine.js \
|
|
|
|
--html \
|
|
|
|
--theme theme.css \
|
|
|
|
$< \
|
|
|
|
-o $@
|
2018-04-20 15:27:59 +00:00
|
|
|
|
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
##
|
|
|
|
## Build final documents
|
|
|
|
##
|
|
|
|
## slides => PDF
|
|
|
|
## docs => static web site
|
|
|
|
##
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
build: build-docs build-slides ## build all documents
|
2018-04-20 15:27:59 +00:00
|
|
|
|
2020-04-19 10:03:37 +00:00
|
|
|
build-slides: $(SLIDES_PDF) $(SLIDES_MD) ## build PDF slides only
|
|
|
|
|
|
|
|
build-docs: ## build static docs site only
|
|
|
|
pipenv run mkdocs build --site-dir $(BUILD_DIR)/docs
|
|
|
|
|
|
|
|
.PHONY: build build-slides
|
|
|
|
|
|
|
|
deploy-docs: ## deploy static docs site to github
|
|
|
|
git push $(DEPLOY_REPO)
|
|
|
|
pipenv run mkdocs gh-deploy $(DEPLOY_OPTS)
|
|
|
|
|
|
|
|
help: ## print this help
|
|
|
|
@echo "Usage: make <target>"
|
|
|
|
@echo ""
|
|
|
|
@echo "With one of following targets:"
|
|
|
|
@echo ""
|
|
|
|
@awk 'BEGIN {FS = ":.*?## "} \
|
|
|
|
/^[a-zA-Z_-]+:.*?## / \
|
|
|
|
{ sub("\\\\n",sprintf("\n%22c"," "), $$2); \
|
|
|
|
printf("\033[36m%-20s\033[0m %s\n", $$1, $$2); \
|
|
|
|
}' $(MAKEFILE_LIST)
|
|
|
|
@echo ""
|
|
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
## Clean
|
|
|
|
##
|
|
|
|
|
|
|
|
clean: clean-slides clean-docs # remove generated documents
|
|
|
|
|
|
|
|
clean-slides:
|
|
|
|
rm -fr $(BUILD_DIR)/slides # remove generated PDF slides
|
|
|
|
|
|
|
|
clean-docs:
|
|
|
|
rm -fr $(BUILD_DIR)/docs # remove generated static docs site
|
|
|
|
|
|
|
|
.PHONY: clean clean-slides clean-docs
|
2018-04-20 15:27:59 +00:00
|
|
|
|