| # 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 |