2018-03-11 16:49:17 +00:00
|
|
|
# makefile for Sphinx documentation
|
|
|
|
|
# =================================
|
|
|
|
|
|
|
|
|
|
# You can set these variables from the command line.
|
|
|
|
|
SPHINXOPTS =
|
|
|
|
|
SPHINXBUILD = sphinx-build
|
|
|
|
|
SPHINXPROJ = OpenDroneMap
|
|
|
|
|
SOURCEDIR = source
|
|
|
|
|
BUILDDIR = _build
|
|
|
|
|
|
|
|
|
|
# Put it first so that "make" without argument is like "make help".
|
|
|
|
|
help:
|
|
|
|
|
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
|
|
|
|
|
|
|
|
|
|
.PHONY: help Makefile
|
|
|
|
|
|
2021-06-11 20:57:07 +00:00
|
|
|
# this will update `arguments.rst` to match arguments in the ODM code
|
2020-12-19 16:18:50 +00:00
|
|
|
autogenerate:
|
2021-07-06 16:25:09 +00:00
|
|
|
python scripts/extract_odm_strings.py https://raw.githubusercontent.com/OpenDroneMap/ODM/master/opendm/config.py
|
2020-12-19 16:18:50 +00:00
|
|
|
|
2021-06-23 00:34:05 +00:00
|
|
|
pushlang:
|
|
|
|
|
@$(SPHINXBUILD) -b gettext "$(SOURCEDIR)" "source/locale/en/pot"
|
2021-06-11 20:57:07 +00:00
|
|
|
tx push --source
|
2021-06-23 00:34:05 +00:00
|
|
|
pulllang:
|
|
|
|
|
tx pull --language "sw,ar,es,fr,te,fil"
|
2021-06-11 20:57:07 +00:00
|
|
|
|
|
|
|
|
livehtml:
|
2021-06-28 13:05:27 +00:00
|
|
|
sphinx-autobuild --open-browser --host 0.0.0.0 -b dirhtml "$(SOURCEDIR)" "$(BUILDDIR)"
|
2021-06-11 20:57:07 +00:00
|
|
|
|
2021-07-06 16:25:09 +00:00
|
|
|
build:
|
2021-06-23 00:34:05 +00:00
|
|
|
@$(SPHINXBUILD) -b dirhtml "$(SOURCEDIR)" "$(BUILDDIR)/html" -nW
|
|
|
|
|
@$(SPHINXBUILD) -b dirhtml -D language='sw' "$(SOURCEDIR)" "$(BUILDDIR)/html/sw" -nW
|
|
|
|
|
@$(SPHINXBUILD) -b dirhtml -D language='ar' "$(SOURCEDIR)" "$(BUILDDIR)/html/ar" -nW
|
|
|
|
|
@$(SPHINXBUILD) -b dirhtml -D language='es' "$(SOURCEDIR)" "$(BUILDDIR)/html/es" -nW
|
|
|
|
|
@$(SPHINXBUILD) -b dirhtml -D language='fr' "$(SOURCEDIR)" "$(BUILDDIR)/html/fr" -nW
|
|
|
|
|
@$(SPHINXBUILD) -b dirhtml -D language='te' "$(SOURCEDIR)" "$(BUILDDIR)/html/te" -nW
|
|
|
|
|
@$(SPHINXBUILD) -b dirhtml -D language='fil' "$(SOURCEDIR)" "$(BUILDDIR)/html/fil" -nW
|
2021-07-06 16:25:09 +00:00
|
|
|
echo "docs.opendronemap.org" > ./_build/html/CNAME
|
2018-03-11 18:33:15 +00:00
|
|
|
# -n Run in nit-picky mode. Currently, this generates warnings for all missing references.
|
|
|
|
|
# -W Turn warnings into errors that stop the build.
|
2020-07-21 18:08:54 +00:00
|
|
|
# for more details about the options see https://www.sphinx-doc.org/en/1.8/man/sphinx-build.html#options
|
2018-03-11 16:49:17 +00:00
|
|
|
|
2021-06-11 20:57:07 +00:00
|
|
|
# `allerr` runs without nit-picky mode, so that an error doesn't halt the build
|
|
|
|
|
# it will log all errors that need to be fixed in the translations (generally syntax errors)
|
2020-10-26 20:38:18 +00:00
|
|
|
allerr:
|
2021-06-23 00:34:05 +00:00
|
|
|
@$(SPHINXBUILD) -b dirhtml "$(SOURCEDIR)" "$(BUILDDIR)/html"
|
|
|
|
|
@$(SPHINXBUILD) -b dirhtml -D language='sw' "$(SOURCEDIR)" "$(BUILDDIR)/html/sw"
|
|
|
|
|
@$(SPHINXBUILD) -b dirhtml -D language='ar' "$(SOURCEDIR)" "$(BUILDDIR)/html/ar"
|
|
|
|
|
@$(SPHINXBUILD) -b dirhtml -D language='es' "$(SOURCEDIR)" "$(BUILDDIR)/html/es"
|
|
|
|
|
@$(SPHINXBUILD) -b dirhtml -D language='fr' "$(SOURCEDIR)" "$(BUILDDIR)/html/fr"
|
|
|
|
|
@$(SPHINXBUILD) -b dirhtml -D language='te' "$(SOURCEDIR)" "$(BUILDDIR)/html/te"
|
|
|
|
|
@$(SPHINXBUILD) -b dirhtml -D language='fil' "$(SOURCEDIR)" "$(BUILDDIR)/html/fil"
|
2020-10-26 20:38:18 +00:00
|
|
|
|
2018-03-11 16:49:17 +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).
|
|
|
|
|
%: Makefile
|
2019-05-22 18:35:33 +00:00
|
|
|
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
|
