Makefile

# Global variables {{{1
# ================
# Where make should look for things
VPATH = lib
vpath %.csl lib/styles
vpath %.yaml .:spec
vpath default.% lib/pandoc-templates

# Branch-specific targets and recipes {{{1
# ===================================

# Jekyll {{{2
# ------
SRC           = $(wildcard *.md)
SITE         := $(patsubst %.md,docs/%.md, $(SRC))

serve : build
	bundle exec jekyll serve 2>&1 | egrep -v 'deprecated'

build : $(SITE)
	cp -f _config.yml docs/
	bundle exec jekyll build 2>&1 | egrep -v 'deprecated'

docs/%.md : %.md spec/jekyll.yaml lib/templates/default.jekyll
	pandoc -o $@ -d spec/jekyll.yaml $<

# Install and cleanup {{{1
# ===================
# `make install` copies various config files and hooks to the .git
# directory and sets up standard empty directories:
# - link-template: sets up the template repo in a branch named `template`, for
#   when you want to update local boilerplates across different projects.
# - makedirs: creates standard folders for output (_book), received files
#   (_share), and figures (fig).
# - submodule: initializes the submodules for the CSL styles and for the
#   Reveal.js framework.
# - virtualenv: sets up a virtual environment (but you still need to activate
#   it from the command line).
.PHONY : install link-template makedirs submodule virtualenv bundle serve clean
install : link-template makedirs submodule csl virtualenv license
	bundle install

makedirs :
	-mkdir _share && mkdir _book && mkdir fig

csl : .install/git/modules/lib/styles/info/sparse-checkout
	rsync -aq .install/git/ .git/
	cd lib/styles && git config core.sparsecheckout true && \
		git checkout master && git pull && \
		git read-tree -m -u HEAD

submodule_init :
	# Generating a repo from a GitHub template breaks the submodules.
	# As a workaround, we init the submodules after cloning the template repo
	# instead of including them in the source template.
	git submodule add https://github.com/hakimel/reveal.js.git docs/reveal.js
	git submodule add https://github.com/citation-style-language/styles.git lib/styles
	git sumbodule add https://github.com/jgm/pandoc-templates.git lib/pandoc-templates

template :
	-git remote add template git@github.com:p3palazzo/research_template.git
	git fetch template
	git checkout -B template --track template/master
	git checkout -

virtualenv :
	python -m venv .venv && source .venv/bin/activate && \
		pip install -r .install/requirements.txt
	-rm -rf src

bundle :
	bundle update

license :
	source .venv/bin/activate && \
		lice --header cc_by_sa >> README.md && \
		lice cc_by_sa -f LICENSE

# `make clean` will clear out a few standard folders where only compiled
# files should be. Anything you might have placed manually in them will
# also be deleted!
clean :
	-rm -r _book/* _site/*

# vim: set foldmethod=marker :