Rework building of documentation files
Instead of an ugly Makefile structure, we now use a single compile script that collects all the files in build/doc.
This commit is contained in:
parent
b587beb806
commit
6d8a131865
GPG key ID:
BCC5A619923C0BA5
33 changed files with 37 additions and 100 deletions
35
Makefile
35
Makefile
|
|
@ -1,11 +1,29 @@
|
|||
# Makefile for latex-packages
|
||||
|
||||
BUILD_DIR=build
|
||||
DOC_SUBDIR=doc
|
||||
PACKAGES_SUBDIR=packages
|
||||
COMPILE_SUBDIR=.compile
|
||||
BUILD_FLAGS=--recursive --git-version --pytex-version --license --author "Maximilian Keßler" --pytex-info-text --extra-header ".build/header_info.txt" --name "prepend-author" --clean-old-files
|
||||
BUILD_DIRS= --source-dir src --build-dir build
|
||||
|
||||
ROOT=$(shell pwd)
|
||||
BUILD_ROOT=${ROOT}/${BUILD_DIR}
|
||||
|
||||
|
||||
# Build packages
|
||||
build: .initsubmodulelock
|
||||
@python3 build.py ${BUILD_DIRS} ${BUILD_FLAGS}
|
||||
python3 build.py --source-dir src --build-dir ${BUILD_ROOT}/${PACKAGES_SUBDIR} ${BUILD_FLAGS}
|
||||
|
||||
# Build packages and allow repo to be dirty (use with caution and only when developing)
|
||||
dirty: .initsubmodulelock
|
||||
@python3 build.py ${BUILD_DIRS} ${BUILD_FLAGS} --allow-dirty
|
||||
python3 build.py --source-dir src --build-dir ${BUILD_ROOT}/${PACKAGES_SUBDIR} ${BUILD_FLAGS} --allow-dirty
|
||||
|
||||
# generate documentation files from /doc
|
||||
doc:
|
||||
@scripts/compile_doc.sh
|
||||
@mkdir -p ${BUILD_ROOT}/${DOC_SUBDIR}
|
||||
@cp .compile/*.pdf ${BUILD_ROOT}/${DOC_SUBDIR}
|
||||
@echo Documentation files written to ${BUILD_ROOT}/${DOC_SUBDIR}
|
||||
|
||||
init: .initsubmodulelock .gitconfiglock
|
||||
|
||||
|
|
@ -27,12 +45,9 @@ all: clean build
|
|||
|
||||
clean:
|
||||
@-rm -r build/
|
||||
|
||||
ci-build:
|
||||
@python3 build.py --source-dir src --build-dir build/LatexPackagesBuild ${BUILD_FLAGS}
|
||||
|
||||
doc:
|
||||
@-rm -r build/documentation
|
||||
$(MAKE) -C doc central-doc
|
||||
@-rm -r .compile/
|
||||
|
||||
.PHONY: build doc
|
||||
#!/bin/bash
|
||||
# Compiles all correspondence letters in repository
|
||||
|
||||
|
|
|
|||
|
|
@ -1,12 +0,0 @@
|
|||
TOPTARGETS := all clean doc full central-doc
|
||||
|
||||
SUBDIRS := $(wildcard */.)
|
||||
|
||||
$(TOPTARGETS): $(SUBDIRS)
|
||||
$(SUBDIRS):
|
||||
$(MAKE) -C $@ $(MAKECMDGOALS)
|
||||
|
||||
central-doc: $(SUBDIRS)
|
||||
mv *.pdf ..
|
||||
|
||||
.PHONY: $(TOPTARGETS) $(SUBDIRS)
|
||||
|
|
@ -1,11 +0,0 @@
|
|||
doc:
|
||||
latexmk
|
||||
|
||||
full:
|
||||
latexmk -gg
|
||||
|
||||
clean:
|
||||
latexmk -C
|
||||
|
||||
central-doc: full
|
||||
mv *.pdf ..
|
||||
|
|
@ -1,3 +1,10 @@
|
|||
# This is the .latexmkrc file that needs to be used for compiling the documentation
|
||||
# Note that the makeindex command is non-standard and follows the LaTeX3 architecture
|
||||
# Without this, generating the indexes properly will not work and leads to compiling
|
||||
# errors.
|
||||
# When adding new packages, this should be symlinked to in each new directory,
|
||||
# so that a call to latexmk will automatically use these options
|
||||
|
||||
$makeindex = 'makeindex -s gind.ist %O -o %D %S';
|
||||
$clean_ext .= ' glo';
|
||||
$clean_ext .= ' hd';
|
||||
|
|
|
|||
13
doc/Makefile
13
doc/Makefile
|
|
@ -1,13 +0,0 @@
|
|||
TOPTARGETS := all clean doc full central-doc
|
||||
|
||||
SUBDIRS := $(wildcard */.)
|
||||
|
||||
$(TOPTARGETS): $(SUBDIRS)
|
||||
$(SUBDIRS):
|
||||
$(MAKE) -C $@ $(MAKECMDGOALS)
|
||||
|
||||
central-doc: $(SUBDIRS)
|
||||
mkdir -p ../build/documentation
|
||||
mv *.pdf ../build/documentation
|
||||
|
||||
.PHONY: $(TOPTARGETS) $(SUBDIRS)
|
||||
|
|
@ -1 +0,0 @@
|
|||
../DIR_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../DIR_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../DIR_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../DIR_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
|
|
@ -1 +0,0 @@
|
|||
../../DOC_MAKEFILE
|
||||
5
scripts/compile_doc.sh
Executable file
5
scripts/compile_doc.sh
Executable file
|
|
@ -0,0 +1,5 @@
|
|||
#! /bin/bash
|
||||
# Compiles all documentation files in repository
|
||||
BUILD_COMMAND="latexmk -output-directory=$(pwd)/.compile $1"
|
||||
|
||||
find doc -type f -name "*.tex" -execdir sh -c "$BUILD_COMMAND" -- {} \;
|
||||
|
|
@ -1,10 +0,0 @@
|
|||
pdf:
|
||||
latexmk
|
||||
|
||||
full:
|
||||
latexmk -gg
|
||||
|
||||
clean:
|
||||
latexmk -C
|
||||
|
||||
.PHONY: clean
|
||||
|
|
@ -1,10 +0,0 @@
|
|||
pdf:
|
||||
latexmk
|
||||
|
||||
full:
|
||||
latexmk -gg
|
||||
|
||||
clean:
|
||||
latexmk -C
|
||||
|
||||
.PHONY: clean
|
||||
|
|
@ -1,10 +0,0 @@
|
|||
pdf:
|
||||
latexmk
|
||||
|
||||
full:
|
||||
latexmk -gg
|
||||
|
||||
clean:
|
||||
latexmk -C
|
||||
|
||||
.PHONY: clean
|
||||
Loading…
Reference in a new issue