Skip to content

Docs: Run latexmk in parallel when creating PDFs #123113

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AA-Turner merged 8 commits into from
Aug 17, 2024
Merged

Docs: Run latexmk in parallel when creating PDFs #123113

Changes from 1 commit
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
119a373
Use `$(MAKE)` over `make`
AA-Turner Aug 17, 2024
10e4688
Add start/finish logging to the ``dist`` target
AA-Turner Aug 17, 2024
9dd5490
Remove makeindex manipulation
AA-Turner Aug 17, 2024
bb3a201
Run make in parallel
AA-Turner Aug 17, 2024
029e72b
Reduce latexmk verbosity
AA-Turner Aug 17, 2024
701a893
Don't run the full ``latexmk`` process twice
AA-Turner Aug 17, 2024
3539828
Review notes
AA-Turner Aug 17, 2024
bb27b56
Use nproc + 1
AA-Turner Aug 17, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Add start/finish logging to the dist target
  • Loading branch information
@AA-Turner
AA-Turner committed Aug 17, 2024
commit 10e46883f2b42fe09dbff675019469d53b24a869
12 changes: 12 additions & 0 deletions Doc/Makefile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -188,45 +188,56 @@ dist:
mkdir -p dist

# archive the HTML
@echo "Building HTML..."
$(MAKE) html
cp -pPR build/html dist/python-$(DISTVERSION)-docs-html
tar -C dist -cf dist/python-$(DISTVERSION)-docs-html.tar python-$(DISTVERSION)-docs-html
bzip2 -9 -k dist/python-$(DISTVERSION)-docs-html.tar
(cd dist; zip -q -r -9 python-$(DISTVERSION)-docs-html.zip python-$(DISTVERSION)-docs-html)
rm -r dist/python-$(DISTVERSION)-docs-html
rm dist/python-$(DISTVERSION)-docs-html.tar
@echo "Build finished and archived!"

# archive the text build
@echo "Building text..."
$(MAKE) text
cp -pPR build/text dist/python-$(DISTVERSION)-docs-text
tar -C dist -cf dist/python-$(DISTVERSION)-docs-text.tar python-$(DISTVERSION)-docs-text
bzip2 -9 -k dist/python-$(DISTVERSION)-docs-text.tar
(cd dist; zip -q -r -9 python-$(DISTVERSION)-docs-text.zip python-$(DISTVERSION)-docs-text)
rm -r dist/python-$(DISTVERSION)-docs-text
rm dist/python-$(DISTVERSION)-docs-text.tar
@echo "Build finished and archived!"

# archive the A4 latex
@echo "Building LaTeX (A4 paper)..."
rm -rf build/latex
$(MAKE) latex PAPER=a4
-sed -i 's/makeindex/makeindex -q/' build/latex/Makefile
(cd build/latex; $(MAKE) clean && $(MAKE) all-pdf && $(MAKE) FMT=pdf zip bz2)
cp build/latex/docs-pdf.zip dist/python-$(DISTVERSION)-docs-pdf-a4.zip
cp build/latex/docs-pdf.tar.bz2 dist/python-$(DISTVERSION)-docs-pdf-a4.tar.bz2
@echo "Build finished and archived!"

# archive the letter latex
@echo "Building LaTeX (US paper)..."
rm -rf build/latex
$(MAKE) latex PAPER=letter
-sed -i 's/makeindex/makeindex -q/' build/latex/Makefile
(cd build/latex; $(MAKE) clean && $(MAKE) all-pdf && $(MAKE) FMT=pdf zip bz2)
cp build/latex/docs-pdf.zip dist/python-$(DISTVERSION)-docs-pdf-letter.zip
cp build/latex/docs-pdf.tar.bz2 dist/python-$(DISTVERSION)-docs-pdf-letter.tar.bz2
@echo "Build finished and archived!"

# copy the epub build
@echo "Building EPUB..."
rm -rf build/epub
$(MAKE) epub
cp -pPR build/epub/Python.epub dist/python-$(DISTVERSION)-docs.epub
@echo "Build finished and archived!"

# archive the texinfo build
@echo "Building Texinfo..."
rm -rf build/texinfo
$(MAKE) texinfo
$(MAKE) info --directory=build/texinfo
Expand All @@ -236,6 +247,7 @@ dist:
(cd dist; zip -q -r -9 python-$(DISTVERSION)-docs-texinfo.zip python-$(DISTVERSION)-docs-texinfo)
rm -r dist/python-$(DISTVERSION)-docs-texinfo
rm dist/python-$(DISTVERSION)-docs-texinfo.tar
@echo "Build finished and archived!"

.PHONY: _ensure-package
_ensure-package: venv
Expand Down