diff options
| -rw-r--r-- | Makefile | 50 | ||||
| -rw-r--r-- | _static/README (renamed from _static/README.md) | 0 | ||||
| -rw-r--r-- | _templates/README (renamed from _templates/README.md) | 0 |
3 files changed, 31 insertions, 19 deletions
@@ -1,39 +1,51 @@ # Minimal makefile for Sphinx documentation # -# You can set these variables from the command line, and also -# from the environment for the first two. -LOCALE ?= fr -PUBHOST ?= club1.fr -PUBDIR ?= /var/www/docs/$(LOCALE) +# You can set these variables from the command line. +override LOCALE := $(or $(LOCALE),fr) +PUBHOST ?= club1.fr +PUBDIR ?= /var/www/docs/$(LOCALE) ifneq "$(LOCALE)" "fr" -SPHINXOPTS += -D language=$(LOCALE) +override NOTFR = 1 +else +override NOTFR = endif -SPHINXBUILD ?= sphinx-build -SPHINXCMDS = clean html latexpdf man -SOURCEDIR = . -BUILDDIR = _build -LOCALES = en +SPHINXLANG = -D language=$(LOCALE) +SPHINXOPTS ?= +SPHINXBUILD ?= sphinx-build +SPHINXLCMDS = html latexpdf man +SPHINXCMDS = clean gettext +SOURCEDIR = . +BUILDDIR = _build +LOCALES = en +LOCALESDIRS = $(LOCALES:%=locales/%) # Put it first so that "make" without argument is like "make help". help: - @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + $(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $O -.PHONY: help locales publish Makefile $(SPHINXCMDS) +.PHONY: help locales publish Makefile $(SPHINXLCMDS) $(SPHINXCMDS) -locales: gettext - @sphinx-intl update -p $(BUILDDIR)/gettext $(LOCALES:%=-l %) +locales: $(LOCALESDIRS) + +$(LOCALESDIRS): gettext + sphinx-intl update -p $(BUILDDIR)/gettext -l $(@F) + touch $@ publish: html - @rsync -av --del _build/html/ $(USER)@$(PUBHOST):$(PUBDIR) + rsync -av --del _build/html/ $(USER)@$(PUBHOST):$(PUBDIR) + +# Shinx commands that need locales. +$(SPHINXLCMDS): $(if $(NOTFR),locales/$(LOCALE)) + $(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXLANG) $(SPHINXOPTS) $O -# Explicit Sphinx commands for autocompletion. +# Other Sphinx commands for autocompletion $(SPHINXCMDS): - @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + $(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $0 # Catch-all target: route all unknown targets to Sphinx using the new # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). %: Makefile - @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + $(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $O diff --git a/_static/README.md b/_static/README index 07c2c0a..07c2c0a 100644 --- a/_static/README.md +++ b/_static/README diff --git a/_templates/README.md b/_templates/README index ca92466..ca92466 100644 --- a/_templates/README.md +++ b/_templates/README |