source: trunk/adm/makefile

#+
#
# .. _makefile:
#
# ========
# makefile
# ========
#
# surcouche génération des documentations tropflux
#
# SEE ALSO
# ========
#
# :ref:`build_doc`
#
# TODO
# ====
#
# usage of sphinx/source/Makefile
#
# EVOLUTIONS
# ==========
#
# $Id$
#
# $URL$
#
# - fplod 20120306
#   
#   * remove features which are now in makefile_non_sphinx and docs/docs_dev
#   * remove doxygen stuff
#
# - fplod 20110628T140016Z aedon.locean-ipsl.upmc.fr (Darwin)
#
#   * correction according to build_doc.rst
#
# - fplod 20110421T160731Z aedon.locean-ipsl.upmc.fr (Darwin)
#
#   * correction for pdf_user
#
# - fplod 20110411T160342Z aedon.locean-ipsl.upmc.fr (Darwin)
#
#   * handle paper01/fig*/*.pro (quite ugly !!)
#
# - fplod 20110401T091241Z aedon.locean-ipsl.upmc.fr (Darwin)
#
#   * replace URLPUBLISH by URLPUBLISH_DEV
#   * replace DIRWWW by DIRWWW_DEV
#   * add URLPUBLISH_USER and DIRWWW_USER to handle website
#
# - fplod 20110203T101853Z aedon.locean-ipsl.upmc.fr (Darwin)
#
#   * add cdo inventory file for sphinx intermapping
#
# - fplod 20110110T165518Z aedon.locean-ipsl.upmc.fr (Darwin)
#
#   * add odv files
#
# - fplod 20110106T135021Z aedon.locean-ipsl.upmc.fr (Darwin)
#
#   * add matlab, ferret files
#
# - fplod 20101223T083725Z aedon.locean-ipsl.upmc.fr (Darwin)
#
#   * add nco inventory file for sphinx intermapping
#
# - fplod 20101220T092552Z aedon.locean-ipsl.upmc.fr (Darwin)
#
#   * add saxo inventory file for sphinx intermapping
#
# - fplod 20101118T165524Z aedon.locean-ipsl.upmc.fr (Darwin)
#
#   * creation
#
#
#-
#
PRODUCT = \
tropflux

PRODUCTNAME = \
$$(echo $(PRODUCT) | tr [:lower:] [:upper:])

SUBPRODUCT = \
tropflux_ws

DIRSRC = \
../src/

DIRADM = \
./

DIRTMP = \
./

DIRWWW_DEV = \
../doc/

DIRWWW_USER = \
./website/_build/

URLPUBLISH_DEV = \
http://www.locean-ipsl.upmc.fr/~fplod/$(PRODUCT)/$(SUBPRODUCT)/doc/

URLPUBLISH_USER = \
http://www.locean-ipsl.upmc.fr/~tropflux

.PHONY : \
help \
before \
clean \
cleantmp \
design \
htmllinkcheckb \
htmllinkchecka \
spellcheck \
all \
html \
html_dev \
html_user \
pdf \
pdf_dev \
pdf_dev_sphinx

help :
        @echo "Prepare output directories :"
        @echo "\$$ make before"
        @echo ""
        @echo "Following commands are available to build outputs :"
        @echo "\$$ make all_dev"
        @echo " "
        @echo "Check links before installation : "
        @echo "\$$ make htmllinkcheckb"
        @echo " "
        @echo "Last step = installation of HTML and pdf files"
        @echo "\$$ make install_all"
        @echo " "
        @echo "Check links after installation : "
        @echo "\$$ make htmllinkchecka"
        @echo " "

before :
        @mkdir -p $(DIRWWW_DEV)/man/man1/

install_all : \
install_html_dev \
install_html_user \
install_pdf_dev

install_html_dev :
        @$(DIRADM)/install.sh -w $(DIRWWW_DEV)/html/ -u $(URLPUBLISH_DEV)/html/

install_html_user :
        @$(DIRADM)/install.sh -w $(DIRWWW_USER)/ -u $(URLPUBLISH_USER)/

install_pdf_dev :
        @$(DIRADM)/install.sh -w $(DIRWWW_DEV)/pdf/ -u $(URLPUBLISH_DEV)/pdf/

clean : \
cleantmp
        -@rm -fr $(DIRWWW_DEV)/man/
        -@rm -fr $(DIRWWW_DEV)/html/
        -@rm -fr $(DIRWWW_DEV)/pdf/
        cd ../docs/docs_dev/; make clean
        cd $(DIRADM)/website/; make clean


cleantmp :
        -@rm -f $(DIRTMP)/sphinx_*.log

htmllinkcheckb :
        @$(DIRADM)/linkchecker.sh -d $(DIRWWW_DEV)/html/
        @$(DIRADM)/linkchecker.sh -d $(DIRWWW_USER)

htmllinkchecka :
        @$(DIRADM)/linkchecker.sh -u $(URLPUBLISH_DEV)
        @$(DIRADM)/linkchecker.sh -u $(URLPUBLISH_USER)

spellcheck :
        @++aspell --mode=sgml --master=english -c \
        $(DIRSRC)/$(PRODUCT).xml

all : \
all_dev \
all_user

all_dev : \
html_dev \
pdf_dev \
man_dev

all_user : \
html_user

html : \
html_user \
html_dev

html_user :
        cd $(DIRADM)/website/; make html

html_dev : \
html_dev_sphinx \
html_dev_sphinx_one

html_dev_sphinx :
        cd ../docs/docs_dev; make html

html_dev_sphinx_one :
        cd ../docs/docs_dev; make singlehtml

pdf : \
pdf_dev

pdf_dev :
        cd ../docs/docs_dev; make latexpdf

man_dev :
        cd ../docs/docs_dev; make man