Makefile

SITE=https://www.perl.com

HUGO=hugo

JSON_DIRNAME=json
JSON_LOCAL_DIR=static/$(JSON_DIRNAME)

DEPLOYED_TAG_NAME=deployed

BUILD_JSON_FILE=build.json
BUILD_JSON_URL=$(SITE)/$(JSON_DIRNAME)/$(BUILD_JSON_FILE)

.PHONY: new
new: ## start a new article
	perl bin/new-article

.PHONY: json
json: ## create the JSON files (static/json)
	perl bin/collate_metadata
	perl bin/tag_the_build > $(JSON_LOCAL_DIR)/$(BUILD_JSON_FILE)

.PHONY: contributors
contributors:
	perl bin/list_contributors > content/contributors.md

.PHONY: start
start: json contributors ## start the local server
	hugo server --buildDrafts --buildFuture --disableFastRender -d built

.PHONY: legacy-start
legacy-start: json contributors ## start the local server
	docker run --rm -it -v $(PWD):/src -p 1313:1313 klakegg/hugo:0.59.1-ubuntu server --buildDrafts --buildFuture --disableFastRender -d built

.PHONY: deploy
deploy: on_master json contributors ## deploy the website to the static repo
	bin/deploy
	git tag -d $(DEPLOYED_TAG_NAME)
	- git push origin --delete $(DEPLOYED_TAG_NAME)
	git tag $(DEPLOYED_TAG_NAME)
	git push origin --tags

.PHONY: show_drafts
show_drafts: ## show a list of drafts
	grep -R '"draft" : true' content

.PHONY: show_live_build
show_live_build: ## show the build data for the live site
	- perl bin/site-is-fresh

.PHONY: refresh_tags
refresh_tags: ## sync the tags with the repo
	git fetch --tags --force

.PHONY: on_master
on_master:
	@ perl -le 'die "Must be on master to run this target" if `git rev-parse --abbrev-ref HEAD` !~ /\Amaster\Z/'

######################################################################
# https://marmelab.com/blog/2016/02/29/auto-documented-makefile.html
.PHONY: help ## Show all the Makefile targets with descriptions
help: ## show a list of targets
	@grep -E '^[a-zA-Z][/a-zA-Z0-9_.-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'