- Added centralised makefiles for lectures.

nigel.stanger / Handbook

Browse code - Added centralised makefiles for lectures. master
1 parent 432a9a1 commit a11f3a0332b35e372dbc83e0f0ff48cc8165c422 nstanger authored on 8 Jul 2005

Patch

Showing 2 changed files

Ignore Space Show notes View make-includes/build_lecture_rules.make 0 → 100755
################################################################################ # # File: $Id$ # # Standard variables and rules for building a set of lecture files. # Altering these definitions will affect ALL LECTURE MAKEFILES FOR ALL # PAPERS!! If you need to do something specific for a particular paper, # include a custom rule in its makefile. DON'T add it here! # ################################################################################ ################################################################################ # # Standard file suffixes. # .SUFFIXES: .SUFFIXES: .pdf .tex .graffle .png .tif .plo ################################################################################ # # Standard directories. # IMGDIR=images ################################################################################ # # Standard paths. # vpath %.graffle $(IMGDIR) vpath %.pdf $(IMGDIR) vpath %.png $(IMGDIR) vpath %.tif $(IMGDIR) vpath %.plo $(IMGDIR) ################################################################################ # # Standard file list variables. # # List of images used in the presentation as actual content. # SLIDE_IMAGES= # # List of images used in the presentation as backgrounds or watermarks. # SLIDE_BACKGROUNDS= # # List of images used in the figures and examples document. # FIG_IMAGES= # # Files to be cleaned by the various "clean" targets. # TIDY_FILES=.tmp .aux .out .log .nav .toc .snm .head .dvi \ slides-combined.pdf slides-notes.pdf CLEAN_FILES=.pdf ################################################################################ # # Various environment variables. # # Set DRAFT to anything to run in draft mode (e.g., make DRAFT=draft xxx). # DRAFT= # # Specify LaTeX document options (comma-separated list) # LATEX_OPTS=pdftex,usepdftitle=false,$(DRAFT) # # Base file names for the various documents. # SLIDES?=Chapter$(CHAPTER)slides FIGURES?=Chapter$(CHAPTER)figures COMBINED?=Chapter$(CHAPTER)combined NOTES?=Chapter$(CHAPTER)notes # # List of standard "phony" build targets. # TARGETS=all slides notes slides-combined slides-notes figures combined \ debug test clean tidy targets # .PHONY: $(TARGETS) ################################################################################ # # Display a message if someone tries to build a target that has been # disabled (by setting the appropriate variable to empty in the makefile). # disabled_message=@echo The \"$(1)\" target has been disabled for this chapter. ################################################################################ # # Build everything. # all: slides notes figures combined ifneq ($(strip $(SLIDES)),) ################################################################################ # # Set the prerequisites for the "slides" build target, depending on # whether the figures document exists. # ifeq ($(strip $(FIGURES)),) SLIDES_PREREQS:=$(SLIDES).pdf else SLIDES_PREREQS:=figures $(SLIDES).pdf endif ################################################################################ # # Build the slides for the presentation. Include the figures .aux file for # inter-document cross-references, but only if $(FIGURES) is non-empty. If # $(SLIDES) is empty, these rules are ignored. # slides: $(SLIDES_PREREQS) $(SLIDES).pdf: $(SLIDES).tex $(SLIDE_IMAGES) pdflatex --jobname=$(SLIDES) '\documentclass[$(LATEX_OPTS)]{beamer}\input{$(SLIDES)}' pdflatex --jobname=$(SLIDES) '\documentclass[$(LATEX_OPTS)]{beamer}\input{$(SLIDES)}' else slides: $(call disabled_message,$@) endif ifneq ($(strip $(NOTES)),) ################################################################################ # # Build the slides with notes. If $(NOTES) is empty, these rules are # ignored. # slides-notes: slides-notes.pdf slides-notes.pdf: $(SLIDES).tex $(SLIDE_IMAGES) pdflatex --jobname=slides-notes '\documentclass[$(LATEX_OPTS),notes=onlyslideswithnotes]{beamer}\input{$(SLIDES)}' pdflatex --jobname=slides-notes '\documentclass[$(LATEX_OPTS),notes=onlyslideswithnotes]{beamer}\input{$(SLIDES)}' ################################################################################ # # Build the slides with notes, 6-up. If $(NOTES) is empty, these rules are # ignored. # notes: $(NOTES).pdf $(NOTES).pdf: slides-notes.pdf pdfnup --nup 2x3 --outfile $@ $< else notes slides-notes: $(call disabled_message,$@) endif ifneq ($(strip $(COMBINED)),) ################################################################################ # # Set the prerequisites for the "combined" build target, depending on # whether the figures document exists. # ifeq ($(strip $(FIGURES)),) COMBINED_PREREQS:=$(COMBINED).tex slides-combined.pdf else COMBINED_PREREQS:=$(COMBINED).tex slides-combined.pdf $(FIGURES).pdf endif ################################################################################ # # Build the slides for the combined document. If $(COMBINED) is empty, # these rules are ignored. # slides-combined: slides-combined.pdf slides-combined.pdf: $(SLIDES).tex $(SLIDE_IMAGES) pdflatex --jobname=slides-combined '\documentclass[$(LATEX_OPTS),handout]{beamer}\input{$(SLIDES)}' pdflatex --jobname=slides-combined '\documentclass[$(LATEX_OPTS),handout]{beamer}\input{$(SLIDES)}' ################################################################################ # # Build the complete combined document. If $(COMBINED) is empty, these # rules are ignored. If $(FIGURES) is empty, they are omitted from the # combined document. # combined: $(COMBINED).pdf $(COMBINED).pdf: $(COMBINED_PREREQS) pdflatex $< pdflatex $< else combined slides-combined: $(call disabled_message,$@) endif ifneq ($(strip $(FIGURES)),) ################################################################################ # # Build the figures and examples document. If $(FIGURES) is empty, # these rules are ignored. # figures: $(FIGURES).pdf $(FIGURES).pdf: $(FIGURES).tex $(FIG_IMAGES) pdflatex $< pdflatex $< else figures: $(call disabled_message,$@) endif ################################################################################ # # Build the test document. # test: test.pdf test.pdf: test.tex ################################################################################ # # Debugging: print the values of the standard variables. # debug: @announce Externally defined variables @echo "TEACHING_SHARED = [$(TEACHING_SHARED)]" @echo "CHAPTER = [$(CHAPTER)]" @announce Internally defined variables @echo "GLOBAL_HANDBOOK_INCLUDE = [$(GLOBAL_HANDBOOK_INCLUDE)]" @echo "SLIDE_IMAGES = [$(SLIDE_IMAGES)]" @echo "SLIDE_BACKGROUNDS = [$(SLIDE_BACKGROUNDS)]" @echo "FIG_IMAGES = [$(FIG_IMAGES)]" @echo "TIDY_FILES = [$(TIDY_FILES)]" @echo "CLEAN_FILES = [$(CLEAN_FILES)]" @echo "DRAFT = [$(DRAFT)]" @echo "LATEX_OPTS = [$(LATEX_OPTS)]" @echo "SLIDES = [$(SLIDES)]" @echo "FIGURES = [$(FIGURES)]" @echo "COMBINED = [$(COMBINED)]" @echo "NOTES = [$(NOTES)]" @echo "SLIDES_PREREQS = [$(SLIDES_PREREQS)]" @echo "COMBINED_PREREQS = [$(COMBINED_PREREQS)]" @echo "TARGETS = [$(TARGETS)]" ################################################################################ # # Clean up: get rid of all the temporary files. # tidy: rm -f $(TIDY_FILES) # # Clean up: get rid of everything except the original source. # clean: tidy rm -f $(CLEAN_FILES) ################################################################################ # # List all "phony" build targets. # targets: @echo "targets: $(TARGETS)" ################################################################################ # # Standard default rules. # # PDF from LaTeX via DVI, typically for images drawn using PSTricks). # %.pdf: $(IMGDIR)/%.tex latex --jobname=$(IMGDIR)/$* $< dvips -q -f $(IMGDIR)/$* \| ps2eps -q -l \| epstopdf -f -o=$(IMGDIR)/$@ # # PDF from LaTeX. # %.pdf: %.tex pdflatex $< pdflatex $< # # PDF from OmniGraffle. (We can't automate this.) # %.pdf: %.graffle @echo "$(notdir $<): regenerate $(notdir $@)" @exit 1 # # PNG from TIFF. # %.png: %.tif convert "$<" $(IMGDIR)/$@ # # PDF from Ploticus. # %.pdf: %.plo ploticus -eps -tightcrop -o stdout $< \| shiftbbox \| epstopdf --filter --outfile=$(IMGDIR)/$@

Ignore Space Show notes View

make-includes/build_lecture_rules.make 0 → 100755

################################################################################
#
# File: $Id$
#
# Standard variables and rules for building a set of lecture files.
# Altering these definitions will affect ALL LECTURE MAKEFILES FOR ALL
# PAPERS!! If you need to do something specific for a particular paper,
# include a custom rule in its makefile. DON'T add it here!
#
################################################################################

################################################################################
#
# Standard file suffixes.
#
.SUFFIXES:
.SUFFIXES: .pdf .tex .graffle .png .tif .plo

################################################################################
#
# Standard directories.
#
IMGDIR=images

################################################################################
#
# Standard paths.
#
vpath %.graffle $(IMGDIR)
vpath %.pdf $(IMGDIR)
vpath %.png $(IMGDIR)
vpath %.tif $(IMGDIR)
vpath %.plo $(IMGDIR)

################################################################################
#
# Standard file list variables.
#
# List of images used in the presentation as actual content.
#
SLIDE_IMAGES=
#
# List of images used in the presentation as backgrounds or watermarks.
#
SLIDE_BACKGROUNDS=
#
# List of images used in the figures and examples document.
#
FIG_IMAGES=
#
# Files to be cleaned by the various "clean" targets.
#
TIDY_FILES=*.tmp *.aux *.out *.log *.nav *.toc *.snm *.head *.dvi \
	slides-combined.pdf slides-notes.pdf
CLEAN_FILES=*.pdf

################################################################################
#
# Various environment variables.
#
# Set DRAFT to anything to run in draft mode (e.g., make DRAFT=draft xxx).
#
DRAFT=
#
# Specify LaTeX document options (comma-separated list)
#
LATEX_OPTS=pdftex,usepdftitle=false,$(DRAFT)
#
# Base file names for the various documents.
#
SLIDES?=Chapter$(CHAPTER)slides
FIGURES?=Chapter$(CHAPTER)figures
COMBINED?=Chapter$(CHAPTER)combined
NOTES?=Chapter$(CHAPTER)notes
#
# List of standard "phony" build targets.
#
TARGETS=all slides notes slides-combined slides-notes figures combined \
	debug test clean tidy targets
#
.PHONY: $(TARGETS)

################################################################################
#
# Display a message if someone tries to build a target that has been
# disabled (by setting the appropriate variable to empty in the makefile).
#
disabled_message=@echo The \"$(1)\" target has been disabled for this chapter.

################################################################################
#
# Build everything.
#
all: slides notes figures combined

ifneq ($(strip $(SLIDES)),)
################################################################################
#
# Set the prerequisites for the "slides" build target, depending on
# whether the figures document exists.
#
ifeq ($(strip $(FIGURES)),)
SLIDES_PREREQS:=$(SLIDES).pdf
else
SLIDES_PREREQS:=figures $(SLIDES).pdf
endif

################################################################################
#
# Build the slides for the presentation. Include the figures .aux file for
# inter-document cross-references, but only if $(FIGURES) is non-empty. If
# $(SLIDES) is empty, these rules are ignored.
#
slides: $(SLIDES_PREREQS)

$(SLIDES).pdf: $(SLIDES).tex $(SLIDE_IMAGES)
	pdflatex --jobname=$(SLIDES) '\documentclass[$(LATEX_OPTS)]{beamer}\input{$(SLIDES)}'
	pdflatex --jobname=$(SLIDES) '\documentclass[$(LATEX_OPTS)]{beamer}\input{$(SLIDES)}'

else

slides:
	$(call disabled_message,$@)

endif

ifneq ($(strip $(NOTES)),)
################################################################################
#
# Build the slides with notes. If $(NOTES) is empty, these rules are
# ignored.
#
slides-notes: slides-notes.pdf

slides-notes.pdf: $(SLIDES).tex $(SLIDE_IMAGES)
	pdflatex --jobname=slides-notes '\documentclass[$(LATEX_OPTS),notes=onlyslideswithnotes]{beamer}\input{$(SLIDES)}'
	pdflatex --jobname=slides-notes '\documentclass[$(LATEX_OPTS),notes=onlyslideswithnotes]{beamer}\input{$(SLIDES)}'

################################################################################
#
# Build the slides with notes, 6-up. If $(NOTES) is empty, these rules are
# ignored.
#
notes: $(NOTES).pdf

$(NOTES).pdf: slides-notes.pdf
	pdfnup --nup 2x3 --outfile $@ $<

else

notes slides-notes:
	$(call disabled_message,$@)

endif

ifneq ($(strip $(COMBINED)),)
################################################################################
#
# Set the prerequisites for the "combined" build target, depending on
# whether the figures document exists.
#
ifeq ($(strip $(FIGURES)),)
COMBINED_PREREQS:=$(COMBINED).tex slides-combined.pdf
else
COMBINED_PREREQS:=$(COMBINED).tex slides-combined.pdf $(FIGURES).pdf
endif

################################################################################
#
# Build the slides for the combined document. If $(COMBINED) is empty,
# these rules are ignored.
#
slides-combined: slides-combined.pdf

slides-combined.pdf: $(SLIDES).tex $(SLIDE_IMAGES)
	pdflatex --jobname=slides-combined '\documentclass[$(LATEX_OPTS),handout]{beamer}\input{$(SLIDES)}'
	pdflatex --jobname=slides-combined '\documentclass[$(LATEX_OPTS),handout]{beamer}\input{$(SLIDES)}'

################################################################################
#
# Build the complete combined document. If $(COMBINED) is empty, these
# rules are ignored. If $(FIGURES) is empty, they are omitted from the
# combined document.
#
combined: $(COMBINED).pdf

$(COMBINED).pdf: $(COMBINED_PREREQS)
	pdflatex $<
	pdflatex $<

else

combined slides-combined:
	$(call disabled_message,$@)

endif

ifneq ($(strip $(FIGURES)),)
################################################################################
#
# Build the figures and examples document. If $(FIGURES) is empty,
# these rules are ignored.
#
figures: $(FIGURES).pdf

$(FIGURES).pdf:	$(FIGURES).tex $(FIG_IMAGES)
	pdflatex $<
	pdflatex $<

else

figures:
	$(call disabled_message,$@)

endif

################################################################################
#
# Build the test document.
#
test: test.pdf

test.pdf: test.tex

################################################################################
#
# Debugging: print the values of the standard variables.
#
debug:
	@announce Externally defined variables
	@echo "TEACHING_SHARED = [$(TEACHING_SHARED)]"
	@echo "CHAPTER = [$(CHAPTER)]"
	@announce Internally defined variables
	@echo "GLOBAL_HANDBOOK_INCLUDE = [$(GLOBAL_HANDBOOK_INCLUDE)]"
	@echo "SLIDE_IMAGES = [$(SLIDE_IMAGES)]"
	@echo "SLIDE_BACKGROUNDS = [$(SLIDE_BACKGROUNDS)]"
	@echo "FIG_IMAGES = [$(FIG_IMAGES)]"
	@echo "TIDY_FILES = [$(TIDY_FILES)]"
	@echo "CLEAN_FILES = [$(CLEAN_FILES)]"
	@echo "DRAFT = [$(DRAFT)]"
	@echo "LATEX_OPTS = [$(LATEX_OPTS)]"
	@echo "SLIDES = [$(SLIDES)]"
	@echo "FIGURES = [$(FIGURES)]"
	@echo "COMBINED = [$(COMBINED)]"
	@echo "NOTES = [$(NOTES)]"
	@echo "SLIDES_PREREQS = [$(SLIDES_PREREQS)]"
	@echo "COMBINED_PREREQS = [$(COMBINED_PREREQS)]"
	@echo "TARGETS = [$(TARGETS)]"

################################################################################
#
# Clean up: get rid of all the temporary files.
#
tidy:
	rm -f $(TIDY_FILES)
#
# Clean up: get rid of everything except the original source.
#
clean: tidy
	rm -f $(CLEAN_FILES)

################################################################################
#
# List all "phony" build targets.
#
targets:
	@echo "targets: $(TARGETS)"

################################################################################
#
# Standard default rules.
#
# PDF from LaTeX via DVI, typically for images drawn using PSTricks).
# 
%.pdf: $(IMGDIR)/%.tex
	latex --jobname=$(IMGDIR)/$* $<
	dvips -q -f $(IMGDIR)/$* | ps2eps -q -l | epstopdf -f -o=$(IMGDIR)/$@
#
# PDF from LaTeX.
#
%.pdf: %.tex
	pdflatex $<
	pdflatex $<
#
# PDF from OmniGraffle. (We can't automate this.)
#
%.pdf: %.graffle
	@echo "$(notdir $<): regenerate $(notdir $@)"
	@exit 1
#
# PNG from TIFF.
#
%.png: %.tif
	convert "$<" $(IMGDIR)/$@
#
# PDF from Ploticus.
#
%.pdf: %.plo
	ploticus -eps -tightcrop -o stdout $< | shiftbbox | epstopdf --filter --outfile=$(IMGDIR)/$@

Ignore Space Show notes View makefile-templates/Makefile.lecture 0 → 100755
################################################################################ # # File: $Id$ # # Template makefile for building a set of lecture files. # ################################################################################ SHELL=/bin/sh ################################################################################ # # Required Environment Variables # # TEACHING_SHARED # This variable specifies the path to the top level of the teaching # shared directory hierarchy (e.g., /path/to/Teaching/Shared). # TEACHING_SHARED?=$(error The required environment variable TEACHING_SHARED has not been defined. It should point to the root level of the shared teaching directory (e.g., /path/to/Teaching/Shared)) ################################################################################ # # Set up paths to makefile include directories. # # GLOBAL_HANDBOOK_INCLUDE is the global include directory in the "Shared" # hierarchy, and is defined relative to the root of that hierarchy. # GLOBAL_HANDBOOK_INCLUDE?=$(TEACHING_SHARED)/Authoring/Handbook/make-includes ################################################################################ # # Specify the current lecture chapter number. This must be defined! # CHAPTER?=$(error The required variable CHAPTER has not been defined. Please set it to the correct chapter number for this set of lectures) ################################################################################ # # Uncomment any of the following to prevent a particular document from # being built. This is necessary if, for example, the current set of # lectures has no figures and examples. # # SLIDES= # FIGURES= # COMBINED= # NOTES= ################################################################################ # # Include standard variables and rules for building lectures. # include $(GLOBAL_HANDBOOK_INCLUDE)/build_lecture_rules.make ################################################################################ # # Add custom rules below here as necessary, and uncomment and modify the # variables as appropriate. # # Add extra file suffixes here. # # .SUFFIXES: # # Add extra LaTeX document options here. # # LATEX_OPTS+= # # Add extra "phony" build targets here (you still need to define rules for # them!). # # TARGETS+= # # Add extra vpaths here. # # vpath %.blah foo # # Add extra files to be deleted by the "clean" targets here. # $(TIDY_FILES) is a list of generated intermediate files to clean up. # $(CLEAN_FILES) is everything else that might need to be cleaned up. # # TIDY_FILES+= # CLEAN_FILES+= # # Add extra image files of various sorts here. (Slide backgrounds are # images used as backgrounds to slides or watermarks, rather than as # actual content.) # # SLIDE_IMAGES+= # SLIDE_BACKGROUNDS+= # FIG_IMAGES+=

Ignore Space Show notes View

makefile-templates/Makefile.lecture 0 → 100755

################################################################################
#
# File: $Id$
#
# Template makefile for building a set of lecture files.
#
################################################################################

SHELL=/bin/sh

################################################################################
#
# Required Environment Variables
#
# TEACHING_SHARED
#	This variable specifies the path to the top level of the teaching
#	shared directory hierarchy (e.g., /path/to/Teaching/Shared).
#
TEACHING_SHARED?=$(error The required environment variable TEACHING_SHARED has not been defined. It should point to the root level of the shared teaching directory (e.g., /path/to/Teaching/Shared))

################################################################################
#
# Set up paths to makefile include directories.
#
# GLOBAL_HANDBOOK_INCLUDE is the global include directory in the "Shared"
# hierarchy, and is defined relative to the root of that hierarchy.
#
GLOBAL_HANDBOOK_INCLUDE?=$(TEACHING_SHARED)/Authoring/Handbook/make-includes

################################################################################
#
# Specify the current lecture chapter number. This must be defined!
#
CHAPTER?=$(error The required variable CHAPTER has not been defined. Please set it to the correct chapter number for this set of lectures)

################################################################################
#
# Uncomment any of the following to prevent a particular document from
# being built. This is necessary if, for example, the current set of
# lectures has no figures and examples.
#
# SLIDES=
# FIGURES=
# COMBINED=
# NOTES=

################################################################################
#
# Include standard variables and rules for building lectures.
#
include $(GLOBAL_HANDBOOK_INCLUDE)/build_lecture_rules.make

################################################################################
#
# Add custom rules below here as necessary, and uncomment and modify the
# variables as appropriate.
#
# Add extra file suffixes here.
#
# .SUFFIXES: 
#
# Add extra LaTeX document options here.
#
# LATEX_OPTS+=
#
# Add extra "phony" build targets here (you still need to define rules for
# them!).
#
# TARGETS+=
#
# Add extra vpaths here.
#
# vpath %.blah foo
#
# Add extra files to be deleted by the "clean" targets here.
# $(TIDY_FILES) is a list of generated intermediate files to clean up.
# $(CLEAN_FILES) is everything else that might need to be cleaned up.
#
# TIDY_FILES+=
# CLEAN_FILES+=
#
# Add extra image files of various sorts here. (Slide backgrounds are
# images used as backgrounds to slides or watermarks, rather than as
# actual content.)
#
# SLIDE_IMAGES+=
# SLIDE_BACKGROUNDS+=
# FIG_IMAGES+=

Show line notes below