Makefile pour générer du HTML avec un texte au format reStructuredText (rst)

Voici un fichier Makefile permettant de générer facilement un ou plusieurs fichiers HTML à partir d'un ou plusieurs fichiers RST.

Fichier Makefile

Dans cet exemple, les fichiers RST se nomment respectivement «truc.rst» et «bidule.rst».

# le ou les fichiers à générer 
TARGETS = truc.html bidule.html

# les options
RSTFLAGS = --stylesheet=uneFeuilleDeSyle.css \
           --language=fr \
           --output-encoding=ISO-8859-1 \
           --input-encoding=ISO-8859-1 \
           --source-link --generator

# les executables utilisés
RSTHTML = rst2html.py
RSTTEX = rst2latex.py
RM = rm

# Il n'y a rien à modifier sous cette ligne
# -------------------------------------------------
all: $(TARGETS) 

.SUFFIXES: .rst .html .tex

.rst.html:
    @($(RSTHTML) $(RSTFLAGS) $< $@ && echo "$@ is generated.")

.rst.tex:
    @($(RSTTEX) $(RSTFLAGS) $< $@ && echo "$@ is generated.")

clean:
    @($(RM) $(TARGETS))
    @echo "All HTML files are deleted !"

Utilisation

Pour générer, il suffit de taper make ou make truc.html

Pour supprimer les fichiers générés, il suffit de taper make clean