Makefile

   1 SRC_XML=$(wildcard *.xml)
   2 SRC_IMG=$(wildcard figures/*.png)
   3 SRCS=$(SRC_XML) $(SRC_IMG)
   4 TMP?=/tmp
   5
   6 TGT_BASE=lustre_manual
   7 MASTER_URL=http://build.whamcloud.com/job/lustre-manual/lastSuccessfulBuild/
   8 MASTER_URL_LAB=http://build.lab.whamcloud.com:8080/job/lustre-manual/lastSuccessfulBuild/
   9 MASTER_XHTML=$(MASTER_URL)/artifact/$(TGT_BASE).xhtml
  10 MASTER_XHTML_LAB=$(MASTER_URL_LAB)/artifact/$(TGT_BASE).xhtml
  11 TGT_MASTER=$(TMP)/mastermanual
  12 CHUNKED_HTML=chunked-html
  13
  14
  15 RNG_UBN=/usr/share/xml/docbook/schema/rng/5.0/docbookxi.rng
  16 RNG_REL=/usr/share/xml/docbook5/schema/rng/5.0/docbookxi.rng
  17 RNG_MAC=/opt/local/share/xml/docbook/5.0/rng/docbookxi.rng
  18 RNG=$(or $(shell ls $(RNG_UBN) 2> /dev/null), \
  19          $(shell ls $(RNG_REL) 2> /dev/null), \
  20          $(shell ls $(RNG_MAC) 2> /dev/null))
  21 XSL_UBN=/usr/share/xml/docbook/stylesheet/docbook-xsl-ns
  22 XSL_REL=/usr/share/sgml/docbook/xsl-ns-stylesheets-1.75.2
  23 XSL_F16=/usr/share/sgml/docbook/xsl-ns-stylesheets
  24 XSL_MAC=/opt/local/share/xsl/docbook-xsl
  25 XSL=$(or $(shell ls -d $(XSL_UBN) 2> /dev/null), \
  26          $(shell ls -d $(XSL_REL) 2> /dev/null), \
  27          $(shell ls -d $(XSL_F16) 2> /dev/null), \
  28          $(shell ls -d $(XSL_MAC) 2> /dev/null))
  29 PRIMARYXSL=$(XSL)/$(subst $(TGT_BASE).,,$@)/docbook.xsl
  30 PRIMARYCHUNKXSL=$(XSL)/html/chunkfast.xsl
  31
  32 .PHONY: all
  33 all: clean check xhtml html chunked-html pdf epub
  34
  35 .PHONY: check
  36 check: $(SRC_XML)
  37         xmllint --noout --xinclude --noent --relaxng $(RNG) ./index.xml
  38
  39 # Note: can't use "suffix" instead of "subst", because it keeps the '.'
  40 # Note: xsl:import is resolved at compile time, so the primary xsl
  41 #   is substituted into the custom xsl with sed before compliation.
  42 $(CHUNKED_HTML)/%.html: $(SRCS)
  43         sed -e 's;PRIMARYXSL;${PRIMARYCHUNKXSL};' ./style/customstyle.xsl | \
  44         xsltproc --xinclude -o ${CHUNKED_HTML}/ - ./index.xml
  45
  46 $(TGT_BASE).html $(TGT_BASE).xhtml $(TGT_BASE).epub: $(SRCS)
  47         sed -e 's;PRIMARYXSL;${PRIMARYXSL};' ./style/customstyle.xsl | \
  48         xsltproc --xinclude -o $@ - ./index.xml
  49
  50 $(TGT_BASE).fo: $(SRCS)
  51         sed -e 's;PRIMARYXSL;${PRIMARYXSL};' ./style/customstyle_fo.xsl | \
  52         xsltproc --xinclude -o $@ - ./index.xml
  53
  54
  55 $(TGT_BASE).pdf: $(TGT_BASE).fo
  56                 fop $< $@
  57
  58 .PHONY: html
  59 html: $(TGT_BASE).html
  60
  61 .PHONY: xhtml
  62 xhtml: $(TGT_BASE).xhtml
  63
  64 .PHONY: pdf
  65 pdf: $(TGT_BASE).pdf
  66
  67 .PHONY: epub
  68 epub: $(TGT_BASE).epub
  69         echo "application/epub+zip" > mimetype
  70         cp -r ./figures ./OEBPS/
  71         mkdir ./OEBPS/style
  72         cp ./style/manual.css ./OEBPS/style/
  73         zip -0Xq $(TGT_BASE).epub mimetype
  74         zip -Xr9D $(TGT_BASE).epub OEBPS/*
  75         zip -Xr9D $(TGT_BASE).epub META-INF/*
  76
  77 .PHONY: chunked-html
  78 chunked-html: $(CHUNKED_HTML)/%.html
  79         cp -r ./figures ./${CHUNKED_HTML}
  80
  81
  82 # get the git hash for the last successful build of the manual
  83 .PHONY: mastermanual.revision
  84 mastermanual.revision:
  85         wget -O mastermanual.index $(MASTER_URL) || wget -O mastermanual.index $(MASTER_URL_LAB)
  86         awk '/Revision/ { print $$NF }' mastermanual.index > mastermanual.revision
  87
  88 # only fetch the full manual if we don't have it or the manual changed
  89 $(TGT_MASTER).xhtml: mastermanual.revision
  90         if ! cmp -s mastermanual.revision $(TGT_MASTER).revision ; then\
  91                 (wget -O $(TGT_MASTER).xhtml $(MASTER_XHTML) || \
  92                 wget -O $(TGT_MASTER).xhtml $(MASTER_XHTML_LAB)) && \
  93                 mv mastermanual.revision $(TGT_MASTER).revision;\
  94         fi
  95
  96 .PHONY: diff
  97 diff: $(TGT_BASE).xhtml $(TGT_MASTER).xhtml
  98         ./tools/diff.py $(TGT_MASTER).xhtml $(TGT_BASE).xhtml > $(TGT_BASE).diff.html
  99
 100
 101 .PHONY: push
 102 push:
 103         git push ssh://review.hpdd.intel.com:29418/doc/manual HEAD:refs/for/master
 104
 105 .PHONY: clean
 106 clean:
 107         rm -f $(TGT_BASE).html $(TGT_BASE).xhtml $(TGT_BASE).pdf\
 108                 mastermanual.revision mastermanual.index mimetype\
 109                 $(TGT_BASE).diff.html $(TGT_BASE).epub $(TGT_BASE).fo
 110         rm -rf ./META-INF ./OEBPS ./$(TGT_BASE)