Makefile

# This Makefile is used to generate the yii2 and yii1 api documentation and guide
#
# run `make help` for a list of available targets. Run a target with `make <target>`.
#

help:
	@echo "the following targets are available:"
	@echo ""
	@echo " - deploy       run commands after git pull for deployment on a server"
	@echo ""
	@echo " - docs         make all the docs"
	@echo " - guide        make only the guide docs"
	@echo " - guide-{v}    make only the guide docs for version {v} (1.0, 1.1, 2.0)"
	@echo " - api          make only the api docs"
	@echo " - api-{v}      make only the api docs for version {v} (1.0, 1.1, 2.0)"
	@echo " - download     make only the doc download archives"
	@echo " - download-{v} make only the doc download archives for version {v} (2.0)"

deploy:
	composer install
	npm install
	gulp build --production
	./yii migrate
	./yii cache/flush-all

docs: api guide download

api: api-1.0 api-1.1 api-2.0
guide: guide-1.0 guide-1.1 guide-2.0
# TODO: blog tutorial
download: download-2.0

api-%: yii-%
	./yii api "$(subst api-,,$@)" --interactive=0

guide-%: yii-%
	./yii guide "$(subst guide-,,$@)" --interactive=0
	@echo "PDF errors in the following logs:"
	@find data/$@/ | grep fail.log || echo " - no errors - "


download-%: TARGET_DIR=data/docs-offline
download-%: SOURCE_DIR=data/yii-$(subst download-,,$@)
download-%: DOC_DIR=yii-docs-$(subst download-,,$@)
download-%: LANGUAGES=en $(shell find ${SOURCE_DIR}/docs/ | grep -ioP 'guide-[a-z-]+$$' | cut -c 7-)
download-%: yii-%
	cd ${SOURCE_DIR}/docs && ln -sf guide guide-en
	vendor/bin/apidoc api ${SOURCE_DIR}/framework ${TARGET_DIR}/${DOC_DIR} --interactive=0
	for l in ${LANGUAGES} ; do \
		echo ""  ; \
		echo "building guide and api package for language $$l..."  ; \
		test -d ${TARGET_DIR}/${DOC_DIR}-$$l && rm -rf ${TARGET_DIR}/${DOC_DIR}-$$l  ; \
		test -f ${TARGET_DIR}/${DOC_DIR}-$$l.tar.gz && rm ${TARGET_DIR}/${DOC_DIR}-$$l.tar.gz  ; \
		test -f ${TARGET_DIR}/${DOC_DIR}-$$l.tar.bz2 && rm ${TARGET_DIR}/${DOC_DIR}-$$l.tar.bz2  ; \
		cp -ar ${TARGET_DIR}/${DOC_DIR} ${TARGET_DIR}/${DOC_DIR}-$$l  ; \
		vendor/bin/apidoc guide ${SOURCE_DIR}/docs/guide-$$l ${TARGET_DIR}/${DOC_DIR}-$$l --interactive=0  ; \
		rm -r ${TARGET_DIR}/${DOC_DIR}-$$l/cache  ; \
		cd ${TARGET_DIR} && tar czf ${DOC_DIR}-$$l.tar.gz ${DOC_DIR}-$$l ; cd - ; \
		cd ${TARGET_DIR} && tar cjf ${DOC_DIR}-$$l.tar.bz2 ${DOC_DIR}-$$l ; cd - ; \
		rm -r ${TARGET_DIR}/${DOC_DIR}-$$l  ; \
	done


# targets for cloning yii repos for building docs
yii-1.0:
	test -d data/yii-1.0 || git clone https://github.com/yiisoft/yii.git data/yii-1.0
	cd data/yii-1.0 && git checkout 1.0.12 && git checkout master build/

yii-1.1: composer
	test -d data/yii-1.1 || git clone https://github.com/yiisoft/yii.git data/yii-1.1
	cd data/yii-1.1 && git pull
	cd data/yii-1.1 && (grep "phpunit/phpunit" composer.lock > /dev/null || php ../composer.phar require --dev --prefer-dist "phpunit/phpunit:~3.7" "phpunit/phpunit-selenium:~1.4.0")

yii-2.0:
	test -d data/yii-2.0 || git clone https://github.com/yiisoft/yii2.git data/yii-2.0
	cd data/yii-2.0 && git pull

# the following targets are internal only

composer:
	cd data && (test -f composer.phar || (php -r "readfile('https://getcomposer.org/installer');" | php))

clean-es:
	./yii api/drop-elasticsearch-index --interactive=0