blob: a5326aaffbf43035fbf422fee82c08fa2366c3d7 (
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
|
# Minimal makefile for Sphinx documentation
#
# You can set these variables from the command line.
LOCALES := en
LOCALEFILES := $(LOCALES:%=locales/%/LC_MESSAGES/package.po) $(LOCALES:%=locales/%/LC_MESSAGES/sphinx.po)
export AUTHORS := $(shell awk '{printf t $$0; t=", "}' AUTHORS)
export PACKAGE := CLUB1
export VERSION := main
export EMAIL := nicolas@club1.fr
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/%))
SPHINXCMDS := gettext pickle json htmlhelp changes xml pseudoxml linkcheck doctest coverage
SOURCEDIR := .
BUILDDIR := _build
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 latexpdf info publish $(SPHINXBUILDERS) $(SPHINXLBUILDERS) $(SPHINXCMDS)
update-po: $(LOCALEFILES);
%.mo: %.po
msgfmt -o $@ $<
.SECONDEXPANSION:
$(LOCALEFILES): locales/%.po: locales/$$(*F).pot
msgmerge -q --update $@ $< --backup=none -w 77
@touch $@
locales/package.pot locales/sphinx.pot: locales/%.pot: $(BUILDDIR)/gettext/%.pot
xgettext $< -o $@ -w 77 \
--copyright-holder='$(AUTHORS)' --package-name='$(PACKAGE)' \
--package-version='$(VERSION)' --msgid-bugs-address='$(EMAIL)'
$(BUILDDIR)/gettext/%.pot: gettext;
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
.SECONDEXPANSION:
$(SPHINXLBUILDERS): $$(if $$(filter fr,$$(@F)),,locales/$$(@F)/LC_MESSAGES/package.mo locales/$$(@F)/LC_MESSAGES/sphinx.mo)
LANGUAGE=$(@F) $(SPHINXBUILD) -b $(@D) "$(SOURCEDIR)" "$(BUILDDIR)/$(@D)/$(@F)" $(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)/*
.PHONY: .FORCE
.FORCE:
|
