X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=developers-reference.git;a=blobdiff_plain;f=Makefile;h=5c19b3bbf7f65b18688230e5f8c91a1ab3b04821;hp=3af4f955938e164ff379251d5aaa45608e073be4;hb=be8424b020a6bde235f0e14909c68ff070a8cfdd;hpb=bc8cda3a046b4cda2098f5769d3a95dfb9042cea diff --git a/Makefile b/Makefile index 3af4f95..5c19b3b 100644 --- a/Makefile +++ b/Makefile @@ -1,100 +1,144 @@ # Makefile, used for the developers-reference in DocBook XML -SOURCES := $(wildcard *.dbk) +# Note: This Makefile should work perfectly without the debian/ directory. -LANGS := fr -TARGETS := $(foreach fmt,html txt pdf,developers-reference.$(fmt)) \ - $(foreach langext,$(LANGS), \ - $(foreach fmt,html txt pdf,developers-reference.$(langext).$(fmt))) +SOURCES := $(wildcard *.dbk) common.ent version.ent -# programs for creating output -DEBIANDOC2HTML := debiandoc2html -c -DEBIANDOC2TEXT := debiandoc2text -DEBIANDOC2LATEX := debiandoc2latex -DEBIANDOC2PS := debiandoc2latexps -DEBIANDOC2PDF := debiandoc2latexpdf - -htmllink := echo "" > dynamic.ent -nohtmllink := echo "" > dynamic.ent +FORMATS := html txt pdf epub +LANGS := de fr ja +TARGETS := $(foreach fmt,$(FORMATS),developers-reference.$(fmt)) \ + $(foreach lng,$(LANGS), \ + $(foreach fmt,$(FORMATS), \ + $(lng)/developers-reference.$(fmt))) +# list of targets, that currently cannot build +#BLACKLIST := ja/developers-reference.pdf -make_directory := install -d -m 755 -install_file := install -m 644 -p +# hopefully overwritten by caller, e.g. debian/rules +VERSION=unknown +PUBDATE=unknown +# programs for creating output XP=xsltproc --nonet --novalid --xinclude - XL=xmllint --nonet --noout --postvalid --xinclude - +# dblatex 0.2.8 has some problems (e.g. #465221 and Japanese does +# not build) +# Alternatives: +# - docbook2pdf (seems to die on UTF-8, #431085); and +# - fop is currently in contrib, but can go to main, see #366783 +# - xmlroff (not mature enough, #182445) +DBLATEX=dblatex --style=db2latex +TRANSLATE=po4a po4a/po4a.cfg + +# XSL files and parameters # note: the URL is used as identifier, no HTTP is used! DOCBOOK_XSL=http://docbook.sourceforge.net/release/xsl/current +# for HTML output +DBK2HTML=$(CURDIR)/html.xsl +# all in one file for text output +DBK2HTML1=$(CURDIR)/txt.xsl -# one file per chapter -DBK2HTML=--stringparam chunk.section.depth 0 \ - --stringparam section.autolabel 1 \ - --stringparam use.id.as.filename 1 \ - $(DOCBOOK_XSL)/xhtml/chunk.xsl - -# all in one file -DBK2HTML1=--stringparam section.autolabel 1 \ - $(DOCBOOK_XSL)/xhtml/docbook.xsl - -DBK2FO=--stringparam double.sided 1 \ - --stringparam draft.mode no \ - --stringparam paper.type A4 \ - $(DOCBOOK_XSL)/fo/docbook.xsl -# fop is currently in contrib, but can go to main now, AFAIK -# alternatives: docbook2pdf (seems to die on UTF-8), dblatex (0.2.4 -# just hangs here) and xmllint (not mature enough, waits in NEW) -FOP=fop - -.PHONY: all dropold -all: $(TARGETS) dropold - -dropold: - -rm -rf developers-reference.ja.html +.PHONY: all +all: $(filter-out $(BLACKLIST), $(TARGETS)) .PHONY: validate -validate: +validate: $(SOURCES) $(XL) index.dbk -.PHONY: developers-reference.html -developers-reference.html: $(SOURCES) - $(XP) $(DBK2HTML) index.dbk - -developers-reference.%.html: developers-reference.%.sgml - $(htmllink) - $(DEBIANDOC2HTML) -l $* $< - -developers-reference.txt: $(SOURCES) - $(XP) $(DBK2HTML1) index.dbk \ - | w3m -cols 65 -dump -T text/html > $@ - -developers-reference.%.txt: developers-reference.%.sgml - $(nohtmllink) - $(DEBIANDOC2TEXT) -l $* -O $< > $@ - -developers-reference.fo: $(SOURCES) - $(XP) $(DBK2FO) index.dbk > $@ - -developers-reference.pdf: developers-reference.fo - $(FOP) -fo $< -pdf $@ - -developers-reference.%.pdf: developers-reference.%.sgml - $(nohtmllink) - $(DEBIANDOC2PDF) -l $* $< - -version.ent: debian/changelog - ./debian/rules $@ - -%.validate : % version.ent - nsgmls -wall -gues $< - touch $@ +%/validate: $(addprefix %/,$(SOURCES)) + cd $(@D) && $(XL) index.dbk + +# This rule controls the build and installation on the website +# Logs are here: http://www-master.debian.org/build-logs/ddp/ +.PHONY: publish +publish: all + [ -d $(PUBLISHDIR) ] || exit 1 + install -d -m 755 $(PUBLISHDIR)/developers-reference + rm -f $(PUBLISHDIR)/developers-reference/*.html + rm -f en && ln -sf . en + $(foreach format,$(FORMATS),$(foreach lang,en $(LANGS),for file in $(lang)/*.$(format); do if [ -e "$$file" ]; then cp --preserve=timestamps $$file $(PUBLISHDIR)/developers-reference/$$(basename $$file .$(format)).$(lang).$(format); fi; done;)) + ln -sf index.en.html $(PUBLISHDIR)/developers-reference/index.html + ln -sf developers-reference.en.pdf $(PUBLISHDIR)/developers-reference/developers-reference.pdf + ln -sf developers-reference.en.txt $(PUBLISHDIR)/developers-reference/developers-reference.txt + ln -sf developers-reference.en.epub $(PUBLISHDIR)/developers-reference/developers-reference.epub + +.PHONY: developers-reference.html %/developers-reference.html +developers-reference.html: $(CURDIR)/index.html +%/developers-reference.html: $(addprefix %/,index.html) + @true + +.PRECIOUS: %/index.html +index.html: $(CURDIR)/developers-reference.html +%/index.html: $(addprefix %/,$(SOURCES)) + cd $(@D) && $(XP) $(DBK2HTML) index.dbk + +# There must be an easier way than recursive make! +.PRECIOUS: %.dbk %.ent +ifndef LINGUA +%.dbk %.ent: FORCE + $(TRANSLATE) + $(MAKE) $@ LINGUA=`basename $(@D)` + +FORCE: +else +$(LINGUA)/%.dbk: %.dbk po4a/$(LINGUA).po + $(TRANSLATE) + +$(LINGUA)/common.ent: common.ent + cd $(@D) && ln -sf ../$(@F) . +endif + +developers-reference.txt: $(CURDIR)/developers-reference.txt +%/developers-reference.txt: $(addprefix %/,$(SOURCES)) + $(XP) $(DBK2HTML1) $(@D)/index.dbk \ + | LC_ALL=C.UTF-8 w3m -o display_charset=UTF-8 -cols 70 -dump -no-graph -T text/html > $@ + +XSLT := xslt + +developers-reference.pdf: $(CURDIR)/developers-reference.pdf +%/developers-reference.pdf: $(addprefix %/,$(SOURCES)) + $(DBLATEX) $(@D)/index.dbk \ + --backend=xetex \ + --xsl-user=$(XSLT)/user_param.xsl \ + --xsl-user=$(XSLT)/xetex_param.xsl \ + --param=lingua=$(@D) \ + && mv $(@D)/index.dbk.pdf $@ + +developers-reference.epub: $(CURDIR)/developers-reference.epub +%/developers-reference.epub: $(addprefix %/,$(SOURCES)) + TOP=`pwd` && cd $(@D) && xmlto epub index.dbk && mv index.epub $(@F) + +.PHONY: pot +pot: po4a/po/developers-reference.pot +po4a/po/developers-reference.pot: %.dbk + $(TRANSLATE) + +ifdef LINGUA +.PHONY: updatepo +updatepo: po4a/po/$(LINGUA).po +po4a/po/$(LINGUA).po: %.dbk + $(TRANSLATE) +endif + +tidypo: + for po in po4a/po/*.po; do \ + msgcat -o $$po $$po; \ + done + +checkpo: + @for po in po4a/po/*.po; do \ + msgfmt -vv $$po; \ + done + +%/version.ent: + echo '' > $@ + echo '' >> $@ .PHONY: clean clean: - rm -f *.fo *.html *.pdf *.txt + rm -f *.fo *.html *.pdf *.txt *.epub + for L in $(LANGS); do rm -rf `basename ./"$$L"/`; done rm -f version.ent rm -f `find . -name "*~" -o -name "*.bak"` - rm -f *.validate rm -f *~ *.bak .#* core .PHONY: distclean