latex

LaTeX public documents, templates, Biber files, and inputs.

Directories

Directories	Description
bib	Directory for BibTeX and BibLaTeX files
doc	Directory for my working LaTeX documents
images	Directory for images used in LaTeX documents.
input	Directory for \input files used in LaTeX documents.
templates	Directory for template LaTeX documents of various kinds in various formats.

Files

Files	Description
Makefile	gmake file to build all .PDF files from LaTeX source using latexmk.
README.md	This file.
clean.py	A Python script to clean up LaTeX intermediate files. (Used by clean and clean-pdf make targets.)

Tools

Makefile (the single makefile in this project) uses latexmk which '…is a perl script for running LaTeX the correct number of times to resolve cross references, etc; it also runs auxiliary programs (bibtex, makeindex if necessary, and dvips and/or a previewer as requested).' Makefile has standard targets all, clean, and clean-pdf.

• The all target will build all directories in DIRS ?= doc/apcs doc/bhs doc/dlcs doc/gre doc/math doc/random doc/white-papers templates. Each of these directories are also targets that can be built individually.
• make clean removes all LaTeX intermediate files in $(DIRS). make clean-pdf additionally removes all .PDF files in $(DIRS) so they can be rebuilt.
• make DIRS=example will build any of the example directories in $(DIRS) (or $(OTHER)).
• make is equivalent to make all. make -s will only echo directories and files being built.

Makefile can also build other directories (not under source control).

• The other target will build all directories in OTHER ?= apcs apcsp correspondence cv ga harvard-dce ia ig jobs pc1 princeton psb robotics stanford-logic uml wps MassBay. Each of these directories are also targets that can be built individually.
• make clean-all removes all LaTeX intermediate files in $(DIRS) $(OTHER). make clean-all-pdf additionally removes all .PDF files in $(DIRS) $(OTHERS) so they can be rebuilt.

It is possible to clean up intermediate files after making using latexmk -c -cd or latexmk -C -cd (which includes 'dvi, postscript and pdf files'), but all files would also be rebuilt in the process.

The make clean* targets use clean.py. The clean.py command-line options are listed below.

~ % python3 clean.py -h
usage: clean.py [-h] [-e EXT] [-n] [-v] [files ...]

Delete extraneous TeX files from subdirectories.

positional arguments:
  files              .TEX files to clean.

options:
  -h, --help         show this help message and exit
  -e EXT, --ext EXT  Extension(s) to add to .gitignore extension list.
  -n, --dry-run      Log file removal without actual file deletion.
  -v, --verbose      Print verbose output.

Removed intermediate files corresponding to the .TEX files are those .gitignore files listed in https://www.toptal.com/​developers/​gitignore/​api/​latex and those added with (zero or more) -e EXT command-line options.

TODO

• Update all documents to use \input files.

---

🔗 permalink and 🔩 repository for this page.