blob: c70c48178ed7608ec5706e6dfe8c8db029224600 (
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
80
81
82
83
84
85
86
|
# Minimal makefile for Sphinx documentation
#
# You can set these variables from the command line.
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
LOCALES := en
LOCALEFILES := $(LOCALES:%=locales/%/LC_MESSAGES/package.po)
PONAMES := package sphinx
POTS := $(PONAMES:%=locales/%.pot)
export LANGUAGES := fr $(LOCALES)
export LATEXMKOPTS := -quiet
SPHINXLANG := -D language=$(LOCALE)
SPHINXOPTS += -a $(if $(CI),,-q)
SPHINXBUILD ?= sphinx-build
SPHINXBUILDERS := html dirhtml singlehtml epub latex text man texinfo
SPHINXLBUILDERS := $(foreach b,$(SPHINXBUILDERS),$(LANGUAGES:%=$b/%))
SPHINXHBUILDERS := $(SPHINXBUILDERS:%=_%)
SPHINXCMDS := pickle json htmlhelp changes xml pseudoxml linkcheck doctest coverage
SOURCEDIR := .
BUILDDIR := _build
MDFILES := index.md $(shell find . -type f -name '*.md')
MDFILES := $(shell find . -type f -name '*.md' -not -name 'README.*')
TEMPLATES := $(shell find _templates -type f -name '*.html')
PUBHOST ?= club1.fr
PUBDIR ?= /var/www/docs
# 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) $(SPHINXLBUILDERS) $(SPHINXHBUILDERS) $(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 info: %: $(LANGUAGES:%=\%/%)
$(LANGUAGES:%=latexpdf/%): latexpdf/%: latex/%
$(MAKE) -C $(BUILDDIR)/$<
$(LANGUAGES:%=info/%): info/%: texinfo/%
$(MAKE) -C $(BUILDDIR)/$<
publish:
rsync -av --del --exclude='.*' _build/html/ $(USER)@$(PUBHOST):$(PUBDIR)
# Shinx builders that builds localized versions.
$(SPHINXBUILDERS): %: $(LANGUAGES:%=\%/%)
# Localized Sphinx builders
$(SPHINXLBUILDERS):
$(MAKE) _$(@D) LOCALE=$(@F)
# Hidden Sphinx builders that need the LOCALE variable
$(SPHINXHBUILDERS): _%: $(if $(filter fr,$(LOCALE)),,$(PONAMES:%=locales/$(LOCALE)/LC_MESSAGES/%.po))
$(SPHINXBUILD) -b $* "$(SOURCEDIR)" "$(BUILDDIR)/$*/$(LOCALE)" -D language=$(LOCALE) $(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)/*
|
