2021-04-02 11:38:00 +00:00
|
|
|
# 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
|
|
|
|
|
2021-04-11 08:58:30 +00:00
|
|
|
# for osmo-gsm-manuals
|
2022-10-21 14:03:53 +00:00
|
|
|
OSMO_GSM_MANUALS_DIR ?= $(shell pkg-config osmo-gsm-manuals --variable=osmogsmmanualsdir 2>/dev/null)
|
2021-04-11 08:58:30 +00:00
|
|
|
OSMO_REPOSITORY = "pysim"
|
|
|
|
UPLOAD_FILES = $(BUILDDIR)/latex/osmopysim-usermanual.pdf
|
|
|
|
CLEAN_FILES = $(UPLOAD_FILES)
|
|
|
|
|
2023-03-07 11:44:14 +00:00
|
|
|
# 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
|
|
|
|
|
2021-04-02 11:38:00 +00:00
|
|
|
# Put it first so that "make" without argument is like "make help".
|
2021-04-11 08:58:30 +00:00
|
|
|
.PHONY: help
|
2021-04-02 11:38:00 +00:00
|
|
|
help:
|
|
|
|
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
|
|
|
|
|
2021-04-11 08:58:30 +00:00
|
|
|
$(BUILDDIR)/latex/pysim.pdf: latexpdf
|
|
|
|
@/bin/true
|
|
|
|
|
2022-02-09 20:01:00 +00:00
|
|
|
publish-html: html
|
2023-03-07 11:44:14 +00:00
|
|
|
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)"
|
2022-02-09 20:01:00 +00:00
|
|
|
|
2021-04-11 08:58:30 +00:00
|
|
|
# put this before the catch-all below
|
|
|
|
include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.common.inc
|
|
|
|
|
2021-04-02 11:38:00 +00:00
|
|
|
|
|
|
|
# Catch-all target: route all unknown targets to Sphinx using the new
|
|
|
|
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
|
2021-04-11 08:58:30 +00:00
|
|
|
%:
|
2023-03-20 11:23:36 +00:00
|
|
|
@if [ "$@" != "shrink" ]; then \
|
|
|
|
$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O); \
|
|
|
|
fi
|