view website/www/Makefile @ 4703:8e34362a14f7

issue2550774: Fix generating the website documentation - the COPYING.txt file needs to be symlinked into website/www/ so the documentation can be generated correctly - add website/www/COPYING.txt to the .hgignore file so the symlinked version does not get accidentally committed to the repository - the website documentation Makefile 'clean' removes the symlinks and the generated html to return things back to the original state, which is what should happen on a 'clean'
author John Kristensen <john@jerrykan.com>
date Sun, 16 Dec 2012 13:18:11 +1100
parents 9ed905019303
children 977e0ef08406
line wrap: on
line source

TMP  := _tmp
HTML := html

.PHONY: help clean html linkcheck

help:
	@echo "Please use \`make <target>' where <target> is one of"
	@echo "  html      to make standalone HTML files"
	@echo "  linkcheck to check all external links for integrity"

clean:
	-rm -rf $(TMP) $(HTML) docs COPYING.txt

docs:
	ln -s ../../doc ./docs
	ln -s ../../COPYING.txt

html: docs
	mkdir -p $(TMP)/doctrees $(HTML)
	sphinx-build -b html -d $(TMP)/doctrees . $(HTML)

linkcheck:
	mkdir -p $(TMP)/linkcheck $(TMP)/doctrees
	sphinx-build -b linkcheck -d $(TMP)/doctrees . $(TMP)/linkcheck
	@echo
	@echo "Link check complete; look for any errors in the above output " \
	      "or in .build/linkcheck/output.txt."

Roundup Issue Tracker: http://roundup-tracker.org/