308d7cdf78
Adjust the catch-all target at the end of the Makefile that is supposed to route all unknown targets to sphinx, so it doesn't do this for the shrink target. The shrink target has recently been added to Makefile.common.inc in osmo-gsm-manuals, which gets included right above the catch-all target. So it isn't an unknown target, but for some reason the sphinx catch-all runs in addition to the shrink target (runs shrink-pdfs.sh, see output below) and fails. As I did not add the catch-all logic, preserve it but add an exception for the shrink rule. Fix for: + make -C docs publish publish-html make: Entering directory '/build/docs' /opt/osmo-gsm-manuals/build/shrink-pdfs.sh _build/latex/osmopysim-usermanual.pdf * _build/latex/osmopysim-usermanual.pdf: 272K (shrunk from 336K) Running Sphinx v5.3.0 Sphinx error: Builder name shrink not registered or available through entry point Related: SYS#6380 Change-Id: If2802bb93909aba90debe5e03f3047cec73e2f54
53 lines
1.6 KiB
Makefile
53 lines
1.6 KiB
Makefile
# Minimal makefile for Sphinx documentation
|
|
#
|
|
|
|
# You can set these variables from the command line, and also
|
|
# from the environment for the first two.
|
|
SPHINXOPTS ?=
|
|
SPHINXBUILD ?= sphinx-build
|
|
SOURCEDIR = .
|
|
BUILDDIR = _build
|
|
|
|
# for osmo-gsm-manuals
|
|
OSMO_GSM_MANUALS_DIR ?= $(shell pkg-config osmo-gsm-manuals --variable=osmogsmmanualsdir 2>/dev/null)
|
|
OSMO_REPOSITORY = "pysim"
|
|
UPLOAD_FILES = $(BUILDDIR)/latex/osmopysim-usermanual.pdf
|
|
CLEAN_FILES = $(UPLOAD_FILES)
|
|
|
|
# Copy variables from Makefile.common.inc that are used in publish-html,
|
|
# as Makefile.common.inc must be included after publish-html
|
|
PUBLISH_REF ?= master
|
|
PUBLISH_TEMPDIR = _publish_tmpdir
|
|
SSH_COMMAND = ssh -o 'UserKnownHostsFile=$(OSMO_GSM_MANUALS_DIR)/build/known_hosts' -p 48
|
|
|
|
# Put it first so that "make" without argument is like "make help".
|
|
.PHONY: help
|
|
help:
|
|
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
|
|
|
|
$(BUILDDIR)/latex/pysim.pdf: latexpdf
|
|
@/bin/true
|
|
|
|
publish-html: html
|
|
rm -rf "$(PUBLISH_TEMPDIR)"
|
|
mkdir -p "$(PUBLISH_TEMPDIR)/pysim/$(PUBLISH_REF)"
|
|
cp -r "$(BUILDDIR)"/html "$(PUBLISH_TEMPDIR)/pysim/$(PUBLISH_REF)"
|
|
cd "$(PUBLISH_TEMPDIR)" && \
|
|
rsync \
|
|
-avzR \
|
|
-e "$(SSH_COMMAND)" \
|
|
"pysim" \
|
|
docs@ftp.osmocom.org:web-files/
|
|
rm -rf "$(PUBLISH_TEMPDIR)"
|
|
|
|
# put this before the catch-all below
|
|
include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.common.inc
|
|
|
|
|
|
# Catch-all target: route all unknown targets to Sphinx using the new
|
|
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
|
|
%:
|
|
@if [ "$@" != "shrink" ]; then \
|
|
$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O); \
|
|
fi
|