blob: 2ff019ab0613012459a0a1a9a644d95f6032eb95 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
# Minimal makefile for Sphinx documentation
#
# You can set these variables from the command line.
LOCALE ?= fr
PUBHOST ?= club1.fr
PUBDIR ?= /var/www/docs
ifneq "$(LOCALE)" "fr"
override NOTFR = 1
else
override NOTFR =
endif
ifneq (,$(filter grouped-target,$(.FEATURES)))
GROUPED_TARGET = 1
else
$(warning WARNING: This version of make does not support grouped-target, disabling parallel jobs.)
.NOTPARALLEL:
endif
SPHINXLANG = -D language=$(LOCALE)
SPHINXOPTS += -a
SPHINXBUILD ?= sphinx-build
SPHINXBUILDERS = html dirhtml singlehtml epub latex text man texinfo
SPHINXCMDS = pickle json htmlhelp changes xml pseudoxml linkcheck doctest coverage
SOURCEDIR = .
BUILDDIR = _build
MDFILES = index.md $(shell find . -type f -name '*.md')
TEMPLATES = $(shell find _templates -type f -name '*.html')
LOCALES = en
LOCALEFILES = $(LOCALES:%=locales/%/LC_MESSAGES/package.po)
PONAMES = package sphinx
POTS = $(PONAMES:%=locales/%.pot)
export LANGUAGES = fr $(LOCALES)
# Put it first so that "make" without argument is like "make help".
help:
$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $O
.PHONY: help clean update-po gettext latexpdf info publish $(SPHINXBUILDERS) $(SPHINXCMDS)
update-po: $(LOCALEFILES)
gettext: $(POTS)
$(LOCALEFILES): locales/%/LC_MESSAGES/package.po: $(POTS)
sphinx-intl update -p $(<D) -l $*
@touch $@
ifdef GROUPED_TARGET
$(POTS)&: $(MDFILES) $(TEMPLATES)
else
$(POTS): $(MDFILES) $(TEMPLATES)
endif
$(SPHINXBUILD) -b gettext "$(SOURCEDIR)" locales $(SPHINXOPTS) $O
@touch $(POTS)
latexpdf: latex
$(MAKE) -C $(BUILDDIR)/latex/$(LOCALE)
info: texinfo
$(MAKE) -C $(BUILDDIR)/texinfo/$(LOCALE)
publish:
rsync -av --del --exclude='.*' _build/html/ $(USER)@$(PUBHOST):$(PUBDIR)
# Shinx commands that need locales (builders).
$(SPHINXBUILDERS): $(if $(NOTFR),$(PONAMES:%=locales/$(LOCALE)/LC_MESSAGES/%.po))
$(SPHINXBUILD) -b $@ "$(SOURCEDIR)" "$(BUILDDIR)/$@/$(LOCALE)" $(SPHINXLANG) $(SPHINXOPTS) $O
# Other Sphinx commands for autocompletion
$(SPHINXCMDS):
$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $O
clean:
rm -f locales/*/LC_MESSAGES/*.mo
rm -rf locales/.doctrees
rm -rf $(BUILDDIR)/*
|
