summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAgathe Porte <microjoe@microjoe.org>2018-05-08 12:14:14 +0200
committerAgathe Porte <microjoe@microjoe.org>2018-05-21 18:13:51 +0200
commit51292127a47911f973e1c2691a9adc75c6bad044 (patch)
tree57bfa6a687cc5255074957a705850c324b5b1462
parent2774d9fc67cd5d18fbc9b892fda9c05118272a7a (diff)
downloadlatex-makefile-1.0.tar.gz
latex-makefile-1.0.zip
Simpler version of Makefilev1.0
Instead of using a big .gitignore and a big clean target, we can tell latexmk to build into a dedicated directory. This way, all temporary files are located in a repository that we just have to ignore and remove. This allows us to have the .tex sources right next to the Makefile, which makes it easier to reason about instead of having to use the src/ subdirectory. Also moved README to reStructuredText (because Markdown sucks IMO) and removed gif and fancy badges in the README.
-rw-r--r--.gitignore18
-rw-r--r--Makefile41
-rw-r--r--README.md26
-rw-r--r--README.rst19
-rw-r--r--docs/demo.gifbin319449 -> 0 bytes
-rw-r--r--main.tex (renamed from src/main.tex)0
6 files changed, 32 insertions, 72 deletions
diff --git a/.gitignore b/.gitignore
index 49e926e..378eac2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,17 +1 @@
-*.aux
-*.fdb_latexmk
-*.fls
-*.glg
-*.glo
-*.gls
-*.glsdefs
-*.ist
-*.lof
-*.log
-*.lot
-*.out
-*.toc
-*.xdy
-*.tns
-*.pdf
-*.dvi
+build
diff --git a/Makefile b/Makefile
index 48593ca..5ad3eba 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4 +1,4 @@
-# LaTeX basic Makefile
+# LaTeX Makefile
#
# WTFPL, 2016 - 2018 Agathe Porte (MicroJoe) <microjoe@microjoe.org>
#
@@ -8,47 +8,30 @@
# Very important variables to set up
PDF=main.pdf
-PRINC=src/main.tex
+PRINC=main.tex
+AUXDIR=build
+LATEXMK=source ~/.bashrc && latexmk \
+ -auxdir=$(AUXDIR) \
+ -outdir=$(AUXDIR) \
+ -pdf -pdflatex="pdflatex -interaction=nonstopmode" -use-make
# You want latexmk to *always* run, because make does not have all the info.
# Also, include non-file targets in .PHONY so they are run regardless of any
# file of the given name existing.
-.PHONY: $(PDF) all clean
+.PHONY: $(PDF) all clean live
# Main rule: Construct the PDF
all: $(PDF)
-#
+
# Live: automatic watch and build of the PDF file
live: $(PRINC) $(SOURCES)
- source ~/.bashrc && latexmk -pvc -pdf -pdflatex="pdflatex -interaction=nonstopmode" -use-make $(PRINC)
+ $(LATEXMK) -pvc $(PRINC)
# Construct the PDF file from sources
$(PDF): $(PRINC) $(SOURCES)
- source ~/.bashrc && latexmk -pdf -pdflatex="pdflatex -interaction=nonstopmode" -use-make $(PRINC)
+ $(LATEXMK) $(PRINC)
# Remove all the intermediate files
clean:
@echo Cleaning temporary LaTeX files...
- @rm -f \
- *.aux \
- *.fdb_latexmk \
- *.fls \
- *.glg \
- *.glo \
- *.gls \
- *.glsdefs \
- *.ist \
- *.lof \
- *.log \
- *.lot \
- *.out \
- *.toc \
- *.xdy
- @echo Done
-
-mrproper: clean
- @echo Removing all PDF files...
- @rm -f *.pdf
- @echo Removing all DVI files...
- @rm -f *.dvi
- @echo Done
+ @rm -rf build
diff --git a/README.md b/README.md
deleted file mode 100644
index d00cba4..0000000
--- a/README.md
+++ /dev/null
@@ -1,26 +0,0 @@
-# A super LaTeX Makefile for large reports
-
-![License: WTFPL](https://img.shields.io/badge/license-WTFPL-blue.svg)
-
-Feel free to use this Makefile in order to render your LaTeX report easier!
-
-![Animated GIF demo of the Makefile](docs/demo.gif)
-
-## Description
-
-This Makefile uses `latexmk`, a tool that will manage any dependencies between
-LaTeX files and run the LaTeX render multiple times if needed. This is
-especially useful when you use a table of content, a glossary, or anything
-that need the LaTeX engine to run multiple times before rendering a correct
-output.
-
-*Be sure to use the provided .gitignore file too!* This will allow you to
-use git without versionning various temporary files that LaTeX produces during
-generation. Maybe all temporary files extensions are not covered. You are
-welcome to send me `.patch` files!
-
-## License
-
-Everything in this repository is released under WTFPL, so yeah, do whatever
-you want. Spread this tool in order to allow people to use LaTeX for
-everything!
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..d4d1d61
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,19 @@
+A super LaTeX Makefile for large reports
+========================================
+
+Feel free to use this Makefile in order to render your LaTeX report easier!
+
+Description
+-----------
+
+This Makefile uses ``latexmk``, a tool that will manage any dependencies
+between LaTeX files and run the LaTeX render multiple times if needed. This is
+especially useful when you use a table of content, a glossary, or anything that
+need the LaTeX engine to run multiple times before rendering a correct output.
+
+License
+-------
+
+Everything in this repository is released under WTFPL, so yeah, do whatever
+you want. Spread this tool in order to allow people to use LaTeX for
+everything!
diff --git a/docs/demo.gif b/docs/demo.gif
deleted file mode 100644
index 7910629..0000000
--- a/docs/demo.gif
+++ /dev/null
Binary files differ
diff --git a/src/main.tex b/main.tex
index 4074cff..4074cff 100644
--- a/src/main.tex
+++ b/main.tex